Criar e gerenciar consultas salvas

Esta página descreve como criar e gerenciar consultas salvas. Ao escrever scripts SQL no Spanner Studio, você pode salvar e gerenciar esses scripts SQL. Para mais informações, consulte Visão geral das consultas salvas.

O recurso de consultas salvas está disponível apenas no console do 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 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 conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para usar consultas salvas:

  • Para criar e excluir consultas salvas:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
  • Para gerenciar todas as consultas salvas em um projeto:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
    • databasesConsole.studioQuery.list
    • databasesConsole.studioQuery.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

A função de usuário da consulta do Studio (roles/databasesConsole.studioQueryUser) fornece acesso para criar, visualizar e gravar consultas salvas. É suficiente para a maioria dos usuários.

O papel de administrador de consulta do Studio (roles/databasesConsole.studioQueryAdmin) só pode ser concedido a administradores. Para mais informações sobre o gerenciamento de identidade e acesso (IAM) do Spanner, consulte Visão geral do IAM.

Permissões

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

  • databasesConsole.locations.get
  • databasesConsole.locations.list
  • databasesConsole.studioQueries.create

Para conferir as consultas salvas, você precisa da seguinte permissão no nível do projeto:

  • databasesConsole.studioQueries.search

Para modificar e excluir consultas salvas, você precisa da seguinte permissão no nível do projeto:

  • databasesConsole.studioQueries.update

As permissões para executar consultas são herdadas do banco de dados. Talvez você tenha permissões para visualizar, mas não para executar uma consulta.

Criar uma consulta salva

Para criar uma consulta salva, siga estas etapas:

  1. Acesse a página Instâncias do Spanner no console do Google Cloud.

    Instâncias

  2. Selecione a instância em que você quer criar uma consulta salva.

  3. Selecione o banco de dados em que você quer criar uma consulta salva.

  4. No menu de navegação, clique em Spanner Studio.

    1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  5. No editor de consultas, insira uma consulta válida do 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, siga estas etapas:

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.
  2. No painel Explorer, navegue até a seção Consultas. Clique em uma consulta salva para abrir em uma nova guia do editor. Você também pode clicar em Conferir ações ao lado de uma consulta salva. Em seguida, clique em Abrir consulta para abrir a consulta em uma nova guia do editor.
  3. Clique em Executar.

Atualizar uma consulta salva

Para atualizar uma consulta salva, siga estas etapas:

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.
  2. No painel Explorer, navegue até a seção Consultas. Clique em uma consulta salva para abrir em uma nova guia do editor. Também é possível clicar em Conferir 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. Acesse a página Instâncias do Spanner no console do Google Cloud.

    Instâncias

  2. Selecione qualquer instância. Como uma consulta salva é uma criança de um projeto, contanto que você tenha a função necessária, é possível conferir todas as consultas salvas no projeto em qualquer instância ou banco de dados.

  3. Selecione qualquer banco de dados.

  4. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.

  5. No painel Explorer, navegue até a seção Consultas. Clique em Conferir ações ao lado de uma consulta salva. Em seguida, clique em Gerenciar consultas.

    A página Consultas salvas é aberta. Ele lista todas as consultas salvas neste projeto (incluindo consultas salvas para outros produtos 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.

Para excluir uma consulta salva na página Consultas salvas, siga estas etapas:

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

Excluir uma consulta salva

  1. Na página Spanner Studio, clique em Nova guia ou use a guia do editor vazia.
  2. No painel Explorer, expanda a pasta Consultas. Clique em Ver ações ao lado da consulta salva que você quer excluir. Em seguida, clique em Excluir consulta para excluir a consulta salva.
  3. Na caixa de diálogo Excluir consulta, clique em Excluir.

A seguir