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 do JetBrains:
IntelliJ Ultimate ou outro ambiente de desenvolvimento integrado premium do JetBrains que contém o plug-in Database Tools and SQL (ativado por padrão).
DataGrip, o ambiente autônomo de gerenciamento de bancos de dados.
Também é possível 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 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 o 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 Google Cloud Databases na barra lateral ou clique em View > Tool Windows > Google Cloud Databases.
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 seu 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. Também é possível usar um IP privado selecionando Conectar usando o Cloud SQL Proxy (IP privado).
Para saber mais sobre como se conectar a instâncias do SQL, consulte Sobre 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 Cloud SQL Instance Conectado é exibida, oferecendo 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.
Se preferir, 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 que, por padrão, sã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 do SQL do JetBrains, ou o DataGrip.
(Opcional) Para conferir a lista de fontes de dados no seu ambiente de desenvolvimento integrado, clique em Database na barra lateral ou em View > Tool Windows > Database. 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 do DataGrip.
Desconectar 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
Esta seção lista todos 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 quando está ocupada e sempre depende de uma, o que limita a uso de 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 ocorrer um conflito de portas, você poderá 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