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

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

Preview

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page explique comment créer et gérer des requêtes enregistrées. Lorsque vous écrivez des requêtes dans Firestore Studio, 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 Google Cloud .

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 de nombreuses autorisations et offre un accès complet à Firestore avec la compatibilité MongoDB. 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 les requêtes enregistrées	databasesconsole.studioQueries.delete
Administrer les requêtes enregistrées (réservé aux administrateurs)	databasesConsole.studioQueries.list databasesconsole.locations.list

Remarque : Avoir accès aux requêtes enregistrées ne signifie pas automatiquement que vous êtes autorisé à les exécuter.

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 Firestore avec la compatibilité MongoDB IAM, consultez Identity and Access Management.

Créez une requête enregistrée

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

1. Accédez à la page Toutes les bases de données dans la console Google Cloud .
   Toutes les bases de données
2. Sélectionnez une base de données Firestore compatible avec MongoDB dans laquelle vous souhaitez créer une requête enregistrée.
3. Dans le menu de navigation, cliquez sur Firestore Studio.
4. Dans le volet Explorateur de la page Firestore Studio, accédez à la section Collections.
5. Cliquez sur une collection pour ouvrir un nouvel onglet de l'éditeur. Vous pouvez également cliquer sur Afficher les actions à côté d'une collection. Cliquez ensuite sur Collection de requêtes pour ouvrir un nouvel onglet de l'éditeur.
6. Saisissez une requête dans l'éditeur de requête.
7. Cliquez sur Enregistrer.
8. Dans la boîte de dialogue Enregistrer la requête, saisissez un nom pour la requête enregistrée.
9. 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 le volet Explorateur de la page Firestore Studio, accédez à la section Requêtes.
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 le volet Explorateur de la page Firestore Studio, accédez à la section Requêtes.
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 :

1. Accédez à la page Toutes les bases de données dans la console Google Cloud .
   Toutes les bases de données
2. Sélectionnez une base de données. Étant donné qu'une requête enregistrée est un enfant d'un projet, vous pouvez afficher toutes les requêtes enregistrées dans le projet à partir de n'importe quelle base de données, à condition de disposer du rôle requis.

3. Sélectionnez une base de données.
4. Dans le volet Explorateur de la page Firestore Studio, accédez à la section Requêtes.
5. Cliquez sur Afficher les actions à côté d'une requête enregistrée. Cliquez ensuite sur Gérer les requêtes.

   La page Requêtes enregistrées s'ouvre. Cette page liste toutes les requêtes enregistrées dans ce projet, y compris celles enregistrées pour d'autres produits Google Cloud .

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 Firestore Studio ou la page Requêtes enregistrées de la console Google Cloud .

1. Dans le volet "Explorateur" de la page Firestore Studio, accédez à la section "Requêtes".
2. Cliquez sur Afficher les actions à côté de la requête enregistrée que vous souhaitez supprimer. Cliquez ensuite sur Supprimer la requête pour supprimer la requête enregistrée.
3. Dans la boîte de dialogue Supprimer la requête, cliquez sur Supprimer.

Vous pouvez également supprimer une requête enregistrée sur la page Requêtes enregistrées. Pour supprimer une requête enregistrée sur 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.

Étapes suivantes

• En savoir plus sur les requêtes enregistrées