O Cloud Code oferece suporte à execução do proxy de autenticação do Cloud SQL para conectar-se 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 o tenha feito.
Para criar uma nova fonte de dados, você pode usar um dos seguintes IDEs premium da JetBrains:
IntelliJ Ultimate ou outro IDE premium da JetBrains que contenha o Database Tools e o plugin SQL (habilitado por padrão).
DataGrip , o ambiente de gerenciamento de banco de dados autônomo.
Você também pode 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.
Conecte-se ao banco de dados Cloud SQL usando o proxy de autenticação do Cloud SQL
Você pode se conectar a um banco de dados Cloud SQL e visualizar uma lista de instâncias do Cloud SQL no IntelliJ ou outros IDEs JetBrains compatíveis com o Cloud Code.
Para se conectar a um banco de dados Cloud SQL com o Cloud Code, faça o seguinte:
No seu IDE, clique em Bancos de dados do Google Cloud na barra lateral ou clique em Exibir > Janelas de ferramentas > Bancos de dados do Google Cloud .
Se um Google Cloud projeto ainda não estiver selecionado, clique em Selecionar um projeto do Google Cloud e siga as instruções para carregar seu Google Cloudprojeto.
Instâncias do Cloud SQL em seu Google Cloud projeto aparece no 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 optar por usar um IP privado selecionando Conectar usando o Proxy do Cloud SQL (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 de autenticação do Cloud SQL é estabelecida, a caixa de diálogo Instância do Cloud SQL conectada é 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 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 nova fonte de dados .
No campo Autenticação , selecione um método (por padrão, é um 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 no seguinte formato:
gcp-project:location:db-instance-name.Você pode começar a trabalhar com a instância do banco de dados por meio das ferramentas de banco de dados e dos recursos do plugin SQL do JetBrains ou do DataGrip.
(Opcional) Para visualizar a lista de fontes de dados no seu IDE, clique em Banco de Dados na Barra Lateral ou em Exibir > Janelas de Ferramentas > Banco de Dados . Clicar com o botão direito do mouse em uma fonte de dados fornece uma lista de opções, como visualizar esquemas, tabelas e outras operações do 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, no terminal, pressione Ctrl+C .
Problemas conhecidos
Esta seção lista todos os problemas conhecidos e suas resoluções atuais.
Defina uma porta diferente para conectar a vários bancos de dados
O proxy de autenticação do Cloud SQL não seleciona portas automaticamente se estiver ocupado 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 de autenticação do Cloud SQL no terminal e, caso haja um conflito de porta, você pode definir uma porta diferente para se conectar a um banco de dados executando o mesmo comando no terminal com um sinalizador personalizado --port . Por exemplo:
--port= PORT_NUMBER
Você poderá então usar esta porta na sua conexão com o banco de dados. O comando será gerado automaticamente. Por exemplo:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING