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, visualizar instâncias do Cloud SQL e criar 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 ambientes de desenvolvimento integrado premium da JetBrains:
IntelliJ Ultimate ou outro ambiente de desenvolvimento integrado premium do JetBrains que contém o plug-in de ferramentas de banco de dados e SQL (ativado por padrão).
DataGrip, o ambiente autônomo de gerenciamento de banco de dados.
Também é possível usar outras ferramentas de banco de dados preferenciais (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 do Cloud SQL Auth
É possível se conectar a um banco de dados do Cloud SQL e ver uma lista de instâncias do Cloud SQL no IntelliJ ou em outros ambientes de desenvolvimento integrado compatíveis com a JetBrains (link em inglês) com 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 em Visualizar > Janelas de ferramentas > Bancos de dados do Google Cloud.
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 projeto.
As instâncias do Cloud SQL no 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. Também é possível usar um IP particular. Para isso, selecione Conectar usando o proxy do Cloud SQL (IP particular).
Para saber mais sobre 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 for estabelecida, a caixa de diálogo Instância do Cloud SQL conectada será exibida, oferecendo a opção de criar uma nova fonte de dados para o banco de dados disponível localmente ou visualizar fontes de dados atuais.
Para criar uma nova fonte de dados, selecione Criar nova fonte de dados.
Como alternativa, clique com o botão direito do mouse em uma instância e selecione 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 nova conexão de fonte de dados com um nome no seguinte formato:
gcp-project:location:db-instance-name.Comece a trabalhar com a instância do banco de dados usando as ferramentas de banco de dados e os recursos de plug-in SQL da JetBrains ou o DataGrip.
(Opcional) Para visualizar a lista de fontes de dados no seu ambiente de desenvolvimento integrado, clique em Banco de dados na barra lateral ou em Visualização > Janelas de ferramentas > Banco de dados. Clique com o botão direito do mouse em uma fonte de dados para ver uma lista de opções, como visualizar esquemas, tabelas e outras operações de banco de dados.
Para saber mais sobre como trabalhar com bancos de dados no DataGrip, consulte Início rápido com o DataGrip.
Desconectar o proxy do Cloud SQL Auth
Para interromper o processo do 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 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 de uma. Isso 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 e, se houver 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á gerado automaticamente. Exemplo:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING