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.
Para criar uma nova fonte de dados, use um dos seguintes IDEs premium da JetBrains:
IntelliJ Ultimate ou outro o ambiente de desenvolvimento integrado premium da JetBrains, que contém Ferramentas de banco de dados e SQL (ativado por padrão).
DataGrip, o banco de dados autônomo de segurança na nuvem.
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 com suporte usando o Cloud Code.
Para se conectar a um banco de dados do Cloud SQL com o Cloud Code, faça o seguinte:
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.
Se um projeto do Google Cloud ainda não tiver sido selecionado, clique em Selecionar um projeto do Google Cloud e siga as instruções para carregar o projeto.
As instâncias do Cloud SQL no seu projeto do 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 Cloud SQL Proxy. Você também pode usar um IP particular selecionando 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 caixa de diálogo Instância do Cloud SQL Conectada aparece, dando a opção de criar uma nova fonte de dados para o banco de dados disponível localmente ou visualizar as fontes de dados existentes.
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.
No campo Autenticação, selecione um método (por padrão, nome de usuário e senha).
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-nameComece a trabalhar com a instância do banco de dados pela Banco de dados Ferramentas e recursos de plug-in SQL ou DataGrip.
(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 em uma fonte de dados mostra uma lista de opções, como a visualização de esquemas, tabelas e outras operações de banco de dados.
Para saber mais sobre como trabalhar com bancos de dados no DataGrip, consulte Guia de início rápido do DataGrip.
Desconectar o proxy do Cloud SQL Auth
Para interromper o processo de proxy e liberar a porta do banco de dados local, no terminal,
pressione Ctrl+C.
Problemas conhecidos
Esta seção lista 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
Em seguida, use essa porta na conexão do banco de dados. O comando será gerado automaticamente. Exemplo:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING