Il est possible qu'une partie ou l'ensemble des informations de cette page ne s'appliquent pas au Cloud de confiance S3NS. Pour en savoir plus, consultez Différences par rapport à Google Cloud.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Présentation des requêtes enregistrées

Les requêtes enregistrées vous permettent de créer, de gérer et de partager des scripts SQL dans BigQuery. Les modifications apportées à une requête enregistrée sont automatiquement enregistrées afin que vous ne perdiez pas votre travail lorsque vous fermez l'éditeur de requête. Les fonctionnalités de requête enregistrées ne sont disponibles que dans la console Cloud de Confiance .

À propos des requêtes enregistrées

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.

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 et Considérations de sécurité pour les requêtes enregistrées.

Régions où le service est disponible

Toutes les requêtes enregistrées sont stockées dans une région par défaut. La mise à jour de la région par défaut modifie l'emplacement de toutes les requêtes créées par la suite. 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`	Faibles émissions de CO₂
	Iowa	`us-central1`	Faibles émissions de CO₂
	Los Angeles	`us-west2`
	Las Vegas	`us-west4`
	Montréal	`northamerica-northeast1`	Faibles émissions de CO₂
	Virginie du Virginie	`us-east4`
	Oregon	`us-west1`	Faibles émissions de CO₂
	São Paulo	`southamerica-east1`	Faibles émissions de CO₂
	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`	Faibles émissions de CO₂
	Finlande	`europe-north1`	Faibles émissions de CO₂
	Francfort	`europe-west3`
	Londres	`europe-west2`	Faibles émissions de CO₂
	Madrid	`europe-southwest1`	Faibles émissions de CO₂
	Milan	`europe-west8`	Faibles émissions de CO₂
	Pays-Bas	`europe-west4`	Faibles émissions de CO₂
	Turin	`europe-west12`	Faibles émissions de CO₂
	Varsovie	`europe-central2`	Faibles émissions de CO₂
	Zurich	`europe-west6`	Faibles émissions de CO₂
Moyen-Orient
	Dammam	`me-central2`
	Doha	`me-central1`
	Tel-Aviv	`me-west1`

Quotas et limites

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

Limites

Les requêtes enregistrées sont soumises aux limites suivantes :

Vous ne pouvez accorder l'accès public aux requêtes enregistrées qu'au compte principal allAuthenticatedUsers. Vous ne pouvez pas accorder l'accès aux requêtes enregistrées au compte principal allUsers.
Si votre projet Cloud de Confiance contient plus de 2 500 requêtes enregistrées classiques, vous ne pouvez pas utiliser la migration par lot pour migrer des requêtes enregistrées classiques vers des requêtes enregistrées.

Requêtes enregistrées classiques (obsolètes)

Pour modifier des requêtes enregistrées classiques existantes après leur abandon complet, vous devez les migrer vers BigQuery Studio.

Les requêtes enregistrées classiques sont une ancienne méthode d'enregistrement et de partage de requêtes SQL. Contrairement aux requêtes enregistrées BigQuery Studio, elles ne conservent que le texte de la requête et la version SQL (ancien SQL ou GoogleSQL).

Dans la console Cloud de Confiance , elles s'affichent dans le dossier Requêtes(classiques) du volet Explorateur. (Si vous n'avez pas activé BigQuery Studio, elles s'affichent dans le dossier Requêtes enregistrées (NUMBER) du volet Explorateur classique).

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

Personnel () : visible uniquement par l'utilisateur qui l'a créé.
- Remarque : Si une requête personnelle contient des informations sensibles, vous devez la supprimer ou retirer les données sensibles avant la migration.
Au niveau du projet () : visible par tout compte principal disposant des autorisations requises.
Public () : visible par toute personne disposant du lien vers la requête.

Rôles IAM pour la migration et l'accès

Les rôles IAM BigQuery prédéfinis suivants incluent les autorisations Dataform requises pour vous aider à passer aux requêtes enregistrées BigQuery Studio :

Administrateur BigQuery (roles/bigquery.admin) inclut les autorisations roles/dataform.admin.
Utilisateur de job BigQuery (roles/bigquery.jobUser) et Utilisateur BigQuery (roles/bigquery.user) incluent :
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list

Si vous ne disposez pas de l'un de ces rôles prédéfinis, demandez les autorisations requises. Les rôles personnalisés ne sont pas mis à jour automatiquement et doivent être modifiés manuellement.

Étapes suivantes

Consultez la section Créer des requêtes enregistrées pour apprendre à créer des requêtes enregistrées.
Pour savoir comment gérer les requêtes enregistrées, consultez Gérer les requêtes enregistrées.