Gerenciar dados com o Cloud SQL Studio

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.

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

Papéis e permissões necessárias

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.instances.login (somente necessário se você estiver usando a autenticação do banco de dados do IAM)
  • 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.

Autenticação no Cloud SQL Studio

Antes de acessar um banco de dados no Cloud SQL Studio, você precisa selecionar um método de autenticação. Para fazer login no seu banco de dados usando o Cloud SQL Studio, use um dos seguintes tipos de autenticação:

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. No Cloud SQL para MySQL 5.6 e 5.7, o tempo limite de instruções DDL de longa execução pode causar tabelas ou arquivos órfãos que não podem ser revertidos com segurança. Tenha cuidado com consultas como ALTER TABLE em tabelas grandes.
  • 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 não é compatível com a execução de consultas SELECT em dados de BLOB. Se o script SQL produzir uma coluna BLOB na saída, o script SQL falhará com um erro.
  • Os comandos do cliente do Cloud SQL para MySQL não são compatíveis e não podem ser executados no Cloud SQL Studio.
  • O usuário root não é permitido no Cloud SQL Studio.
  • O Cloud SQL Studio sempre requer um banco de dados, mesmo que o Cloud SQL para MySQL não precise de um banco de dados para se conectar.
  • Usuários com senhas vazias não são permitidos no Cloud SQL Studio.
  • USE database é com estado apenas para a execução da consulta ativa e não funciona da mesma forma que na gcloud CLI.
  • O usuário do banco de dados precisa ter permissão para se conectar pelo localhost.

  • Quando várias consultas são executadas e uma delas falha, o primeiro erro encontrado é retornado. Algumas das instruções do lote antes do erro podem ter sido executadas com sucesso. É possível unir várias consultas em uma instrução transaction para evitar esse problema:

    START TRANSACTION;
    YOUR_SQL_STATEMENTS
COMMIT;

    Substitua:

    • YOUR_SQL_STATEMENTS: as instruções que você quer executar como parte dessa consulta