排定筆記本執行時間
本文件說明如何排定 BigQuery 中的 Colab Enterprise 筆記本執行時間，以及檢查排定的筆記本執行作業。
筆記本是採用 Dataform 技術的程式碼資產。不過，Dataform 中不會顯示 Notebook。
您可以排定筆記本的執行時程，讓筆記本在指定的時間和頻率自動執行，例如訓練機器學習模型、呼叫外部 API 或執行 BigQuery DataFrames 程式碼。
你對筆記本所做的變更會自動儲存，但只有你和有權存取筆記本的使用者才能存取這些變更。如要使用新版本的筆記本更新排程，您必須部署筆記本。部署筆記本後，您就能使用目前的筆記本版本更新排程。排程會執行已部署的筆記本最新版本。
系統會使用您的 Google 帳戶使用者憑證或您在設定時間表時選取的 Dataform 服務帳戶，執行每個筆記本時間表。
Dataform 會將排定執行的 Notebook 輸出內容寫入建立排程時選取的 Cloud Storage 值區。
筆記本排程會使用標準 E2 執行階段。適用 Colab Enterprise 的執行階段費用。系統會根據 E2 機器類型收取執行階段處理作業費用。如要瞭解標準 E2 執行階段的定價，請參閱 Colab Enterprise 定價。
事前準備
開始之前，請先建立筆記本。
啟用筆記本排程功能
如要安排筆記本的執行時間，您必須將下列角色授予要用於筆記本時間表的服務帳戶：
- Notebook 執行緒使用者 (
roles/aiplatform.notebookExecutorUser) - 請按照「在專案中授予單一角色」的說明，為所選專案中的服務帳戶授予 Notebook 執行緒使用者角色。
- 儲存空間管理員 (
roles/storage.admin) - 請按照「將主體新增至值區層級政策」的說明，將服務帳戶新增為 Cloud Storage 值區的主體，以便用於儲存排定時間的筆記本執行作業輸出內容，並將「儲存空間管理員」角色授予此主體。
- 服務帳戶使用者 (
roles/iam.serviceAccountUser) - 請按照「為服務帳戶授予單一角色」中的步驟，將服務帳戶新增為自身的實體。換句話說，將服務帳戶新增為同一個服務帳戶的主體。接著，將服務帳戶使用者角色授予此使用者。
此外，您必須為預設 Dataform 服務帳戶授予下列角色：
- 服務帳戶憑證建立者 (
roles/iam.serviceAccountTokenCreator) - 請按照「將權杖建立存取權授予自訂 Dataform 服務帳戶」的步驟，將預設 Dataform 服務帳戶新增為服務帳戶的使用者，並將「服務帳戶憑證建立者」角色授予此使用者。
如要進一步瞭解 Dataform 中的服務帳戶，請參閱「關於 Dataform 中的服務帳戶」。
所需權限
您必須具備下列角色，才能建立筆記本時間表：
- Dataform 管理員 (
roles/dataform.admin) - BigQuery 讀取工作階段使用者 (
roles/bigquery.readSessionUser) 或 BigQuery Studio 使用者 (roles/bigquery.studioUser) - Notebook Runtime User (
roles/aiplatform.notebookRuntimeUser)
如要在安排筆記本時使用筆記本執行階段範本，您必須具備 Notebook Runtime User (roles/aiplatform.notebookRuntimeUser) 角色。
如要編輯及刪除筆記本時間表，您必須具備「資料表編輯者」(roles/dataform.editor)角色。
如要查看筆記本時間表，您必須具備 Dataform 檢視者 (roles/dataform.viewer) 角色。
如要進一步瞭解 BigQuery 身分與存取權管理，請參閱「使用身分與存取權管理功能控管存取權」。
建立排程
如要建立筆記本時間表，請按照下列步驟操作：
「Explorer」窗格
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中展開專案和「Notebooks」資料夾，並視需要展開「Shared notebooks」資料夾。按一下要排程的筆記本名稱。
點按「Schedule」(排程)。
在「排程筆記本」窗格中的「排程名稱」欄位中，輸入排程名稱。
在「Authentication」部分，使用 Google 帳戶使用者憑證或服務帳戶授權 Notebook。
- 如要使用 Google 帳戶使用者憑證 (預覽)，請選取「以我的使用者憑證執行」。
- 如要使用服務帳戶，請選取「以所選服務帳戶執行」，然後選取服務帳戶。
在「Notebook options」部分的「Runtime template」欄位中，選取 Colab 筆記本執行階段範本或預設的執行階段規格。如要進一步瞭解如何建立 Colab 筆記本執行階段範本，請參閱「建立執行階段範本」一文。
在「Cloud Storage bucket」(Cloud Storage 值區) 欄位中，按一下「Browse」(瀏覽)，然後選取或建立 Cloud Storage 值區。
所選服務帳戶必須獲得所選儲存空間值區的 Storage 管理員 (
roles/storage.admin) IAM 角色。詳情請參閱「啟用 Notebook 排程功能」。在「Schedule frequency」部分執行下列操作：
- 在「重複」選單中，選取已排定執行的筆記本執行頻率。
- 在「At time」(時間) 欄位中，輸入排程筆記本執行的時間。
- 在「時區」選單中，選取時間表適用的時區。
按一下「建立排程」。如果您選取「使用我的使用者憑證執行」做為驗證方法，則必須授權 Google 帳戶 (預先發布版)。
建立時間表時，系統會自動部署目前版本的筆記本。如要使用新版筆記本更新時間表，請部署筆記本。
最新的部署版本筆記本會在所選時間和頻率執行。
「排定時間」頁面
在 Google Cloud 控制台中，前往「Scheduling」頁面。
按一下「建立」，然後在選單中選取「Notebook 時間表」。
在「排程筆記本」窗格中的「筆記本」欄位中，選取要排程的筆記本。
在「排程名稱」欄位中，輸入排程名稱。
在「Authentication」部分，使用 Google 帳戶使用者憑證或服務帳戶授權 Notebook。
- 如要使用 Google 帳戶使用者憑證 (預覽)，請選取「以我的使用者憑證執行」。
- 如要使用服務帳戶，請選取「以所選服務帳戶執行」，然後選取服務帳戶。
在「Notebook options」部分的「Runtime template」欄位中，選取 Colab 筆記本執行階段範本或預設執行階段規格。如要進一步瞭解如何建立 Colab 筆記本執行階段範本，請參閱「建立執行階段範本」一文。
在「Cloud Storage bucket」(Cloud Storage 值區) 欄位中，按一下「Browse」(瀏覽)，然後選取或建立 Cloud Storage 值區。
所選服務帳戶必須獲得所選值區的 Storage 管理員 (
roles/storage.admin) IAM 角色。詳情請參閱「啟用 Notebook 排程功能」。在「Schedule frequency」部分執行下列操作：
- 在「重複」選單中，選取已排定執行的筆記本執行頻率。
- 在「At time」(時間) 欄位中，輸入排程筆記本執行的時間。
- 在「時區」選單中，選取時間表適用的時區。
按一下「建立排程」。如果您選取「使用我的使用者憑證執行」做為驗證方法，則必須授權 Google 帳戶 (預先發布版)。
建立時間表時，系統會自動部署目前版本的筆記本。如要使用新版筆記本更新時間表，請部署筆記本。
最新的部署版本筆記本會在所選時間和頻率執行。
授權給您的 Google 帳戶
如要使用 Google 帳戶使用者憑證驗證資源，您必須手動授予 BigQuery 管道權限，以便取得 Google 帳戶的存取金鑰，並代您存取來源資料。您可以透過 OAuth 對話方塊介面手動核准。
您只需要一次授予 BigQuery 管道權限。
如要撤銷已授予的權限，請按照下列步驟操作：
- 前往 Google 帳戶頁面。
- 按一下「BigQuery 管道」。
- 按一下 [移除存取權]。
如果新 Google 帳戶擁有者從未建立時間表，則透過更新憑證來變更筆記本時間表擁有者，也需要手動核准。
部署筆記本
部署筆記本時，系統會使用筆記本的目前版本更新排程。排程會執行已部署的筆記本最新版本。
如要部署筆記本，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中展開專案和「Notebooks」資料夾，並視需要展開「Shared notebooks」資料夾。按一下所選筆記本的名稱。
按一下 [Deploy] (部署)。
對應的時間表會更新為目前的 Notebook 版本。系統會在預定的時間執行最新的已部署筆記本版本。
手動執行已部署的筆記本
當您手動執行在所選排程中部署的筆記本時，BigQuery 會執行已部署的筆記本一次，不受排程影響。
如要手動執行已部署的筆記本，請按照下列步驟操作：
在 Google Cloud 控制台中，前往「Scheduling」頁面。
按一下所選筆記本排程的名稱。
在「排程詳細資料」頁面中，按一下「執行」。
查看所有時間表
如要查看專案中的所有筆記本時間表，請按照下列步驟操作：
在 Google Cloud 控制台中，前往「Scheduling」頁面。
選用：如要顯示含有筆記本時間表詳細資料的其他資料欄，請按一下 「資料欄顯示選項」，然後選取資料欄並按一下「確定」。
查看排程詳細資料
您可以在「Explorer」窗格或「Scheduling」頁面中，查看所選時程的詳細資料。
如要查看所選筆記本的排程詳細資料，請按照下列步驟操作：
「Explorer」窗格
前往 Google Cloud 控制台的「BigQuery」BigQuery頁面。
在「Explorer」窗格中展開專案和「Notebooks」資料夾，並視需要展開「Shared notebooks」資料夾。按一下所選筆記本的名稱。
按一下「查看時間表」。
「排定時間」頁面
在 Google Cloud 控制台中，前往「Scheduling」頁面。
按一下所選筆記本排程的名稱。
查看過往執行作業
您可以在「探索器」窗格或「排程」頁面中，查看所選筆記本排程的過去執行情形。
如要查看所選筆記本時間表的過去執行記錄，請按照下列步驟操作：
「Explorer」窗格
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中展開專案和「Notebooks」資料夾，並視需要展開「Shared notebooks」資料夾。按一下所選筆記本的名稱。
依序點選「查看時間表」和「查看過去執行作業」。
「排定時間」頁面
在 Google Cloud 控制台中，前往「Scheduling」頁面。
按一下所選筆記本排程的名稱。
在「排程詳細資料」頁面的「過去執行作業」部分中，檢查過去執行作業。
選用：如要重新整理過去執行作業的清單，請按一下「重新整理」。
停用排程
如要暫停所選筆記本的預定執行作業，但不刪除排程，您可以停用該排程。
如要停用所選筆記本的排程，請按照下列步驟操作：
「Explorer」窗格
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中展開專案和「Notebooks」資料夾，並視需要展開「Shared notebooks」資料夾。按一下所選筆記本的名稱。
按一下「查看時間表」。
在排程詳細資料表格中，點選「排程狀態」列中的「排程已啟用」切換鈕。
「排定時間」頁面
在 Google Cloud 控制台中，前往「Scheduling」頁面。
按一下所選筆記本的名稱。
在「排程詳細資料」頁面中，按一下「停用」。
啟用排程
如要繼續執行已停用的筆記本排程，請按照下列步驟操作：
「Explorer」窗格
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中展開專案和「Notebooks」資料夾，並視需要展開「Shared notebooks」資料夾。按一下所選筆記本的名稱。
按一下「查看時間表」。
在排程詳細資料表格中，按一下「排程狀態」列中的「排程已停用」切換鈕。
「排定時間」頁面
在 Google Cloud 控制台中，前往「Scheduling」頁面。
按一下所選筆記本的名稱。
在「時間表詳細資料」頁面中，按一下「啟用」。
編輯排程
您可以在「探索」窗格或「排程」頁面中編輯排程。
如要編輯時間表，請按照下列步驟操作：
「Explorer」窗格
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中展開專案和「Notebooks」資料夾，並視需要展開「Shared notebooks」資料夾。按一下所選筆記本的名稱。
按一下「查看排程」，然後點選「編輯」。
在「排定筆記本」對話方塊中編輯時間表，然後按一下「更新時間表」。
「排定時間」頁面
在 Google Cloud 控制台中，前往「Scheduling」頁面。
按一下所選筆記本排程的名稱。
在「排程詳細資料」頁面中，按一下「編輯」。
按一下「查看排程」，然後點選「編輯」。
在「排定筆記本」對話方塊中編輯時間表，然後按一下「更新時間表」。
刪除時間表
如要永久刪除所選筆記本的排程，請按照下列步驟操作：
在 Google Cloud 控制台中，前往「Scheduling」頁面。
執行下列任一操作：
按一下所選時間表的名稱，然後在「時間表詳細資料」頁面中按一下「刪除」。
在包含所選時程的資料列中，按一下「Actions」欄中的 「View actions」，然後點選「Delete」。
在隨即顯示的對話方塊中，按一下「Delete」。
後續步驟
- 進一步瞭解 BigQuery 中的 Colab Enterprise 筆記本。
- 瞭解如何建立 Notebook。