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 このプロジェクトのデフォルト クエリ タイムアウト（ミリ秒）。
default_interactive_query_queue_timeout_ms STRING このプロジェクトのキューに追加されたインタラクティブ クエリのデフォルトのタイムアウト（ミリ秒単位）。
default_batch_query_queue_timeout_ms STRING このプロジェクトのキューに追加されたバッチクエリのデフォルトのタイムアウト（ミリ秒単位）。

データの保持

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

スコープと構文

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

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

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

例

次の例では、OPTION_NAME 列、OPTION_TYPE 列、OPTION_VALUE 列を INFORMATION_SCHEMA.PROJECT_OPTIONS ビューから取得します。

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

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

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+