Faça a gestão dos seus dados através do Cloud SQL Studio

Esta página descreve como explorar e gerir os seus dados do Cloud SQL através do Cloud SQL Studio na Google Cloud consola.

O Cloud SQL Studio permite que os utilizadores autorizados interajam diretamente com a base de dados SQL e executem consultas SQL a partir da consola do Google Cloud para aceder e manipular dados. Pode realizar uma série de ações que realizaria num cliente de linha de comandos SQL, como criar tabelas e índices, modificar tabelas ou configurar vistas.

O Cloud SQL Studio inclui um painel do Explorador que se integra com um editor de consultas e uma tabela de resultados de consultas SQL. Pode executar declarações DDL, DML e DQL a partir desta interface. Por exemplo, em vez de configurar uma ferramenta de consulta de base de dados de terceiros, pode criar uma tabela e consultar os seus dados através do editor de consultas no Cloud SQL Studio.

Pode usar o painel Explorador para ver e interagir com os objetos da base de dados. Cria, altera e elimina os objetos da base de dados, como os seguintes:

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

Também pode usar o painel do Explorador para preencher consultas SELECT para tabelas.

O Cloud SQL Studio valida automaticamente a sintaxe quando escreve uma consulta ou seleciona parte de uma consulta.

Se não conhece o Cloud SQL, consulte a vista geral do Cloud SQL.

Funções e autorizações necessárias

Para receber as autorizações de que precisa para concluir as tarefas neste documento, peça ao seu administrador para lhe conceder a função de IAM de utilizador do Cloud SQL Studio (roles/cloudsql.studioUser) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para usar o Cloud SQL Studio, tem de ter as seguintes autorizações:

  • cloudsql.databases.list
  • cloudsql.instances.executeSql
  • cloudsql.instances.get
  • cloudsql.instances.login (só é necessário se estiver a usar a autenticação da base de dados de IAM)
  • cloudsql.users.list

Além disso, certifique-se de que tem autorizações ao nível da base de dados para a base de dados que está a usar para autenticação e a palavra-passe do utilizador da base de dados privilegiado que está a usar.

Autentique-se no Cloud SQL Studio

Antes de poder aceder a uma base de dados no Cloud SQL Studio, tem de selecionar um método de autenticação de base de dados. Para iniciar sessão na sua base de dados através do Cloud SQL Studio, pode usar um dos seguintes tipos de autenticação:

Explorar os seus dados

Para aceder ao painel Explorador, siga estes passos:

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Selecione uma instância na lista.
  3. No menu de navegação, clique em Cloud SQL Studio.
  4. Inicie sessão no Cloud SQL Studio com o nome da base de dados, o nome de utilizador e a palavra-passe. O painel Explorador apresenta uma lista dos objetos na sua base de dados.

Crie, modifique e consulte os seus dados

Com o editor de SQL, pode executar uma combinação de declarações DDL, DML e DQL. Pode compor uma consulta ou preencher o editor de consultas com um modelo através do explorador.

Para estruturar, modificar ou consultar os seus dados, siga estes passos:

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Selecione uma instância na lista.
  3. No menu de navegação, clique em Cloud SQL Studio.
  4. Inicie sessão no Cloud SQL Studio com o nome da base de dados, o nome de utilizador e a palavra-passe.
  5. Componha uma consulta através de um dos seguintes métodos:
    • Para compor a sua própria consulta, siga estes passos:
      1. Abra um novo separador clicando em .
      2. Quando o editor de consultas aparecer, escreva a sua consulta.
    • Para compor uma consulta a partir de um modelo, siga estes passos:
      1. No painel Explorador, junto a um objeto ou uma coleção de base de dados, clique em more_vert Ver ações. São apresentadas uma ou mais ações disponíveis.
      2. Clique numa ação. O editor de consultas é preenchido com um modelo.
      3. Substitua todos os marcadores de posição no modelo.

  6. Execute as suas consultas através de uma das seguintes abordagens:

    • Para executar todas as declarações no editor de consultas, clique em Executar.
    • Para executar declarações específicas, selecione uma ou várias declarações e clique em Executar selecionadas.

  7. Os resultados das suas consultas aparecem no separador Resultados. Se estiverem disponíveis vários conjuntos de resultados, selecione um resultado na lista pendente Todos os resultados.

Limitações

  • O Cloud SQL Studio suporta consultas simples. As respostas com mais de 10 MB podem ser truncadas. O Cloud SQL Studio indica quando são devolvidos resultados parciais.
  • Só pode executar consultas para instâncias do Cloud SQL em execução.
  • O Cloud SQL Studio não suporta servidores externos.
  • As solicitações que demorem mais de cinco minutos são canceladas. A definição de um limite de tempo de consulta mais elevado através de SET STATEMENT_TIMEOUT não é suportada.
  • O Cloud SQL Studio não mantém uma ligação à base de dados aberta após a execução de um script SQL. Da mesma forma, os separadores do editor não partilham uma sessão comum e cada execução inicia uma nova sessão.
  • Quando executa uma combinação de declarações DML, DQL e DDL, apenas são apresentados os resultados das consultas DQL.
  • Fechar o navegador ou o separador do navegador não interrompe a execução da consulta no Cloud SQL Studio. A consulta é executada até ser concluída ou atingir o limite de tempo.
  • Se estiver a executar várias declarações no editor de consultas ao mesmo tempo e uma ou mais declarações resultarem num erro, a execução de todas as declarações é anulada e é apresentado o primeiro erro encontrado.
  • Quando o Cloud SQL Studio deteta uma sintaxe de consulta inválida, gera um registo no postgres.log. Estas entradas aparecem como entradas cloudsqladmin e contêm a consulta inválida, a posição do erro de sintaxe e uma mensagem de erro correspondente. Para remover estes registos da sua vista, configure filtros de registos para excluir a base de dados, o utilizador ou ambos.cloudsqladmincloudsqladmin

O que se segue?