Crie e faça a gestão de consultas guardadas

Esta página descreve como criar e gerir consultas guardadas. Quando escreve scripts SQL no Spanner Studio, pode guardar e gerir esses scripts SQL. Para mais informações, consulte o artigo Vista geral das consultas guardadas .

A capacidade de consultas guardadas só está disponível na Google Cloud consola.

Funções necessárias

Para receber as autorizações necessárias para usar consultas guardadas, peça ao seu administrador para lhe conceder as seguintes funções de gestão de identidade e acesso (IAM) 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.

Estas funções predefinidas contêm as autorizações necessárias para usar consultas guardadas. Para saber mais acerca das autorizações necessárias, consulte o artigo Autorizações necessárias.

Autorizações necessárias

Para criar, ver, modificar e eliminar consultas guardadas, precisa das seguintes autorizações da IAM ao nível do projeto:

Ação Autorizações de IAM necessárias
Crie consultas guardadas
  • databasesconsole.studioQueries.create
Ver consultas guardadas
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Modifique consultas guardadas
  • databasesconsole.studioQueries.update
Eliminar consultas guardadas
  • databasesconsole.studioQueries.delete
Administrar consultas guardadas
(Apenas para utilização por administradores)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list
Também pode obter estas autorizações através de funções personalizadas ou outras funções predefinidas.

A função Utilizador de consultas do Studio (roles/databasesconsole.studioQueryUser) permite criar, ver e escrever consultas guardadas. Esta função satisfaz as necessidades da maioria dos utilizadores.

Conceda a função Administrador de consultas do Studio (roles/databasesconsole.studioQueryAdmin) apenas aos administradores. Para mais informações sobre o IAM do Spanner, consulte a vista geral do IAM.

Criar uma consulta guardada

Para criar uma consulta guardada, siga estes passos:

  1. Aceda à página Instances do Spanner na Google Cloud consola.
    Instâncias
  2. Selecione a instância na qual quer criar uma consulta guardada.
  3. Selecione a base de dados na qual quer criar uma consulta guardada.
  4. No menu de navegação, clique em Spanner Studio.
  5. Na página Spanner Studio, clique em Novo separador ou use o separador do editor vazio.
  6. No editor de consultas, introduza uma consulta SQL.
  7. Clique em Guardar.
  8. Na caixa de diálogo Guardar consulta, introduza um nome para a consulta guardada.
  9. Clique em Guardar.

Abra e execute uma consulta guardada

Para abrir uma consulta guardada como uma nova consulta, siga estes passos:

  1. No painel Explorador da página Spanner Studio, navegue para a secção Consultas.
  2. Clique numa consulta guardada para a abrir num novo separador do editor. Opcionalmente, pode clicar em Ver ações junto a uma consulta guardada. Em seguida, clique em Abrir consulta para a abrir num novo separador do editor.
  3. Clique em Executar.

Atualize uma consulta guardada

Para atualizar uma consulta guardada existente, siga estes passos:

  1. No painel Explorador da página Spanner Studio, navegue para a secção Consultas.
  2. Clique numa consulta guardada para a abrir num novo separador do editor. Opcionalmente, pode clicar em Ver ações junto a uma consulta guardada. Em seguida, clique em Abrir consulta para a abrir num novo separador do editor.
  3. Modifique a consulta.
  4. Para guardar a consulta modificada, clique em Guardar.

Veja e faça a gestão de uma lista de todas as consultas guardadas

Para ver uma lista de todas as consultas guardadas no seu projeto, siga estes passos:

  1. Aceda à página Instances do Spanner na Google Cloud consola.
    Instâncias
  2. Selecione qualquer instância. Uma vez que uma consulta guardada é subordinada a um projeto, desde que tenha a função necessária, pode ver todas as consultas guardadas no projeto a partir de qualquer instância ou base de dados.
  1. Selecione qualquer base de dados.
  2. No painel Explorador da página Spanner Studio, navegue para a secção Consultas.
  3. Clique em Ver ações junto a uma consulta guardada. Em seguida, clique em Gerir consultas.

    É apresentada a página Consultas guardadas. Esta página lista todas as consultas guardadas neste projeto, incluindo consultas guardadas para outros Google Cloud produtos.

Pode pesquisar, filtrar, ver e eliminar consultas na página Consultas guardadas. Não pode editar uma consulta existente na página Consultas guardadas.

Elimine uma consulta guardada

Pode eliminar uma consulta guardada na página Spanner Studio ou na página Consultas guardadas na Google Cloud consola.

  1. No painel do explorador na página Spanner Studio, navegue para a secção Consultas.
  2. Clique em Ver ações junto à consulta guardada que quer eliminar. Em seguida, clique em Eliminar consulta para eliminar a consulta guardada.
  3. Na caixa de diálogo Eliminar consulta, clique em Eliminar.

Também pode eliminar uma consulta guardada na página Consultas guardadas. Para eliminar uma consulta guardada na página Consultas guardadas, siga estes passos:

  1. Navegue para a página Consultas guardadas.
  2. Clique em Ver ações junto à consulta guardada que quer eliminar.
  3. Clique em Eliminar consulta para eliminar a consulta guardada.
  4. Na caixa de diálogo Eliminar consulta, clique em Eliminar.

O que se segue?