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

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

次の例では、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             |
  +---------------------------------+---------------+----------------------+