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`

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

REGION: 任意のデータセットリージョン名。たとえば、US や us-west2 です。

例

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