Présentation des requêtes enregistrées

Ce document présente les requêtes enregistrées et les requêtes enregistrées classiques dans BigQuery.

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 requêtes enregistrées améliorent la collaboration et la gestion des requêtes avec les options suivantes :

  • Partager des requêtes avec des utilisateurs et des groupes spécifiques à l'aide de la gestion de l'authentification et des accès (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 enregistrent à la fois le texte de la requête et ses paramètres.

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ées 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 la section Accorder l'accès aux 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 icône feuille Faibles émissions de CO2
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. Pour en savoir plus, consultez la section Accorder l'accès aux requêtes enregistrées.

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'en 2025.

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

Abandon des requêtes enregistrées classiques

D'ici mars 2025, la fonctionnalité de requêtes enregistrées de la BigQuery Studio remplacera les requêtes enregistrées classiques. Pour modifier des requêtes enregistrées classiques existantes après 2024, 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 requêtes ou supprimer les informations associées d'ici mars 2025.

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