ORGANIZATION_OPTIONS ビュー

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS ビューをクエリすると、BigQuery 組織オプションに関するリアルタイムのメタデータを取得できます。このビューには、組織レベルのデフォルト設定が含まれています。

必要な権限

組織オプションのメタデータを取得するには、以下の Identity and Access Management（IAM）権限が必要です。

bigquery.config.get

以下の IAM 事前定義ロールには、組織オプションのメタデータを取得するために必要な権限が含まれています。

roles/bigquery.jobUser

BigQuery のきめ細かい権限の詳細については、ロールと権限をご覧ください。

スキーマ

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS ビューにクエリを実行すると、クエリ結果として組織内の各構成ごとに 1 行が表示されます。

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS ビューのスキーマは次のとおりです。

列名	データ型	値
`OPTION_NAME`	`STRING`	オプションテーブル内の名前値の 1 つ。
`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.ORGANIZATION_OPTIONS	指定した組織内の構成オプション。	`REGION`

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

REGION: 任意のデータセットリージョン名。例: region-us

例

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

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_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             |
  +--------------------------------------------+-------------+---------------------+