ROUTINE_OPTIONS ビュー

INFORMATION_SCHEMA.ROUTINE_OPTIONS ビューには、データセット内の各ルーティンのオプションごとに 1 行が表示されます。

必要な権限

INFORMATION_SCHEMA.ROUTINE_OPTIONS ビューをクエリするには、次の Identity and Access Management（IAM）権限が必要です。

  • bigquery.routines.get
  • bigquery.routines.list

次の IAM 事前定義ロールには、ルーティン メタデータを取得するために必要な権限が含まれています。

  • roles/bigquery.admin
  • roles/bigquery.metadataViewer
  • roles/bigquery.dataViewer

BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。

スキーマ

INFORMATION_SCHEMA.ROUTINE_OPTIONS ビューにクエリを実行すると、クエリの結果として、データセット内の各ルーティンのオプションごとに 1 行が表示されます。

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

列名 データ型 値
SPECIFIC_CATALOG STRING オプションが定義されているルーティンを含むプロジェクトの名前
SPECIFIC_SCHEMA STRING オプションが定義されているルーティンを含むデータセットの名前
SPECIFIC_NAME STRING ルーティンの名前
OPTION_NAME STRING オプション テーブル内の名前の値の 1 つ
OPTION_TYPE STRING オプション テーブルのデータ型の値の 1 つ
OPTION_VALUE STRING オプション テーブルの値オプションの 1 つ
オプション テーブル
OPTION_NAME OPTION_TYPE OPTION_VALUE
description STRING ルーティンの説明（定義されている場合）
library ARRAY ルーティン内で参照されているライブラリの名前JavaScript UDF にのみ適用されます
data_governance_type DataGovernanceType サポートされているデータ ガバナンス タイプの名前。例: DATA_MASKING

スコープと構文

このビューに対するクエリでは、データセット修飾子またはリージョン修飾子を指定する必要があります。詳細については、構文をご覧ください。次の表に、このビューのリージョン スコープとリソース スコープを示します。

ビュー名 リソース スコープ リージョン スコープ
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS プロジェクト レベル REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS データセット レベル データセットのロケーション
次のように置き換えます。
  • 省略可: PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
  • REGION: 任意のデータセット リージョン名。例: `region-us`
  • DATASET_ID: データセットの ID。詳しくは、データセット修飾子をご覧ください。

例

-- Returns metadata for routines in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

-- Returns metadata for routines in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

例

例 1:

次の例では、INFORMATION_SCHEMA.ROUTINE_OPTIONS ビューにクエリを実行して、デフォルト プロジェクト（myproject）にある mydataset の全ルーティンのルーティン オプションを取得します。

SELECT
  *
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

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

+-------------------+------------------+---------------+----------------------+---------------+------------------+
| specific_catalog  | specific_schema  | specific_name |     option_name      | option_type   | option_value     |
+-------------------+------------------+---------------+----------------------+---------------+------------------+
| myproject         | mydataset        | myroutine1    | description          | STRING        | "a description"  |
| myproject         | mydataset        | myroutine2    | library              | ARRAY<STRING> | ["a.js", "b.js"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+