Cette page explique comment créer et gérer des requêtes enregistrées. Lorsque vous écrivez des scripts SQL dans Spanner 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 créer, modifier et supprimer des requêtes enregistrées : Utilisateur de requêtes Studio
(
roles/databasesconsole.studioQueryUser) - Pour gérer toutes les requêtes enregistrées dans un projet, y compris l'accès à la page Requêtes enregistrées : Administrateur de requêtes Studio (
roles/databasesconsole.studioQueryAdmin)
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 |
|
| Afficher les requêtes enregistrées |
|
| Modifier des requêtes enregistrées |
|
| Supprimer les requêtes enregistrées |
|
| Administrer les requêtes enregistrées (réservé aux administrateurs) |
|
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 Spanner IAM, consultez la présentation d'IAM.
Créez une requête enregistrée
Pour créer une requête enregistrée, procédez comme suit :
- Accédez à la page Instances de Spanner dans la console Google Cloud .
Instances - Sélectionnez l'instance dans laquelle vous souhaitez créer une requête enregistrée.
- Sélectionnez la base de données dans laquelle vous souhaitez créer une requête enregistrée.
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur vide.
- Dans l'éditeur de requête, saisissez une requête SQL.
- Cliquez sur Enregistrer.
- Dans la boîte de dialogue Enregistrer la requête, saisissez un nom pour la requête enregistrée.
- 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 :
- Dans le volet Explorateur de la page Spanner Studio, accédez à la section Requêtes.
- 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.
- Cliquez sur Exécuter.
Mettre à jour une requête enregistrée
Pour modifier une requête enregistrée existante, procédez comme suit :
- Dans le volet Explorateur de la page Spanner Studio, accédez à la section Requêtes.
- 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.
- Modifiez la requête.
- 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 :
- Accédez à la page Instances de Spanner dans la console Google Cloud .
Instances - Sélectionnez une instance. É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 instance ou base de données, à condition de disposer du rôle requis.
- Sélectionnez une base de données.
- Dans le volet Explorateur de la page Spanner Studio, accédez à la section Requêtes.
- 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 Spanner Studio ou la page Requêtes enregistrées de la console Google Cloud .
- Dans le volet "Explorateur" de la page Spanner Studio, accédez à la section "Requêtes".
- 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.
- 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 :
- Accédez à la page Requêtes enregistrées.
- Cliquez sur Afficher les actions à côté de la requête enregistrée que vous souhaitez supprimer.
- Cliquez sur Supprimer la requête pour supprimer la requête enregistrée.
- Dans la boîte de dialogue Supprimer la requête, cliquez sur Supprimer.
Étapes suivantes
- En savoir plus sur les requêtes enregistrées