EFFECTIVE_PROJECT_OPTIONS ビュー
INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS ビューにクエリを実行すると、BigQuery の効果的なプロジェクト オプションに関するリアルタイムのメタデータを取得できます。このビューには、組織レベルまたはプロジェクト レベルのデフォルト設定が含まれています。
必要な権限
有効なプロジェクト オプションのメタデータを取得するには、bigquery.config.get Identity and Access Management（IAM）権限が必要です。
次の IAM 事前定義ロールには、有効なプロジェクト オプション メタデータを取得するために必要な権限が含まれています。
roles/bigquery.jobUser
BigQuery のきめ細かい権限の詳細については、ロールと権限をご覧ください。
スキーマ
INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS ビューにクエリを実行すると、クエリ結果としてプロジェクトの構成ごとに 1 行が表示されます。
INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS ビューのスキーマは次のとおりです。
| 列名 | データ型 | 値 |
|---|---|---|
OPTION_NAME |
STRING |
指定した構成設定のオプション ID。 |
OPTION_DESCRIPTION |
STRING |
オプションの説明。 |
OPTION_TYPE |
STRING |
OPTION_VALUE のデータ型。 |
OPTION_SET_LEVEL |
STRING |
設定が定義されている階層内のレベル（有効な値は DEFAULT、ORGANIZATION、または PROJECTS）。
|
OPTION_SET_ON_ID |
STRING |
OPTION_SET_LEVEL の値に基づいて値を設定:
|
OPTION_VALUE |
STRING |
オプションの現在の値。 |
オプション テーブル
OPTION_NAME |
OPTION_TYPE |
OPTION_VALUE |
|---|---|---|
default_time_zone |
STRING |
このプロジェクトで有効なデフォルトのタイムゾーン。 |
default_kms_key_name |
STRING |
このプロジェクトの有効なデフォルトの鍵名。 |
default_query_job_timeout_ms |
INT64 |
このプロジェクトで有効なデフォルト クエリ タイムアウト（ミリ秒）。 |
default_interactive_query_queue_timeout_ms |
STRING |
このプロジェクトのキューに格納されたインタラクティブ クエリの有効なデフォルトのタイムアウト（ミリ秒単位）。 |
default_batch_query_queue_timeout_ms |
STRING |
このプロジェクトのキューに格納されたバッチ クエリの有効なデフォルトのタイムアウト（ミリ秒単位）。 |
データの保持
このビューには、現在実行中のセッションと、過去 180 日間に完了したセッションの履歴が含まれます。
スコープと構文
このビューに対するクエリでは、リージョン修飾子を指定する必要があります。
| ビュー名 | リソース スコープ | リージョン スコープ |
|---|---|---|
`region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS |
指定したプロジェクト内の構成オプション。 | REGION |
次のように置き換えます。
REGION: 任意のデータセット リージョン名。例:region-us
例
次の例では、OPTION_NAME 列、OPTION_TYPE 列、OPTION_VALUE 列、OPTION_SET_LEVEL 列、OPTION_SET_ON_ID 列を INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS ビューから取得します。
SELECT option_name, option_type, option_value, option_set_level, option_set_on_id FROM `region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;
次のような結果になります。
+--------------------------------------------+-------------+---------------------+------------------+--------------------+ | option_name | option_type | option_value | option_set_level | option_set_on_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_time_zone | STRING | America/Los_Angeles | organizations | my_organization_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_kms_key_name | STRING | test/testkey1 | projects | my_project_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_query_job_timeout_ms | INT64 | 18000000 | projects | my_project_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_interactive_query_queue_timeout_ms | INT64 | 600000 | organization | my_organization_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_batch_query_queue_timeout_ms | INT64 | 1200000 | projects | my_project_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+