Vue ORGANIZATION_OPTIONS_CHANGES

Vous pouvez récupérer les métadonnées en temps réel des modifications de configuration BigQuery dans une organisation en interrogeant la vue INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES. Cette vue reflète les modifications de configuration au niveau de l'organisation et du projet apportées après le 31 janvier 2024.

Autorisations requises

Pour obtenir l'autorisation dont vous avez besoin pour obtenir les modifications de configuration, demandez à votre administrateur de vous accorder le rôle IAM Administrateur BigQuery (roles/bigquery.admin) sur votre organisation. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation bigquery.config.update, qui est nécessaire pour obtenir les modifications de configuration.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES, les résultats de la requête contiennent une ligne pour chaque changement de configuration d'une organisation.

La vue INFORMATION_SCHEMA.ORGANIZATION_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.ORGANIZATION_OPTIONS_CHANGES	Modifications de configuration au sein de l'organisation spécifiée.	`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 modifications de l'option default_query_job_timeout_ms option :

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;

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_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+