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.
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é.
Dans la console Google Cloud, accédez à la page BigQuery.
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.
Cliquez sur > Gérer les autorisations.
Afficher les actions à côté de la requête enregistrée, puis sur PartagerDans le volet Gérer les autorisations, cliquez sur Ajouter un utilisateur/groupe.
Dans le champ Nouveaux comptes principaux, saisissez un compte principal.
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.
Facultatif : Pour afficher la liste complète des rôles et des paramètres de partage avancés, cliquez sur Partage avancé.
Cliquez sur Enregistrer.
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.
Dans la console Google Cloud, accédez à la page BigQuery.
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.
Cliquez sur > Copier le lien.
Afficher les actions à côté de la requête, puis sur PartagerPartagez 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 :
Dans la console Google Cloud, accédez à la page BigQuery.
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 :
Dans la console Google Cloud, accédez à la page BigQuery.
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.
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 :
Dans la console Google Cloud, accédez à la page BigQuery.
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é.
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 :
Dans la console Google Cloud, accédez à la page BigQuery.
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.
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.(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é
- 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.
- Sélectionnez le volet Activité.
- Cliquez sur Afficher les actions à côté de la version de la requête enregistrée que vous souhaitez restaurer, puis sur Restaurer.
- Cliquez sur Confirmer pour confirmer l'action.
Volet Comparaison
- 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.
- Sélectionnez le volet 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 dernière version de la requête enregistrée.
- Si vous souhaitez restaurer la version de requête enregistrée précédente après la comparaison, cliquez sur Restaurer.
- 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 :
Dans la console Google Cloud, accédez à la page BigQuery.
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.
Cliquez sur Download (Télécharger).
Supprimer les requêtes enregistrées
Pour supprimer une requête enregistrée, procédez comme suit :
Dans la console Google Cloud, accédez à la page BigQuery.
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.
Cliquez sur
Afficher les actions à côté de la requête enregistrée, puis sur Supprimer.Pour confirmer la suppression, saisissez
delete
dans la boîte de dialogue.Cliquez sur Supprimer.
Requêtes enregistrées classiques
Consultez les sections suivantes pour apprendre à gérer les requêtes enregistrées 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.
- 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.
- Cliquez sur Afficher les actions à côté de la requête, puis sur Obtenir le lien.
- Partagez le lien avec les utilisateurs auxquels vous souhaitez accorder l'accès à la requête.
Migrer des requêtes enregistrées classiques
Dans la console Google Cloud, accédez à la page BigQuery.
Dans le volet Explorateur, développez votre projet, le dossier Requêtes (classiques) et, si nécessaire, le dossier Requêtes du projet.
Cliquez sur le nom d'une requête enregistrée classique pour l'ouvrir.
Cliquez sur Enregistrer la requête (classique) > Enregistrer la requête sous...
Dans la boîte de dialogue Enregistrer la requête, saisissez un nom et choisissez l'emplacement de la requête.
Cliquez sur Enregistrer.
Supprimer des requêtes enregistrées classiques
Dans la console Google Cloud, accédez à la page BigQuery.
Dans le volet Explorateur, développez votre projet, le dossier Requêtes (classiques) et, si nécessaire, le dossier Requêtes du projet.
Recherchez la requête enregistrée classique que vous souhaitez supprimer.
Cliquez sur
Afficher les actions à côté de la requête, puis sur Supprimer.Pour confirmer la suppression, saisissez
delete
dans la boîte de dialogue.Cliquez sur Supprimer.