Criar e gerenciar consultas salvas

Esta página descreve como criar e gerenciar consultas salvas. Ao escrever scripts SQL no AlloyDB 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, e não usando APIs.

Funções exigidas

Para ter as permissões necessárias para usar consultas salvas, peça ao administrador para conceder a você as seguintes funções do Identity and Access Management (IAM) no projeto:

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 necessá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.

O papel Usuário de consultas do Studio (roles/databasesconsole.studioQueryUser) fornece acesso para criar, visualizar e gravar consultas salvas. Esse papel 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 AlloyDB, consulte Papéis e permissões do AlloyDB .

Criar uma consulta salva

Para criar uma consulta salva, siga estas etapas:

  1. No Google Cloud console, acesse a página Clusters.
    Acesse Clusters
  2. Selecione a instância em que você quer criar uma consulta salva.
  3. No menu de navegação, clique em AlloyDB Studio.
  4. Na página AlloyDB 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, insira 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 AlloyDB Studio, navegue até a seção Consultas.
  2. Clique em uma consulta salva para abri-la em uma nova guia do editor. Opcionalmente, você pode clicar Ver ações ao lado de uma consulta salva. Em seguida, clique em Abrir consulta para abri-la 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 AlloyDB Studio, navegue até a seção Consultas.
  2. Clique em uma consulta salva para abri-la em uma nova guia do editor. Opcionalmente, você pode clicar Ver ações ao lado de uma consulta salva. Em seguida, clique em Abrir consulta para abri-la em uma nova guia do editor.
  3. Modifique a consulta.
  4. Para salvar a consulta modificada, clique em Salvar.

Ver e gerenciar uma lista de todas as consultas salvas

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

  1. No Google Cloud console, acesse a página Clusters.
    Acesse Clusters
  2. Selecione qualquer cluster. Como uma consulta salva é filha de um projeto, desde que você tenha o papel necessário, é possível visualizar todas as consultas salvas no projeto de qualquer cluster, instância ou banco de dados.
  3. No menu de navegação, clique em AlloyDB Studio e faça a autenticação.
  1. Selecione qualquer banco de dados.
  2. No painel Explorer da página AlloyDB 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 é aberta. Essa página lista todas as consultas salvas no projeto, incluindo consultas salvas para outros Google Cloud produtos.

É 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 AlloyDB Studio ou na página Consultas salvas noconsole. Google Cloud

  1. No painel Explorer da página AlloyDB Studio, navegue até a seção Consultas.
  2. Clique em Ver ações ao lado da consulta salva que você quer excluir. Em seguida, para excluir a consulta salva, clique em Excluir consulta.
  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. Navegue até 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 excluir a consulta salva.
  4. Na caixa de diálogo Excluir consulta, clique em Excluir.

A seguir