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:
Autenticação do banco de dados do IAM Com esse tipo de autenticação, você pode fazer login no seu banco de dados e no Cloud SQL Studio sem precisar gerenciar uma senha extra. Você também pode aproveitar a autenticação de grupo do IAM e gerenciar o acesso e os privilégios do banco de dados para vários usuários na sua organização ao mesmo tempo.
Autenticação de banco de dados integrada. Você se conecta ao banco de dados no Cloud SQL Studio usando a conta de usuário e as credenciais do PostgreSQL.
Explorar os dados
Para acessar o painel Explorer, siga estas etapas:
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Selecione uma instância na lista.
- No menu de navegação, clique em Cloud SQL Studio.
- 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:
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Selecione uma instância na lista.
- No menu de navegação, clique em Cloud SQL Studio.
- Faça login no Cloud SQL Studio usando o nome do seu banco de dados, nome de usuário e senha.
- Crie uma consulta usando um dos seguintes métodos:
- Para criar sua consulta, siga estas etapas:
- Abra uma nova guia clicando em .
- Quando o editor de consultas aparecer, crie sua consulta.
- Para criar uma consulta começando com um modelo, siga estas etapas:
- 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.
- Clique em uma ação. O editor de consultas é preenchido com um modelo.
- Substitua os marcadores de posição no modelo.
- Para criar sua consulta, siga estas etapas:
- 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.
- 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.
- Se você executar várias instruções no editor de consultas ao mesmo tempo e uma ou mais instruções resultarem em erro, a execução de todas as instruções será cancelada, e o primeiro erro encontrado será exibido.