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.

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.

    • 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 SESSION MAX_EXECUTION_TIME não é suportada. Para o Cloud SQL para MySQL 5.6 e 5.7, o tempo limite das declarações DDL de execução prolongada pode causar ficheiros ou tabelas órfãos que não podem ser revertidos em segurança. Tenha cuidado com consultas como ALTER TABLE em tabelas grandes.
  • 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.
  • O Cloud SQL Studio não suporta a execução de consultas SELECT em dados BLOB. Se o script SQL produzir uma coluna BLOB na saída, o script SQL falha com um erro.
  • Os comandos do cliente do Cloud SQL para MySQL não são suportados e não podem ser executados no Cloud SQL Studio.
  • O utilizador root não é suportado no Cloud SQL Studio.
  • O Cloud SQL Studio requer sempre uma base de dados, mesmo que o Cloud SQL para MySQL não exija uma base de dados para estabelecer ligação.
  • Os utilizadores com palavras-passe vazias não são suportados no Cloud SQL Studio.
  • USE database é com estado apenas para a execução de consultas ativas e não funciona da mesma forma que na CLI gcloud.
  • O utilizador da base de dados tem de ter autorização para estabelecer ligação a partir do anfitrião local.

  • Quando executa várias consultas e uma delas falha, é devolvido o primeiro erro encontrado. Algumas das declarações no lote antes do erro podem ter sido executadas com êxito. Pode incluir várias consultas numa declaração transaction para evitar este problema:

    START TRANSACTION;
    YOUR_SQL_STATEMENTS
COMMIT;

    Substitua o seguinte:

    • YOUR_SQL_STATEMENTS: as declarações que quer executar como parte desta consulta