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 scripts SQL dans Bigtable 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 Bigtable (roles/bigtable.reader)
• Pour afficher, créer, modifier et supprimer des requêtes enregistrées : Utilisateur Bigtable (roles/bigtable.user)
• Pour administrer, afficher, créer, modifier et supprimer des requêtes enregistrées : Administrateur Bigtable (roles/bigtable.admin). Ce rôle dispose de nombreuses autorisations et offre un accès complet à Bigtable. 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

Remarque : Le fait d'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 Bigtable IAM, consultez Contrôle des accès Bigtable avec IAM.

Créez une requête enregistrée

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

1. Dans la console Google Cloud , accédez à la page Instances Bigtable.
   Instances
2. Sélectionnez l'instance dans laquelle vous souhaitez créer une requête enregistrée.

3. Dans le menu de navigation, cliquez sur Bigtable Studio.

   Le volet Explorateur affiche la liste des tables, des vues et des requêtes de l'instance.

4. Dans l'onglet Éditeur, exécutez votre requête.

   Les résultats s'affichent dans le tableau Résultats.

5. Si vous n'êtes pas satisfait des résultats, modifiez la requête et exécutez-la à nouveau. Lorsque vous êtes satisfait de la requête, 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.

Facultatif :

• Pour enregistrer la requête sous un autre nom, cliquez sur la flèche d'expansion Enregistrer sous, sélectionnez Enregistrer en tant que requête, puis saisissez un nouveau nom dans la boîte de dialogue.
• Pour modifier la région utilisée par cette requête enregistrée, sélectionnez Afficher les options avancées. Ensuite, dans la liste Région, sélectionnez une région.

Vous pouvez également enregistrer la requête en tant que vue logique ou matérialisée continue.

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 Bigtable 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 Bigtable 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. Dans la console Google Cloud , accédez à la page Instances Bigtable.
   Instances
2. 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.

3. Dans le volet Explorateur de la page Bigtable Studio, accédez à la section Requêtes.
4. 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 Bigtable Studio ou la page Requêtes enregistrées de la console Google Cloud .

1. Dans le volet Explorateur de la page Bigtable 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. 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

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