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。指定しない場合は、デフォルトのプロジェクトが使用されます。

    -- 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"] |
    +-------------------+------------------+---------------+----------------------+---------------+------------------+