ORGANIZATION_OPTIONS_CHANGES ビュー

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES ビューをクエリすると、組織内の BigQuery 構成の変更に関するリアルタイムのメタデータを取得できます。このビューには、2024 年 1 月 31 日以降に行われた組織レベルとプロジェクト レベルの構成変更が反映されます。

必要な権限

構成の変更に必要な権限を取得するには、組織に対する BigQuery 管理者 roles/bigquery.admin)IAM ロールの付与を管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。

この事前定義ロールには、構成の変更を取得するために必要な bigquery.config.update 権限が含まれています。

カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。

スキーマ

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES ビューをクエリすると、クエリ結果として組織内の各構成ごとに 1 行が表示されます。

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES ビューのスキーマは次のとおりです。

列名 データ型
update_time TIMESTAMP 構成の変更が発生した時刻。
username STRING ファーストパーティ ユーザーの場合は、ユーザーのメールアドレスになります。サードパーティ ユーザーの場合は、ユーザーがサードパーティの ID プロバイダで設定した名前になります。
updated_options JSON 変更によりユーザーが更新された構成オプションの JSON オブジェクト。更新されたフィールドの以前の値と新しい値が含まれます。
project_id STRING プロジェクト ID。組織レベルの構成変更の場合、このフィールドは空です。
project_number INTEGER プロジェクト番号。組織レベルの構成変更の場合、このフィールドは空です。

データの保持

このビューには、実行中のセッションと、過去 180 日間に完了したセッションの履歴が含まれます。

スコープと構文

このビューに対するクエリでは、リージョン修飾子を指定する必要があります。

ビュー名 リソース スコープ リージョン スコープ
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 指定した組織内の構成の変更。 REGION

次のように置き換えます。

次の例では、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;

次のような結果になります。

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