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 設定が定義されている階層内のレベル(有効な値は DEFAULTORGANIZATION、または PROJECTS)。
OPTION_SET_ON_ID STRING OPTION_SET_LEVEL の値に基づいて値を設定:
  • DEFAULT の場合は、null に設定。
  • ORGANIZATION の場合は、"" に設定。
  • PROJECT の場合は、ID に設定。
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

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

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