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:
IntelliJ Ultimate ou outro ambiente de desenvolvimento integrado premium da JetBrains que contenha o plug-in Ferramentas de banco de dados e SQL (ativado por padrão).
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
É possível se conectar a um banco de dados do Cloud SQL e conferir uma lista de instâncias do Cloud SQL no IntelliJ ou em outros ambientes de desenvolvimento integrado da JetBrains com suporte com o Cloud Code.
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).
Para saber mais sobre como se conectar a instâncias do SQL, consulte Sobre as opções de conexão.
Criar uma fonte de dados
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-nameVocê 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 saber mais sobre como trabalhar com bancos de dados no DataGrip, consulte Início rápido com o DataGrip.
Desconectar o proxy de autenticação do Cloud SQL
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:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING