Vue PROJECT_OPTIONS_CHANGES

Vous pouvez récupérer les métadonnées en temps réel sur les modifications liées à la configuration BigQuery d'un projet en interrogeant la vue INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES. Cette vue reflète les modifications liées à la configuration au niveau du projet apportées après le 31 janvier 2024.

Autorisations requises

Pour obtenir la configuration, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.config.update au niveau du projet. Le rôle IAM prédéfini roles/bigquery.admin inclut les autorisations dont vous avez besoin pour créer une configuration.

Pour plus d'informations sur les autorisations BigQuery précises, consultez la section Rôles et autorisations.

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES, les résultats de la requête contiennent une ligne pour chaque modification de configuration d'un projet.

La vue INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES présente le schéma suivant :

Nom de la colonne	Type de données	Valeur
`update_time`	`TIMESTAMP`	Heure à laquelle la modification de la configuration s'est produite.
`username`	`STRING`	Pour les utilisateurs propriétaires, il s'agit de leur adresse e-mail. Pour les utilisateurs tiers, il s'agit du nom que les utilisateurs ont défini dans le fournisseur d'identité tiers.
`updated_options`	`JSON`	Objet JSON des options de configuration mises à jour par les utilisateurs au sein de la modification, contenant les valeurs précédentes et les nouvelles valeurs des champs mis à jour.
`project_id`	`STRING`	ID du projet. Ce champ est vide pour les modifications de configuration au niveau de l'organisation.
`project_number`	`INTEGER`	Numéro du projet. Ce champ est vide pour les modifications de configuration au niveau de l'organisation.

Conservation des données

Cette vue contient les sessions en cours d'exécution et l'historique des sessions terminées au cours des 180 derniers jours.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région.

Nom de la vue	Champ d'application de la ressource	Champ d'application de la région
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES	Modifications de configuration dans le projet spécifié.	`REGION`

Remplacez les éléments suivants :

REGION : tout nom de région d'ensemble de données. Par exemple, US ou us-west2.

Exemples

L'exemple suivant récupère toutes les colonnes de la vue INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;

Le résultat ressemble à ce qui suit :

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {"default_query_job_timeout_ms":{"new":0,"old":1860369},"default_time_zone":{"new":"America/New_York","old":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+