管理日常安排
在 BigQuery 中管理常式，即可在資料倉儲中整理、維護及重複使用自訂邏輯。瞭解如何建立、查看及刪除這些資源，可讓您有效管理預存程序、使用者定義函式 (UDF) 和資料表函式。
權限
如要在 SQL 查詢中參照常式，您必須具備 bigquery.routines.get 權限。如要授予日常安排的存取權，您可以對資料集或個別日常安排，授予具備 bigquery.routines.get 權限的 IAM 角色。在資料集層級授予存取權，可讓主體存取資料集中的所有常式。詳情請參閱「使用 IAM 控管資源存取權」。
根據預設，您也必須具備常式參照的任何資源 (例如資料表或檢視表) 的存取權限。如果是 UDF 和資料表函式，您可以授權函式代表呼叫端存取這些資源。詳情請參閱「授權函式」。
建立處理常式
如要建立常式，您必須具備 bigquery.routines.create 權限。
SQL
根據常式類型，執行下列其中一個 DDL 陳述式：
API
使用定義的 Routine 資源呼叫 routines.insert 方法。
列出處理常式
如要列出資料集中的常式，您必須具備 bigquery.routines.get 和 bigquery.routines.list 權限。
控制台
在 Google Cloud 控制台開啟「BigQuery」頁面。
點選左側窗格中的 「Explorer」。
如果沒有看到左側窗格，請按一下 「Expand left pane」(展開左側窗格)，開啟窗格。
在「Explorer」窗格中展開專案，點選「Datasets」(資料集)，然後選取資料集。
按一下「日常安排」分頁標籤。
SQL
查詢 INFORMATION_SCHEMA.ROUTINES 檢視表：
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式：
SELECT COLUMN_LIST FROM { DATASET | REGION }.INFORMATION_SCHEMA.ROUTINES;
按一下「 執行」。
如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。
更改下列內容：
- COLUMN_LIST：
INFORMATION_SCHEMA.ROUTINES檢視表中以半形逗號分隔的資料欄清單。 - DATASET：專案中的資料集名稱。
- REGION：區域限定詞。
範例：
SELECT routine_name, routine_type, routine_body FROM mydataset.INFORMATION_SCHEMA.ROUTINES;
+------------------+----------------+--------------+
| routine_name | routine_type | routine_body |
+------------------+----------------+--------------+
| AddFourAndDivide | FUNCTION | SQL |
| create_customer | PROCEDURE | SQL |
| names_by_year | TABLE FUNCTION | SQL |
+------------------+----------------+--------------+
bq
使用 bq ls 指令，並加上 --routines 旗標：
bq ls --routines DATASET
更改下列內容：
- DATASET：專案中的資料集名稱。
範例：
bq ls --routines mydataset
Id Routine Type Language Creation Time Last Modified Time
------------------ ----------------------- ---------- ----------------- --------------------
AddFourAndDivide SCALAR_FUNCTION SQL 05 May 01:12:03 05 May 01:12:03
create_customer PROCEDURE SQL 21 Apr 19:55:51 21 Apr 19:55:51
names_by_year TABLE_VALUED_FUNCTION SQL 01 Sep 22:59:17 01 Sep 22:59:17
API
使用資料集 ID 呼叫 routines.list 方法。
查看日常安排的主體
如要查看常式的內文，您必須具備 bigquery.routines.get 權限。
控制台
在 Google Cloud 控制台開啟「BigQuery」頁面。
點選左側窗格中的 「Explorer」。
在「Explorer」窗格中展開專案，點選「Datasets」(資料集)，然後選取資料集。
按一下「日常安排」分頁標籤。
選取日常安排。常式的內文會列在「Routine query」(常式查詢) 下方。
SQL
選取 INFORMATION_SCHEMA.ROUTINES 檢視表的 routine_definition 欄：
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式：
SELECT routine_definition FROM { DATASET | REGION }.INFORMATION_SCHEMA.ROUTINES WHERE routine_name = ROUTINE_NAME;
按一下「 執行」。
如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。
更改下列內容：
- DATASET：專案中的資料集名稱。
- REGION：區域限定詞。
- ROUTINE_NAME：日常安排的名稱。
範例：
SELECT routine_definition FROM mydataset.INFORMATION_SCHEMA.ROUTINES WHERE routine_name = 'AddFourAndDivide';
+--------------------+
| routine_definition |
+--------------------+
| (x + 4) / y |
+--------------------+
bq
使用 bq show 指令，並加上 --routine 旗標：
bq show --routine DATASET.ROUTINE_NAME
更改下列內容：
- DATASET：專案中的資料集名稱。
- ROUTINE_NAME：日常安排的名稱。
範例：
bq show --routine mydataset.AddFourAndDivide
Id Routine Type Language Signature Definition Creation Time Last Modified Time
------------------ ----------------- ---------- ------------------------------- ------------- ----------------- --------------------
AddFourAndDivide SCALAR_FUNCTION SQL (x INT64, y INT64) -> FLOAT64 (x + 4) / y 05 May 01:12:03 05 May 01:12:03
API
呼叫 routines.get 方法，並提供資料集 ID 和常式名稱。常式的主體會在 Routine 物件中傳回。
刪除處理常式
如要刪除日常安排，您必須具備 bigquery.routines.delete 權限。
控制台
在 Google Cloud 控制台開啟「BigQuery」頁面。
點選左側窗格中的 「Explorer」。
在「Explorer」窗格中展開專案，點選「Datasets」(資料集)，然後選取資料集。
按一下「日常安排」分頁標籤。
選取日常安排。
在詳細資料窗格中，按一下「Delete」(刪除)。
在對話方塊中輸入
"delete"，然後點選「刪除」確認操作。
SQL
根據常式類型，執行下列其中一個 DDL 陳述式：
範例：
DROP FUNCTION IF EXISTS mydataset.AddFourAndDivide
bq
使用 bq rm 指令，並加上 --routine 旗標：
bq rm --routine DATASET.ROUTINE_NAME
更改下列內容：
- DATASET：專案中的資料集名稱。
- ROUTINE_NAME：日常安排的名稱。
範例：
bq rm --routine mydataset.AddFourAndDivide
API
呼叫 routines.delete 方法，並提供資料集 ID 和常式名稱。