Criar e gerenciar consultas salvas

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Esta página descreve como criar e gerenciar consultas salvas. Ao escrever scripts SQL no Bigtable 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 Google Cloud console.

Funções exigidas

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

• Para visualizar consultas salvas: Leitor do Bigtable (roles/bigtable.reader)
• Para visualizar, criar, modificar e excluir consultas salvas: Usuário do Bigtable (roles/bigtable.user)
• Para administrar, visualizar, criar, modificar e excluir consultas salvas: Administrador do Bigtable (roles/bigtable.admin). Esse papel tem permissões amplas e oferece acesso total ao Bigtable, apenas para uso por administradores.

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 consultas salvas	databasesconsole.studioQueries.delete
Administrar consultas salvas (apenas para uso por administradores)	databasesConsole.studioQueries.list databasesconsole.locations.list

Observação:ter acesso a consultas salvas não significa automaticamente que você tem permissões para executar a consulta.

Também é possível conseguir essas permissões usando papéis personalizados ou outros papéis predefinidos.

O papel de Usuário de consultas do Studio (roles/databasesconsole.studioQueryUser) oferece acesso para criar, visualizar e gravar consultas salvas. Esse papel atende às necessidades da maioria dos usuários.

Conceda o papel de Admin de consultas do Studio (roles/databasesconsole.studioQueryAdmin) apenas aos administradores. Para mais informações sobre o IAM do Bigtable, consulte Controle de acesso do Bigtable com o IAM.

Criar uma consulta salva

Para criar uma consulta salva, siga estas etapas:

1. Noconsole, acesse a página Instâncias do Bigtable. Google Cloud
   Instances
2. Selecione a instância em que você quer criar uma consulta salva.

3. No menu de navegação, clique em Bigtable Studio.

   O painel Explorer mostra uma lista de tabelas, visualizações e consultas na instância.

4. Na guia Editor, execute a consulta.

   Os resultados aparecem na tabela Resultados.

5. Se você não estiver satisfeito com os resultados, modifique a consulta e execute-a novamente. Quando estiver satisfeito com a consulta, clique em Salvar.
6. Na caixa de diálogo Salvar consulta, insira um nome para a consulta salva.
7. Clique em Salvar.

Opcional:

• Para salvar a consulta com um nome diferente, clique na seta de expansão Salvar como escolha Salvar como consulta e insira um novo nome na caixa de diálogo.
• Para mudar a região usada por essa consulta salva, selecione Mostrar opções avançadas. Em seguida, na lista Região, selecione uma região.

Também é possível salvar a consulta como uma visualização lógica ou materializada contínua.

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 Bigtable 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 Bigtable 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.

Visualizar e gerenciar uma lista de todas as consultas salvas

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

1. Noconsole, acesse a página Instâncias do Bigtable. Google Cloud
   Instances
2. Selecione uma instância. 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 instância ou banco de dados.

3. No painel Explorer da página Bigtable Studio, navegue até a seção Consultas.
4. Clique em Ver ações ao lado de uma consulta salva. Em seguida, clique em Gerenciar consultas.

   A página Consultas salvas será aberta. Essa página lista todas as consultas salvas neste 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 Bigtable Studio ou na página Consultas salvas noconsole. Google Cloud

1. No painel Explorer da página Bigtable 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

• Saiba mais sobre as consultas salvas.