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.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, é necessário fazer a autenticação. Para fazer login no seu banco de dados usando o Cloud SQL Studio, use a autenticação de banco de dados integrada. Para mais informações, consulte Criar e gerenciar usuários.

O Cloud SQL Studio não é compatível com a autenticação do Active Directory.

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 não é compatível com o comando GO. Esse comando é usado nos utilitários do Microsoft SQL Server para indicar que um lote de instruções foi encerrado e pode ser enviado ao SQL Server.

  • Se uma consulta tiver uma coluna binária, o Cloud SQL Studio não poderá mostrá-la. Converta valores binários em uma string.

    Por exemplo, substitua:

    SELECT my_binary_column from my_table2;

    por:

    SELECT CONVERT(NVARCHAR(4000), my_binary_column, 1) from my_table2;

  • 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:

    BEGIN TRANSACTION
    YOUR_SQL_STATEMENTS
COMMIT;

    Substitua:

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