Gerenciar dados com o Cloud SQL Studio

MySQL   |  PostgreSQL   |  SQL Server

Nesta página, descrevemos como analisar e gerenciar seus dados do Cloud SQL usando o Cloud SQL Studio no console do Google Cloud.

O Cloud SQL Studio permite que usuários autorizados interajam diretamente com o banco de dados SQL e executem consultas SQL pelo console do Google Cloud para acessar e manipular dados. É possível executar várias ações que você executaria em um cliente de linha de comando SQL, como criar tabelas e índices, modificar tabelas ou configurar visualizações.

O Cloud SQL Studio inclui um painel Explorer que se integra a um editor de consultas e a uma tabela de resultados de consulta SQL. É possível executar instruções DDL, DML e DQL nessa única interface. Por exemplo, em vez de configurar uma ferramenta de consulta de banco de dados de terceiros, é possível criar uma tabela e consultar seus dados usando o editor de consultas no Cloud SQL Studio.

Use o painel Explorer para visualizar e interagir com seus objetos do banco de dados. Crie, altere e exclua os objetos do banco de dados, como estes:

• Tabelas
• Colunas
• Índices e chaves
• Funções

É possível usar o painel Explorer para sugerir consultas SELECT para tabelas.

Observação: as visualizações no nível do sistema no esquema INFORMATION_SCHEMA e PG_CATALOG são somente leitura.

Se você começou a usar o Cloud SQL agora, consulte Visão geral do Cloud SQL.

Papéis e permissões necessárias

Atenção: os usuários com amplo acesso ao banco de dados podem perder dados ao usar o Gemini em bancos de dados. Recomendamos usar uma conta com menos privilégios de banco de dados ao usar o Gemini em bancos de dados.

Para receber as permissões necessárias para concluir as tarefas neste documento, solicite ao administrador o papel Cloud SQL Studio User (roles/cloudsql.studioUser) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Para usar o Cloud SQL Studio, é preciso ter as seguintes permissões:

• cloudsql.databases.list
• cloudsql.instances.executeSql
• cloudsql.instances.get
• cloudsql.users.list

Além disso, verifique se você tem permissões no nível do banco de dados para o banco de dados que você está usando na autenticação, além da senha do usuário privilegiado desse banco.

Explorar os dados

Para acessar o painel Explorer, siga estas etapas:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse Instâncias do Cloud SQL

2. Selecione uma instância na lista.
3. No menu de navegação, clique em Cloud SQL Studio.
4. Faça login no Cloud SQL Studio usando o nome do seu banco de dados, nome de usuário e senha. O painel Explorer mostra uma lista dos objetos no seu banco de dados.

Criar, modificar e consultar seus dados

Com o editor de SQL, é possível executar qualquer combinação de instruções DDL, DML e DQL. É possível escrever uma consulta ou preencher o editor de consultas com um modelo usando o Explorer.

Para estruturar, modificar ou consultar seus dados, siga estas etapas:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse Instâncias do Cloud SQL

2. Selecione uma instância na lista.
3. No menu de navegação, clique em Cloud SQL Studio.
4. Faça login no Cloud SQL Studio usando o nome do seu banco de dados, nome de usuário e senha.
5. Crie uma consulta usando um dos seguintes métodos:
   • Para criar sua consulta, siga estas etapas:
     1. Abra uma nova guia clicando em .
     2. Quando o editor de consultas aparecer, crie sua consulta.
   • Para criar uma consulta começando com um modelo, siga estas etapas:
     1. No painel Explorer, ao lado de um objeto ou coleção do banco de dados, clique em Ver ações de more_vert. Uma ou mais ações disponíveis são exibidas.
     2. Clique em uma ação. O editor de consultas é preenchido com um modelo.
     3. Substitua os marcadores de posição no modelo.
6. Execute suas consultas usando uma das seguintes abordagens:
   • Para executar todas as instruções no editor de consultas, clique em Executar.
   • Para executar instruções específicas, selecione uma ou várias instruções e clique em Executar selecionadas.
7. Os resultados das consultas aparecem na guia Resultados. Se vários conjuntos de resultados estiverem disponíveis, selecione um resultado na lista suspensa Todos os resultados.

Limitações

• O Cloud SQL Studio oferece suporte a consultas leves. Respostas com mais de 10 MB podem ficar truncadas. O Cloud SQL Studio indica quando resultados parciais são retornados.
• É possível executar consultas para instâncias do Cloud SQL em execução.
• O Cloud SQL Studio não aceita servidores externos.
• Solicitações que levam mais de cinco minutos são canceladas.
• O Cloud SQL Studio não mantém uma conexão de banco de dados aberta após a execução de um script SQL ser concluída. Da mesma forma, as guias do editor não compartilham uma sessão em comum, e cada execução inicia uma nova sessão.
• Quando você executa uma combinação de instruções DML, DQL e DDL, apenas os resultados das consultas DQL são exibidos.
• Fechar o navegador ou a guia do navegador não interrompe a execução da consulta no Cloud SQL Studio. A consulta será executada até ser concluída ou expirar.

• O Cloud SQL Studio só oferece suporte à autenticação nativa do PostgreSQL (nome de usuário e senha). Não é possível autenticar usando o Identity and Access Management ou usar as credenciais salvas no Secrets Manager.
• Se você executar várias instruções no editor de consultas ao mesmo tempo e uma ou mais instruções resultarem em erro, a execução de todas as instruções será cancelada, e o primeiro erro encontrado será exibido.