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