Criar e gerenciar consultas salvas

Esta página descreve como criar e gerenciar consultas salvas. Ao escrever scripts SQL no Cloud SQL Studio, é possível salvar e gerenciar esses scripts. Para mais informações, consulte Visão geral das consultas salvas.

O recurso de consultas salvas está disponível apenas no console Google Cloud .

Funções exigidas

Para receber as permissões necessárias para usar consultas salvas, peça ao administrador para conceder a você os seguintes papéis do gerenciamento de identidade e acesso (IAM) no projeto:

  • Para ver as consultas salvas: usuário do Cloud SQL Studio (roles/cloudsql.studiouser)
  • Para criar, editar, visualizar e excluir consultas salvas em um projeto, incluindo o acesso à página Consultas salvas: administrador do Cloud SQL (roles/cloudsql.admin) ou usuário de consultas do Studio (roles/databasesconsole.studioQueryUser)
  • Para gerenciar todas as consultas salvas em um projeto, incluindo o acesso à página Consultas salvas: Administrador de consultas do Studio (roles/databasesconsole.studioQueryAdmin)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para usar consultas salvas. Para saber mais sobre as permissões necessárias, consulte Permissões necessárias.

Permissões necessárias

Para criar, visualizar, modificar e excluir consultas salvas, você precisa das seguintes permissões do IAM no nível do projeto:

Ação Permissões do IAM obrigatórias
Criar consultas salvas
  • databasesconsole.studioQueries.create
Ver consultas salvas
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Modificar consultas salvas
  • databasesconsole.studioQueries.update
Excluir consulta salva
  • databasesconsole.studioQueries.delete
Administrar consultas salvas
(somente para uso por administradores)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list
Também é possível conseguir essas permissões usando papéis personalizados ou outros papéis predefinidos.

A função Usuário de consultas do Studio (roles/databasesconsole.studioQueryUser) permite criar, visualizar e gravar consultas salvas. Essa função atende às necessidades da maioria dos usuários.

Conceda o papel Admin de consultas do Studio (roles/databasesconsole.studioQueryAdmin) apenas aos administradores. Para mais informações sobre o IAM do Cloud SQL para PostgreSQL, consulte Papéis e permissões.

Criar uma consulta salva

Para criar uma consulta salva, siga estas etapas:

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Selecione a instância em que você quer criar uma consulta salva.
  3. No menu de navegação, clique em Cloud SQL Studio.
  4. Na página Cloud SQL Studio, clique em Nova guia ou use a guia do editor vazia.
  5. No editor de consultas, insira uma consulta SQL.
  6. Clique em Salvar.
  7. Na caixa de diálogo Salvar consulta, digite um nome para a consulta salva.
  8. Clique em Salvar.

Abrir e executar uma consulta salva

Para abrir uma consulta salva como uma nova consulta, siga estas etapas:

  1. No painel Explorer da página Cloud SQL Studio, navegue até a seção Consultas.
  2. Clique em uma consulta salva para abrir em uma nova guia do editor. Se quiser, clique em Ver ações ao lado de uma consulta salva. Em seguida, clique em Abrir consulta para abrir em uma nova guia do editor.
  3. Clique em Executar.

Atualizar uma consulta salva

Para atualizar uma consulta salva, siga estas etapas:

  1. No painel Explorer da página Cloud SQL Studio, navegue até a seção Consultas.
  2. Clique em uma consulta salva para abrir em uma nova guia do editor. Se quiser, clique em Ver ações ao lado de uma consulta salva. Em seguida, clique em Abrir consulta para abrir em uma nova guia do editor.
  3. Modifique a consulta.
  4. Para salvar a consulta modificada, clique em Salvar.

Acessar e gerenciar uma lista de todas as consultas salvas

Para conferir uma lista de todas as consultas salvas no seu projeto, siga estas etapas:

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Selecione qualquer instância. Como uma consulta salva é filha de um projeto, desde que você tenha a função necessária, é possível ver todas as consultas salvas no projeto em qualquer instância ou banco de dados.
  3. No menu de navegação, clique em Cloud SQL Studio e faça a autenticação.
  1. Selecione qualquer banco de dados.
  2. No painel Explorer da página Cloud SQL Studio, navegue até a seção Consultas.
  3. Clique em Ver ações ao lado de uma consulta salva. Em seguida, clique em Gerenciar consultas.

    A página Consultas salvas será aberta. Esta página lista todas as consultas salvas no projeto, incluindo as de outros produtos do Google Cloud .

É possível pesquisar, filtrar, visualizar e excluir consultas na página Consultas salvas. Não é possível editar uma consulta na página Consultas salvas.

Excluir uma consulta salva

É possível excluir uma consulta salva na página do Cloud SQL Studio ou na página Consultas salvas no console do Google Cloud .

  1. No painel do Explorer da página Cloud SQL Studio, navegue até a seção "Consultas".
  2. Clique em Ver ações ao lado da consulta salva que você quer excluir. Em seguida, clique em Excluir consulta para remover a consulta salva.
  3. Na caixa de diálogo Excluir consulta, clique em Excluir.

Também é possível excluir uma consulta salva na página Consultas salvas. Para excluir uma consulta salva na página Consultas salvas, siga estas etapas:

  1. Acesse a página Consultas salvas.
  2. Clique em Ver ações ao lado da consulta salva que você quer excluir.
  3. Clique em Excluir consulta para remover a consulta salva.
  4. Na caixa de diálogo Excluir consulta, clique em Excluir.

A seguir