Présentation des requêtes enregistrées

Ce document présente les requêtes enregistrées dans BigQuery. Vous pouvez utiliser des requêtes enregistrées pour créer et gérer des scripts SQL. Les modifications apportées à une requête enregistrée sont automatiquement enregistrées. Vous ne perdez donc pas votre travail lorsque vous fermez l'éditeur de requêtes. Les requêtes enregistrées améliorent la collaboration et la gestion des requêtes avec les options suivantes :

  • Partager des requêtes enregistrées avec des utilisateurs et des groupes spécifiques à l'aide d'Identity and Access Management (IAM).
  • Examiner l'historique des versions de requête.
  • Rétablir ou utiliser une branche précédente de requête.

Les requêtes enregistrées sont des éléments de code BigQuery Studio fournis par Dataform. Les Notebooks sont également des éléments de code. Tous les éléments de code sont stockés dans une région par défaut. La mise à jour de la région par défaut modifie la région pour tous les éléments de code créés par la suite.

Les fonctionnalités de requête enregistrée ne sont disponibles que dans la console Google Cloud .

Sécurité des requêtes enregistrées

Vous contrôlez l'accès aux requêtes enregistrées à l'aide de rôles Identity and Access Management (IAM). Pour en savoir plus, consultez Partager des requêtes enregistrées.

Régions où le service est disponible

BigQuery Studio vous permet d'enregistrer, de partager et de gérer des requêtes enregistrées. Le tableau suivant liste les régions dans lesquelles BigQuery Studio est disponible :

Description de la région Nom de la région Détails
Afrique
Johannesburg africa-south1
Amériques
Columbus us-east5
Dallas us-south1 Icône Feuille Faibles émissions de CO2
Iowa us-central1 Icône Feuille Faibles émissions de CO2
Los Angeles us-west2
Las Vegas us-west4
Montréal northamerica-northeast1 Icône Feuille Faibles émissions de CO2
Virginie du Virginie us-east4
Oregon us-west1 Icône Feuille Faibles émissions de CO2
São Paulo southamerica-east1 Icône Feuille Faibles émissions de CO2
Caroline du Sud us-east1
Asie-Pacifique
Hong Kong asia-east2
Jakarta asia-southeast2
Mumbai asia-south1
Séoul asia-northeast3
Singapour asia-southeast1
Sydney australia-southeast1
Taïwan asia-east1
Tokyo asia-northeast1
Europe
Belgique europe-west1 Icône Feuille Faibles émissions de CO2
Francfort europe-west3
Londres europe-west2 icône feuille Faibles émissions de CO2
Madrid europe-southwest1 Icône Feuille Faibles émissions de CO2
Pays-Bas europe-west4 Icône Feuille Faibles émissions de CO2
Turin europe-west12
Zurich europe-west6 Icône Feuille Faibles émissions de CO2
Moyen-Orient
Doha me-central1
Dammam me-central2

Quotas et limites

Pour en savoir plus, consultez la page Quotas et limites des requêtes enregistrées.

Limites

Les requêtes enregistrées présentent les limites suivantes :

Requêtes enregistrées classiques

Les requêtes enregistrées classiques sont un ancien moyen d'enregistrer et de partager des requêtes SQL. Les requêtes enregistrées classiques fournissent le texte de la requête, mais le seul paramètre de requête conservé par une requête enregistrée classique est la version SQL. Ce paramètre détermine si la requête utilise l'ancien SQL ou GoogleSQL. Pour interroger des données, les utilisateurs doivent avoir accès aux données auxquelles la requête enregistrée accède.

Vous pouvez afficher les requêtes enregistrées classiques dans le dossier Requêtes(classiques) du volet Explorateur :

Dossier "Requêtes (classiques)" dans le volet "Explorateur".

Trois types de visibilité sont disponibles pour les requêtes enregistrées classiques :

  • Personnel. Les requêtes enregistrées classiques privées ne sont visibles que par l'utilisateur qui les a créées. Elles sont identifiées par l'icône .
  • Niveau Projet : les requêtes enregistrées au niveau du projet sont visibles par les comptes principaux disposant des autorisations requises. Elles sont identifiées par l'icône .
  • Public. Les requêtes enregistrées classiques publiques sont visibles par toute personne disposant du lien vers la requête. Elles sont identifiées par l'icône .

Vous pouvez migrer des requêtes enregistrées classiques vers des requêtes enregistrées pour profiter des nouvelles fonctionnalités, ou continuer à les conserver en tant que requêtes enregistrées classiques jusqu'à leur abandon. Le calendrier d'abandon est en cours d'examen.

La fonctionnalité de requête enregistrée classique n'est disponible que dans la consoleGoogle Cloud .

Abandon des requêtes enregistrées classiques

La fonctionnalité de requêtes enregistrées de BigQuery Studio remplacera les requêtes enregistrées classiques. Le calendrier d'abandon est en cours d'examen. Pour modifier des requêtes enregistrées classiques existantes après leur abandon, vous devez migrer les requêtes classiques vers des requêtes enregistrées BigQuery Studio.

Si les utilisateurs, y compris vous-même, ont des requêtes personnelles avec des informations qui ne doivent pas être accessibles aux autres utilisateurs ayant accès aux données du projet, le propriétaire de ces requêtes doit les supprimer ou supprimer les informations associées avant de terminer la migration.

Pour permettre cette transition, les rôles IAM BigQuery suivants ont été mis à jour en février 2024 :

Pour permettre aux utilisateurs ne disposant pas du rôle d'administrateur BigQuery, d'utilisateur de job BigQuery ou d'utilisateur BigQuery d'utiliser des requêtes enregistrées, accordez-leur les autorisations requises dans IAM.

Les rôles personnalisés ne seront pas mis à jour automatiquement. Pour mettre à jour un rôle personnalisé avec les autorisations requises, consultez la page Modifier un rôle personnalisé existant.

Étape suivante