conectar-se a um banco de dados do Cloud SQL

O Cloud Code é compatível com a execução do proxy do Cloud SQL Auth para se conectar a um banco de dados do Cloud SQL, visualizando o Cloud SQL instâncias e criação de novas fontes de dados.

Antes de começar

  • Instale o Cloud Code, caso ainda não tenha feito isso já.

  • Para criar uma nova fonte de dados, use uma das seguintes opções premium Ambientes de desenvolvimento integrado da JetBrains:

  • Você também pode usar outras ferramentas de banco de dados preferidas (como DBeaver (em inglês) MySQL Workbench. 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 do Cloud SQL Auth

É possível se conectar a um banco de dados do Cloud SQL e visualizar uma lista de instâncias do Cloud SQL no IntelliJ ou em outros ambientes de desenvolvimento integrado do JetBrains compatíveis com Cloud Code.

Para se conectar a um banco de dados do Cloud SQL com o Cloud Code, execute o seguintes:

  1. No seu ambiente de desenvolvimento integrado, clique em Bancos de dados do Google Cloud na barra lateral ou clique em Visualizar > Janelas de ferramentas > Bancos de dados do Google Cloud.

  2. Se um projeto do Google Cloud ainda não estiver selecionado, clique em Selecionar um projeto do Google Cloud e siga as instruções para carregar o arquivo projeto.

    As instâncias do Cloud SQL no projeto do Google Cloud aparecem em Cloud SQL.

    Janela de ferramentas do Cloud SQL

  3. 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 Cloud SQL Proxy. Você também pode optar por usar um IP privado selecione Conectar usando o Cloud SQL Proxy (IP particular).

Para saber como se conectar a instâncias do SQL, consulte Sobre as opções de conexão.

Criar uma nova fonte de dados

Depois que uma conexão de proxy do Cloud SQL Auth é estabelecida, a instância do Cloud SQL A caixa de diálogo "Conectado" vai aparecer com a opção de criar uma fonte de dados. para o banco de dados disponível localmente ou visualizar fontes de dados existentes.

  1. Para criar uma nova fonte de dados, selecione Criar nova fonte de dados.

    Como alternativa, você pode clicar com o botão direito do mouse em uma instância e selecionar Criar novos dados Origem.

    Caixa de diálogo "Origens de dados e drivers"

  2. No campo Autenticação, selecione um método (por padrão, nome de usuário e senha).

  3. Salve a configuração.

    O Cloud Code cria uma nova conexão de fonte de dados com um nome em o seguinte formato:

    gcp-project:location:db-instance-name

    Comece a trabalhar com a instância do banco de dados pela Banco de dados Ferramentas e recursos de plug-in SQL ou DataGrip.

  4. (Opcional) Para ver a lista de fontes 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. Clicar com o botão direito do mouse fonte de dados oferece uma lista de opções, como visualização de esquemas, tabelas e outras operações de banco de dados.

    Opções de ferramentas de banco de dados

    Para saber mais sobre como trabalhar com bancos de dados no DataGrip, consulte Início rápido com DataGrip.

Desconectar o proxy do Cloud SQL Auth

Para interromper o processo do proxy e liberar a porta do banco de dados local, acesse o terminal: pressione Ctrl+C.

Problemas conhecidos

Nesta seção, listamos os problemas conhecidos e as resoluções atuais.

Defina uma porta diferente para se conectar a vários bancos de dados

O proxy do Cloud SQL Auth não seleciona automaticamente as portas se estiver ocupado e sempre depende da o que limita a acesso a uma única instância conectada de um determinado tipo de no seu banco de dados.

O Cloud Code executa o proxy do Cloud SQL Auth no terminal e, se um conflito de portas, é possível definir uma porta diferente para se conectar a um banco de dados executando o mesmo comando no terminal com uma sinalização --port personalizada. Exemplo:

--port=PORT_NUMBER

Depois, é possível usar essa porta na sua conexão com o banco de dados. O comando será geradas automaticamente. Exemplo:

path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING

Receber suporte

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 ou faça uma pergunta no Stack Overflow.