Gérer les requêtes enregistrées

Ce document explique comment gérer les requêtes enregistrées et les requêtes enregistrées classiques.

Saved queries

Utilisez les sections suivantes pour apprendre à gérer les requêtes enregistrées. Les requêtes enregistrées sont des éléments de code BigQuery Studio fournis par Dataform.

Important : En mars 2024, les API compatibles avec les fonctionnalités de BigQuery Studio ont été automatiquement activées pour tous les projets BigQuery existants. Ces API sont activées par défaut dans les nouveaux projets BigQuery. Pour en savoir plus, consultez la section Activation automatique des API BigQuery Studio.

Autorisations requises

Pour gérer les requêtes enregistrées, vous avez besoin des rôles IAM (Identity and Access Management) suivants :

• Utilisateur de job BigQuery (roles/bigquery.jobUser)
• Utilisateur de sessions de lecture BigQuery (roles/bigquery.readSessionUser)
• Propriétaire de code (roles/dataform.codeOwner)

Pour plus d'informations sur BigQuery IAM, consultez la page Contrôle des accès avec IAM.

Accorder l'accès aux requêtes enregistrées

Pour autoriser d'autres utilisateurs à accéder à une requête enregistrée, ajoutez-les à un rôle IAM approprié.

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Recherchez la requête enregistrée à laquelle vous souhaitez accorder l'accès.

3. Cliquez sur Afficher les actions à côté de la requête enregistrée, puis sur Partager > Gérer les autorisations.

4. Dans le volet Gérer les autorisations, cliquez sur Ajouter un utilisateur/groupe.

5. Dans le champ Nouveaux comptes principaux, saisissez un compte principal.

6. Dans la liste Rôle, sélectionnez l'un des rôles suivants :

   • Propriétaire du code : peut effectuer toute action sur la requête enregistrée, y compris la suppression ou le partage.
   • Éditeur de code : peut modifier la requête.
   • Lecteur de code : peut afficher la requête.
   Remarque : Le compte principal doit également disposer du rôle Utilisateur BigQuery (roles/bigquery.user) pour exécuter la requête enregistrée.

7. Facultatif : Pour afficher la liste complète des rôles et des paramètres de partage avancés, cliquez sur Partage avancé.

8. Cliquez sur Enregistrer.

9. Pour revenir aux informations concernant la requête enregistrée, cliquez sur Fermer.

Partager des requêtes enregistrées

Vous pouvez partager une requête enregistrée avec d'autres utilisateurs en générant et en partageant un lien vers cette requête. Pour que les utilisateurs puissent voir la requête enregistrée que vous partagez, vous devez d'abord leur accorder l'accès à la requête enregistrée.

Pour exécuter une requête partagée, les utilisateurs doivent avoir accès aux données auxquelles la requête accède. Pour en savoir plus, consultez la section Accorder l'accès à un ensemble de données.

Si vous prévoyez de partager une requête enregistrée, envisagez d'y inclure un commentaire décrivant son objectif.

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, développez le dossier Requêtes partagées. Recherchez la requête enregistrée que vous souhaitez partager.

3. Cliquez sur Afficher les actions à côté de la requête, puis sur Partager > Copier le lien.

4. Partagez le lien avec d'autres utilisateurs.

Afficher 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 BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, cliquez sur Afficher les actions à côté de Requêtes, puis effectuez l'une des opérations suivantes :

• Pour ouvrir la liste dans l'onglet actuel, cliquez sur Tout afficher.
• Pour ouvrir la liste dans un nouvel onglet, cliquez sur Tout afficher dans > Nouvel onglet.
• Pour ouvrir la liste dans un onglet divisé, cliquez sur Tout afficher dans > Diviser l'onglet.

Afficher les métadonnées des requêtes enregistrées

Pour afficher les métadonnées des requête enregistrées, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Cliquez sur le nom de la requête enregistrée dont vous souhaitez afficher les métadonnées.

3. Consultez le volet Résumé pour afficher des informations sur la requête enregistrée, telles que la région qu'elle utilise et la date de sa dernière modification.

Utiliser les versions d'une requête enregistrée

Les sections suivantes vous expliquent comment afficher, comparer et restaurer des versions d'une requête enregistrée.

Afficher les versions d'une requête enregistrée

Pour afficher les versions d'une requête enregistrée, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Cliquez sur le nom de la requête enregistrée dont vous souhaitez afficher l'activité.

3. Cliquez sur l'onglet Activité pour afficher la liste des versions d'une requête enregistrée par ordre décroissant de date.

Comparer les versions d'une requête enregistrée

Pour comparer les versions d'une requête enregistrée, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Cliquez sur le nom de la requête enregistrée dont vous souhaitez comparer les informations de version.

3. Dans l'onglet Activité, cliquez sur Afficher les actions à côté d'une version de requête enregistrée, puis sur Comparer. Le volet de comparaison s'ouvre. Il compare la version de requête enregistrée que vous avez sélectionnée avec la version actuelle de la requête enregistrée.

4. (Facultatif) Pour comparer les versions de manière intégrée plutôt que dans des volets distincts, cliquez sur Comparer, puis sur Intégré.

Restaurer une version d'une requête enregistrée

Utilisez l'une des options suivantes pour restaurer une version d'une requête enregistrée. La restauration à partir du volet de comparaison vous permet de comparer la version précédente de la requête enregistrée à la version actuelle avant de la restaurer.

Volet Activité

1. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Cliquez sur le nom de la requête enregistrée dont vous souhaitez restaurer une version précédente.
2. Sélectionnez le volet Activité.
3. Cliquez sur Afficher les actions à côté de la version de la requête enregistrée que vous souhaitez restaurer, puis sur Restaurer.
4. Cliquez sur Confirmer pour confirmer l'action.

Volet Comparaison

1. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Cliquez sur le nom de la requête enregistrée dont vous souhaitez restaurer une version précédente.
2. Sélectionnez le volet Activité.
3. Cliquez sur Afficher les actions à côté d'une version de requête enregistrée, puis sur Comparer. Le volet de comparaison s'ouvre. Il compare la version de requête enregistrée que vous avez sélectionnée avec la dernière version de la requête enregistrée.
4. Si vous souhaitez restaurer la version de requête enregistrée précédente après la comparaison, cliquez sur Restaurer.
5. Cliquez sur Confirmer pour confirmer l'action.

Télécharger les requêtes enregistrées

Pour télécharger une requête enregistrée, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Cliquez sur le nom d'une requête enregistrée classique pour l'ouvrir.

3. Cliquez sur Download (Télécharger).

Supprimer les requêtes enregistrées

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

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet et le dossier Requêtes et, si nécessaire, le dossier Requêtes partagées. Recherchez la requête enregistrée que vous souhaitez supprimer.

3. Cliquez sur Afficher les actions à côté de la requête enregistrée, puis sur Supprimer.

4. Pour confirmer la suppression, saisissez delete dans la boîte de dialogue.

5. Cliquez sur Supprimer.

Requêtes enregistrées classiques

Obsolète : Les requêtes enregistrées, disponibles dans la version preview de BigQuery Studio, remplaceront complètement les requêtes enregistrées classiques d'ici mars 2025. Pour en savoir plus, consultez la page Abandon des requêtes enregistrées classiques. Pour savoir comment migrer vers des requêtes enregistrées, consultez la page Migrer des requêtes enregistrées classiques.

Consultez les sections suivantes pour apprendre à gérer les requêtes enregistrées classiques.

Remarque : Si vous n'avez pas activé BigQuery Studio, les requêtes enregistrées classiques apparaissent dans la section Requêtes enregistrées (NUMBER) du volet Explorateur et non pas dans le dossier Requêtes(classiques).

Partager des requêtes enregistrées classiques

Vous pouvez partager les requêtes enregistrées classiques auxquelles vous avez accordé une visibilité au niveau du projet ou publique. La visibilité au niveau du projet permet aux comptes principaux disposant des autorisations requises d'afficher, de mettre à jour ou de supprimer la requête. La visibilité publique permet à tout utilisateur disposant du lien de la requête de l'afficher, mais pas de la mettre à jour ni de la supprimer.

Vous partagez une requête enregistrée classique avec d'autres utilisateurs en générant un lien vers la requête enregistrée classique et en le partageant.

Pour exécuter une requête partagée classique, les utilisateurs doivent avoir accès aux données auxquelles la requête accède. Pour en savoir plus, consultez la section Accorder l'accès à un ensemble de données.

Si vous prévoyez de partager une requête enregistrée classique, envisagez d'y inclure un commentaire décrivant son objectif.

1. Dans le volet Explorateur, développez votre projet et le dossier Requêtes (classiques), puis recherchez la requête enregistrée classique que vous souhaitez partager.
2. Cliquez sur Afficher les actions à côté de la requête, puis sur Obtenir le lien.
3. Partagez le lien avec les utilisateurs auxquels vous souhaitez accorder l'accès à la requête.

Migrer des requêtes enregistrées classiques

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet, le dossier Requêtes (classiques) et, si nécessaire, le dossier Requêtes du projet.

3. Cliquez sur le nom d'une requête enregistrée classique pour l'ouvrir.

4. Cliquez sur Enregistrer la requête (classique) > Enregistrer la requête sous...

5. Dans la boîte de dialogue Enregistrer la requête, saisissez un nom et choisissez l'emplacement de la requête.

6. Cliquez sur Enregistrer.

Supprimer des requêtes enregistrées classiques

1. Dans la console Google Cloud, accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet Explorateur, développez votre projet, le dossier Requêtes (classiques) et, si nécessaire, le dossier Requêtes du projet.

3. Recherchez la requête enregistrée classique que vous souhaitez supprimer.

4. Cliquez sur Afficher les actions à côté de la requête, puis sur Supprimer.

5. Pour confirmer la suppression, saisissez delete dans la boîte de dialogue.

6. Cliquez sur Supprimer.