PROJECT_OPTIONS_CHANGES ビュー

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

必要な権限

構成を取得するには、プロジェクト レベルで bigquery.config.update Identity and Access Management(IAM)権限が必要です。事前定義された IAM ロールの roles/bigquery.admin には、ビューの作成に必要な権限が含まれています。

BigQuery のきめ細かい権限の詳細については、ロールと権限をご覧ください。

スキーマ

INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES ビューにクエリを実行すると、クエリ結果としてプロジェクトの構成の変更ごとに 1 行が表示されます。

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

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

データの保持

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

スコープと構文

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

ビュー名 リソース スコープ リージョン スコープ
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES 指定したプロジェクト内の構成の変更。 REGION

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

次の例では、INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES ビューからすべての列を取得しています。

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

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

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