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 |
次のように置き換えます。
REGION
: 任意のデータセット リージョン名。たとえば、US
や、us-west2
です。
例
次の例では、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}} | +----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+