ROUTINE_OPTIONS 檢視表

INFORMATION_SCHEMA.ROUTINE_OPTIONS 檢視畫面中，每個資料集中的每個處理常式都會有一個選項資料列。

所需權限

如要查詢 INFORMATION_SCHEMA.ROUTINE_OPTIONS 檢視畫面，您必須具備下列身分與存取權管理 (IAM) 權限：

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

以下每個預先定義的 IAM 角色都包含取得例行中繼資料所需的權限：

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

如要進一步瞭解 BigQuery 權限，請參閱「使用身分與存取權管理功能控管存取權」。

結構定義

查詢 INFORMATION_SCHEMA.ROUTINE_OPTIONS 檢視表時，資料集中每個處理常式的每個選項在查詢結果都會有一個資料列。

INFORMATION_SCHEMA.ROUTINE_OPTIONS 檢視表具有下列結構定義：

資料欄名稱 資料類型 值
SPECIFIC_CATALOG STRING 包含定義選項之處理常式的專案名稱
SPECIFIC_SCHEMA STRING 包含定義選項之處理常式的資料集名稱
SPECIFIC_NAME STRING 處理常式的名稱
OPTION_NAME STRING 選項表格中的其中一個名稱值
OPTION_TYPE STRING 選項表格中的其中一個資料類型值
OPTION_VALUE STRING 選項表格中的其中一個值選項
選項表格
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"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+