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.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 se autenticar primeiro na base de dados. Para iniciar sessão na sua base de dados através do Cloud SQL Studio, use a autenticação de base de dados incorporada. Para mais informações, consulte o artigo Crie e faça a gestão de utilizadores.
O Cloud SQL Studio não suporta a autenticação do Active Directory.
Explorar os seus dados
Para aceder ao painel Explorador, siga estes passos:
-
Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.
- Selecione uma instância na lista.
- No menu de navegação, clique em Cloud SQL Studio.
- 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:
-
Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.
- Selecione uma instância na lista.
- No menu de navegação, clique em Cloud SQL Studio.
- Inicie sessão no Cloud SQL Studio com o nome da base de dados, o nome de utilizador e a palavra-passe.
- Componha uma consulta através de um dos seguintes métodos:
- Para compor a sua própria consulta, siga estes passos:
- Abra um novo separador clicando em .
- Quando o editor de consultas aparecer, escreva a sua consulta.
- Para compor uma consulta a partir de um modelo, siga estes passos:
- 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.
- Clique numa ação. O editor de consultas é preenchido com um modelo.
- Substitua todos os marcadores de posição no modelo.
- Para compor a sua própria consulta, siga estes passos:
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 LOCK_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.
- O Cloud SQL Studio não suporta o comando
GO
. Este comando é usado nos utilitários do Microsoft SQL Server para indicar que um lote de declarações terminou e pode ser enviado para o SQL Server. Se uma consulta incluir uma coluna binária, o Cloud SQL Studio não a pode apresentar. Em alternativa, converta os valores binários numa string.
Por exemplo, substitua:
SELECT my_binary_column from my_table2;
com:
SELECT CONVERT(NVARCHAR(4000), my_binary_column, 1) from my_table2;
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:BEGIN TRANSACTION YOUR_SQL_STATEMENTS COMMIT;
Substitua o seguinte:
- YOUR_SQL_STATEMENTS: as declarações que quer executar como parte desta consulta