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

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

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Esta página descreve como criar e gerir consultas guardadas. Quando escreve consultas no Firestore Studio, pode guardar e gerir essas consultas. 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 ver as consultas guardadas: Visualizador do Cloud Datastore (roles/datastore.viewer)
• Para ver, criar, modificar e eliminar consultas guardadas: Utilizador do Cloud Datastore (roles/datastore.user)
• Para administrar, ver, criar, modificar e eliminar consultas guardadas: Proprietário do Cloud Datastore (roles/datastore.owner). Esta função tem autorizações amplas e fornece acesso total ao Firestore com compatibilidade com o MongoDB, apenas para utilização por parte dos administradores.

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

Nota: ter acesso a consultas guardadas não significa automaticamente que tem autorizações para executar a consulta.

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 de compatibilidade do Firestore com o MongoDB, consulte o artigo Gestão de identidade e de acesso.

Criar uma consulta guardada

Para criar uma consulta guardada, siga estes passos:

1. Aceda à página Todas as bases de dados na Google Cloud consola.
   Todas as bases de dados
2. Selecione uma base de dados do Firestore com compatibilidade com o MongoDB na qual quer criar uma consulta guardada.
3. No menu de navegação, clique em Firestore Studio.
4. No painel Explorador na página do Firestore Studio, navegue para a secção Coleções.
5. Clique numa coleção para abrir um novo separador do editor. Opcionalmente, pode clicar em Ver ações junto a uma coleção. Em seguida, clique em Recolha de consultas para abrir um novo separador do editor.
6. No editor de consultas, introduza uma consulta.
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 Firestore 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 Firestore 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 Todas as bases de dados na Google Cloud consola.
   Todas as bases de dados
2. Selecione qualquer base de dados. 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 base de dados.

3. Selecione qualquer base de dados.
4. No painel Explorador da página Firestore Studio, navegue para a secção Consultas.
5. 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 Firestore Studio ou na página Consultas guardadas na Google Cloud consola.

1. No painel Explorador da página Firestore 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?

• Saiba mais sobre as consultas guardadas.