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 section Gérer les accès.

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 :

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}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+