Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Cloud Code permite executar o proxy de autenticação do Cloud SQL
para se conectar a um banco de dados do Cloud SQL, visualizar instâncias do Cloud SQL
e criar novas fontes de dados.
Antes de começar
Instale o Cloud Code se ainda não tiver
feito isso.
Para criar uma fonte de dados, use um dos seguintes IDEs premium da JetBrains:
DataGrip, o ambiente independente de gerenciamento de banco de dados.
Você também pode usar outras ferramentas de banco de dados preferidas, como DBeaver, MySQL Workbench e SQL Server Management Studio, para se conectar às instâncias do Cloud SQL usando a porta local fornecida pelo Cloud Code.
Conectar-se ao banco de dados do Cloud SQL usando o proxy de autenticação do Cloud SQL
Para se conectar a um banco de dados do Cloud SQL com o Cloud Code, faça o seguinte:
No ambiente de desenvolvimento integrado, clique em Bancos de dados do Google Cloud na barra lateral ou em
Exibir > Janelas de ferramentas > Bancos de dados do Google Cloud.
Se um projeto Google Cloud ainda não estiver selecionado, clique em Selecionar um projeto do Google Cloud e siga as instruções para carregar seu projeto Google Cloud.
As instâncias do Cloud SQL no seu projeto Google Cloud aparecem em Cloud
SQL.
Para se conectar a uma instância do Cloud SQL, clique com o botão direito do mouse em uma instância e selecione
Conectar usando o proxy do Cloud SQL. Você também pode usar um IP particular selecionando Conectar usando o proxy do Cloud SQL (IP particular).
Depois que uma conexão do proxy de autenticação do Cloud SQL é estabelecida, a caixa de diálogo Instância do Cloud SQL conectada aparece, oferecendo a opção de criar uma nova fonte de dados para o banco de dados disponível localmente ou ver as fontes de dados atuais.
Para criar uma fonte de dados, selecione Criar nova fonte de dados.
Outra opção é clicar com o botão direito do mouse em uma instância e selecionar Criar nova fonte de dados.
No campo Autenticação, selecione um método (por padrão, é um nome de usuário e uma senha).
Salve a configuração.
O Cloud Code cria uma conexão de fonte de dados com um nome no
seguinte formato:
gcp-project:location:db-instance-name
Você pode começar a trabalhar com a instância de banco de dados usando os recursos do plug-in Database Tools and SQL do JetBrains ou o DataGrip.
(Opcional) Para conferir a lista de origens de dados no seu ambiente de desenvolvimento integrado, clique em Banco de dados na barra lateral ou em Visualizar > Janelas de ferramentas > Banco de dados. Ao clicar com o botão direito do mouse em uma fonte de dados, você tem acesso a uma lista de opções, como ver esquemas, tabelas e outras operações de banco de dados.
Para interromper o processo de proxy e liberar a porta do banco de dados local, pressione Ctrl+C no terminal.
Problemas conhecidos
Nesta seção, listamos os problemas conhecidos e as soluções atuais.
Definir uma porta diferente para se conectar a vários bancos de dados
O proxy de autenticação do Cloud SQL não seleciona portas automaticamente se elas estiverem ocupadas e sempre depende de
uma, o que limita você a uma única instância conectada de um determinado tipo de
banco de dados.
O Cloud Code executa o proxy do Cloud SQL Auth no terminal. Se houver um conflito de porta, defina uma porta diferente para se conectar a um banco de dados executando o mesmo comando no terminal com uma flag --port personalizada. Exemplo:
--port=PORT_NUMBER
Em seguida, use essa porta na conexão do banco de dados. O comando será
gerado automaticamente. Exemplo:
Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse
Tools > Cloud Code > Help / About > Envie
feedback ou informe um problema para informar um problema no GitHub.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eCloud Code allows you to connect to a Cloud SQL database using the Cloud SQL Auth proxy, view Cloud SQL instances, and create new data sources within supported JetBrains IDEs.\u003c/p\u003e\n"],["\u003cp\u003eConnecting to a Cloud SQL database through Cloud Code involves selecting a Google Cloud project, choosing the desired instance, and initiating the connection via the Cloud SQL Proxy, with an option for private IP connections.\u003c/p\u003e\n"],["\u003cp\u003eCreating a new data source is possible after establishing a Cloud SQL Auth proxy connection, which can be done either through the Cloud SQL Instance Connected dialog or by right-clicking an instance, and it is dependent on using IntelliJ Ultimate or other premium JetBrains IDE editions with the database plugin enabled.\u003c/p\u003e\n"],["\u003cp\u003eTo disconnect from the Cloud SQL Auth proxy, you can simply stop the proxy process by pressing \u003ccode\u003eCtrl+C\u003c/code\u003e in the terminal.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code runs the Cloud SQL Auth Proxy using a fixed port, however, if there is a conflict, a different port can be configured using the \u003ccode\u003e--port\u003c/code\u003e flag in the terminal.\u003c/p\u003e\n"]]],[],null,["# Connect to a Cloud SQL database\n\nCloud Code supports running [Cloud SQL Auth proxy](/sql/docs/mysql/sql-proxy)\nto connect to a [Cloud SQL](/sql/docs/introduction) database, viewing Cloud SQL\ninstances, and creating new data sources.\n\nBefore you begin\n----------------\n\n- Install [Cloud Code](/code/docs/intellij/install) if you haven't\n already.\n\n- To create a new data source, you can use one of the following premium\n JetBrains IDEs:\n\n - [IntelliJ Ultimate](https://www.jetbrains.com/idea/download) or another\n premium JetBrains IDE which contains the\n [Database Tools and SQL](https://www.jetbrains.com/help/idea/relational-databases.html)\n plugin (enabled by default).\n\n - [DataGrip](https://www.jetbrains.com/datagrip/), the standalone database\n management environment.\n\n- You can also use other preferred database tools (such as\n [DBeaver](https://dbeaver.com/download/),\n [MySQL Workbench](https://www.mysql.com/products/workbench/), and\n [SQL Server Management Studio](https://learn.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms))\n to connect to the Cloud SQL instances using the local port provided by\n Cloud Code.\n\nConnect to Cloud SQL database using Cloud SQL Auth proxy\n--------------------------------------------------------\n\nYou can connect to a Cloud SQL database and view a list of Cloud SQL instances\nin IntelliJ or other [supported JetBrains IDEs](/code/docs/intellij/ides) with\nCloud Code.\n| **Note:** When performing these actions for the first time, Cloud Code installs Cloud SQL dependencies which include Cloud SQL Auth proxy.\n\nTo connect to a Cloud SQL database with Cloud Code, perform the\nfollowing:\n\n1. In your IDE, click **Google Cloud Databases** in the sidebar or click\n **View** \\\u003e **Tool Windows** \\\u003e **Google Cloud Databases**.\n\n2. If a Google Cloud project isn't already selected, click **Select a\n Google Cloud project** and follow the prompts to load your Google Cloud\n project.\n\n Cloud SQL instances in your Google Cloud project appear under **Cloud\n SQL**.\n\n3. To connect to a Cloud SQL instance, right-click an instance and select\n **Connect using Cloud SQL Proxy** . You can also choose to use a private IP by\n selecting **Connect using Cloud SQL Proxy (Private IP)**.\n\nTo learn more about connecting to SQL instances, see\n[About connection options](/sql/docs/mysql/connect-overview).\n\nCreate a new data source\n------------------------\n\n| **Note:** Creating a new data source requires IntelliJ Ultimate or other premium JetBrains IDEs editions with the Database Tools and SQL plugin enabled, the DataGrip IDE, or other preferred database tools like [DBeaver](https://dbeaver.com/download/), [MySQL Workbench](https://www.mysql.com/products/workbench/), and [SQL Server Management Studio](https://learn.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms)).\n\nAfter a Cloud SQL Auth proxy connection is established, the **Cloud SQL Instance\nConnected** dialog appears, giving you the option to create a new data source\nfor the locally available database or view existing data sources.\n\n1. To create a new data source, select **Create new data source**.\n\n Alternatively, you can right-click an instance and select **Create New Data\n Source**.\n\n2. In the **Authentication** field, select a method (by default, this is a\n username and password).\n\n3. Save the configuration.\n\n Cloud Code creates a new data source connection with a name in\n the following format:\n\n `gcp-project:location:db-instance-name`.\n\n You can begin working with the database instance via JetBrains' Database\n Tools and SQL plugin capabilities, or DataGrip.\n4. (Optional) To view the list of data sources in your IDE, click **Database**\n in the Sidebar or **View** \\\u003e **Tool Windows** \\\u003e **Database**. Right-clicking a\n data source provides you with a list of options, such as viewing schemas,\n tables, and other database operations.\n\n To learn more about working with databases in DataGrip, see [Quick start with\n DataGrip](https://www.jetbrains.com/help/datagrip/quick-start-with-datagrip.html).\n\nDisconnect Cloud SQL Auth proxy\n-------------------------------\n\nTo stop the proxy process and free up the local database port, in the terminal,\npress `Ctrl+C`.\n\nKnown issues\n------------\n\nThis section lists any known issues and their current resolutions.\n\n### Set a different port to connect to several databases\n\nThe Cloud SQL Auth proxy doesn't auto-select ports if busy and always depends on\none, which limits you to a single connected instance of a certain type of\ndatabase.\n\nCloud Code runs Cloud SQL Auth proxy in the terminal, and if it\nruns into a port conflict, you can set a different port to connect to a database\nby running the same command in the terminal with a custom `--port` flag. For\nexample:\n\n`--port=`\u003cvar translate=\"no\"\u003ePORT_NUMBER\u003c/var\u003e\n\nYou can then use this port in your database connection. The command will be\nauto-generated. For example:\n\n`path_to_proxy/cloud-sql-proxy `\u003cvar translate=\"no\"\u003eINSTANCE_CONNECTION_STRING\u003c/var\u003e\n\nGet support\n-----------\n\nTo submit feedback or report an issue in your IntelliJ IDE, go to **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit\nfeedback or report an issue** to report an issue on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues)."]]
