Créer et gérer des requêtes enregistrées

Cette page explique comment créer et gérer des requêtes enregistrées. Lorsque vous écrivez des requêtes dans la console Firebase, vous pouvez les enregistrer et les gérer. Pour en savoir plus, consultez Présentation des requêtes enregistrées .

La fonctionnalité de requêtes enregistrées n'est disponible que dans la console, et non via des API.

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser les requêtes enregistrées, demandez à votre administrateur de vous accorder les rôles IAM (Identity and Access Management) suivants sur le projet :

  • Pour afficher les requêtes enregistrées : Lecteur Cloud Datastore (roles/datastore.viewer)
  • Pour afficher, créer, modifier et supprimer des requêtes enregistrées : Utilisateur Cloud Datastore (roles/datastore.user)
  • Pour administrer, afficher, créer, modifier et supprimer des requêtes enregistrées : Propriétaire Cloud Datastore (roles/datastore.owner). Ce rôle dispose d'autorisations étendues et offre un accès complet à Cloud Firestore. Il est réservé aux administrateurs.

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour utiliser les requêtes enregistrées. Pour en savoir plus sur les autorisations requises, consultez Autorisations requises.

Autorisations requises

Pour créer, afficher, modifier et supprimer des requêtes enregistrées, vous devez disposer des autorisations IAM suivantes au niveau du projet :

Action Autorisations IAM requises
Créer des requêtes enregistrées.
  • databasesconsole.studioQueries.create
Afficher les requêtes enregistrées
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Modifier des requêtes enregistrées
  • databasesconsole.studioQueries.update
Supprimer des requêtes enregistrées
  • databasesconsole.studioQueries.delete
Administrer les requêtes enregistrées
(réservé aux administrateurs)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

Vous pouvez également obtenir ces autorisations à l'aide de rôles personnalisés ou d'autres rôles prédéfinis.

Le rôle Utilisateur de requêtes Studio (roles/databasesconsole.studioQueryUser) permet de créer, d'afficher et d'écrire des requêtes enregistrées. Ce rôle répond aux besoins de la plupart des utilisateurs.

N'accordez le rôle Administrateur de requêtes Studio (roles/databasesconsole.studioQueryAdmin) qu'aux administrateurs. Pour en savoir plus sur Cloud Firestore IAM, consultez Gestion de l'authentification et des accès .

Créez une requête enregistrée

Pour créer une requête enregistrée, procédez comme suit :

  1. Accédez à la page Cloud Firestore dans la console Firebase.
    Cloud Firestore
  2. Sélectionnez la base de données dans laquelle vous souhaitez créer une requête enregistrée. La base de données doit être une instance de l'édition Enterprise.
  3. Cliquez sur l'onglet Query editor (Éditeur de requête).
  4. Saisissez une requête dans l'éditeur de requête.
  5. Cliquez sur Enregistrer.
  6. Dans la boîte de dialogue Enregistrer la requête, saisissez un nom pour la requête enregistrée.
  7. Cliquez sur Enregistrer.

Ouvrir et exécuter une requête enregistrée

Pour ouvrir une requête enregistrée en tant que nouvelle requête, procédez comme suit :

  1. Dans l'Éditeur de requête, cliquez sur Requêtes enregistrées ().
  2. Cliquez sur une requête enregistrée pour l'ouvrir dans un nouvel onglet de l'éditeur. Vous pouvez également cliquer sur Afficher les actions à côté d'une requête enregistrée. Cliquez ensuite sur Ouvrir la requête pour l'ouvrir dans un nouvel onglet de l'éditeur.
  3. Cliquez sur Exécuter.

Mettre à jour une requête enregistrée

Pour modifier une requête enregistrée existante, procédez comme suit :

  1. Dans l'Éditeur de requête, cliquez sur Requêtes enregistrées ().
  2. Cliquez sur une requête enregistrée pour l'ouvrir dans un nouvel onglet de l'éditeur. Vous pouvez également cliquer sur Afficher les actions à côté d'une requête enregistrée. Cliquez ensuite sur Ouvrir la requête pour l'ouvrir dans un nouvel onglet de l'éditeur.
  3. Modifiez la requête.
  4. Pour enregistrer la requête modifiée, cliquez sur Enregistrer.

Afficher et gérer la liste de toutes les requêtes enregistrées

Pour afficher la liste de toutes les requêtes enregistrées dans votre projet, procédez comme suit :

Dans la console Google Cloud, accédez à la page Requêtes enregistrées.

Accéder aux requêtes enregistrées

Vous pouvez rechercher, filtrer, afficher et supprimer des requêtes sur la page Requêtes enregistrées. Vous ne pouvez pas modifier une requête existante sur la page Requêtes enregistrées.

Supprimer une requête enregistrée

Vous pouvez supprimer une requête enregistrée depuis la page Cloud Firestore Studio ou la page Requêtes enregistrées de la console Google Cloud.

  1. Dans l'Éditeur de requête, cliquez sur Requêtes enregistrées ().
  2. Cliquez sur Afficher les actions à côté de la requête enregistrée que vous souhaitez supprimer. Pour supprimer la requête enregistrée, cliquez ensuite sur Supprimer la requête.
  3. Dans la boîte de dialogue Supprimer la requête, cliquez sur Supprimer.

Vous pouvez également supprimer une requête enregistrée depuis la page Requêtes enregistrées. Pour supprimer une requête enregistrée depuis la page Requêtes enregistrées, procédez comme suit :

  1. Accédez à la page Requêtes enregistrées.
  2. Cliquez sur Afficher les actions à côté de la requête enregistrée que vous souhaitez supprimer.
  3. Cliquez sur Supprimer la requête pour supprimer la requête enregistrée.
  4. Dans la boîte de dialogue Supprimer la requête, cliquez sur Supprimer.

Étape suivante