本頁面由 Cloud Translation API 翻譯而成。

安排代管型筆記本執行時間

本頁面說明如何使用 Vertex AI Workbench 代管筆記本執行器，以每小時為間隔執行 Python 筆記本檔案。

事前準備

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Enable the APIs

必要的角色

為確保執行個體的服務帳戶具備與 Vertex AI Workbench 執行器互動的必要權限，請要求管理員將專案的下列 IAM 角色授予執行個體的服務帳戶：

Notebooks 檢視者 (roles/notebooks.viewer)
Vertex AI 使用者 (roles/aiplatform.user)
儲存空間管理員 (roles/storage.admin)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

管理員或許也能透過自訂角色或其他預先定義的角色，將必要權限授予執行個體的服務帳戶。

建立代管型筆記本執行個體和範例筆記本檔案

建立代管型筆記本執行個體。
開啟 JupyterLab。
開啟新的筆記本檔案。

在筆記本檔案的第一個儲存格中，輸入下列內容：

# Import datetime
import datetime

# Get the time and print it
datetime.datetime.now()
print(datetime.datetime.now())

如要確保筆記本檔案已儲存，請依序選取「檔案」>「儲存筆記本」。

排定執行時間

前往 Google Cloud 控制台的「受管理筆記本」頁面。

前往代管型筆記本
在要使用的代管型筆記本執行個體旁，按一下「Open JupyterLab」(開啟 JupyterLab)。

代管型筆記本執行個體中會開啟 JupyterLab。
在「File Browser」中，按兩下範例筆記本檔案即可開啟。
按一下「執行」按鈕。
在「Submit notebooks to Executor」(將筆記本提交至執行器) 對話方塊的「Type」(類型) 欄位中，選取「Schedule-based recurring executions」(根據排程重複執行)。

根據預設，執行器會在每小時的第 00 分鐘執行筆記本檔案。
在「進階選項」中，選取要執行筆記本的「區域」。
在「Cloud Storage bucket」(Cloud Storage bucket) 欄位中，輸入 bucket 的名稱，然後按一下「Create and select」(建立並選取)。執行器會將筆記本輸出內容儲存在 Cloud Storage bucket 中。
按一下「提交」。

筆記本檔案會依您設定的時間表自動執行。

完成本文所述工作後，您可以刪除已建立的資源，避免繼續計費。詳情請參閱清除所用資源一節。

查看、分享及匯入已執行的筆記本檔案

透過代管型筆記本執行個體的 JupyterLab 介面，您可以查看筆記本輸出內容、與他人分享結果，以及將執行的筆記本檔案匯入 JupyterLab。

查看執行結果

在 JupyterLab 的導覽選單中，按一下「Notebook Executor」(筆記本執行器) 按鈕。
按一下「執行」分頁標籤。
在要查看的執行作業下方，按一下「查看結果」。

Executor 會在新瀏覽器分頁中開啟結果。

分享執行結果

在代管型筆記本執行個體的 JupyterLab 使用者介面中，按一下導覽選單中的「Notebook Executor」按鈕。
按一下「執行」分頁標籤。
在要分享的執行作業旁邊，按一下選單，然後選取「分享執行結果」。
按照對話方塊中的指示，授予使用者執行結果的存取權。

將已執行的筆記本匯入 JupyterLab

在代管型筆記本執行個體的 JupyterLab 使用者介面中，按一下導覽選單中的「Notebook Executor」按鈕。
按一下「執行」分頁標籤。
在要匯入的執行作業旁邊，按一下選單，然後選取「匯入已執行的筆記本」。
如果出現「Select Kernel」對話方塊，請選取要開啟筆記本的核心。

執行器會在 JupyterLab 中開啟已執行的筆記本檔案，並將這個筆記本檔案儲存在 JupyterLab 檔案瀏覽器的 imported_notebook_jobs 資料夾中。

查看或刪除時間表

您可以使用 Google Cloud 控制台或受管理筆記本執行個體的 JupyterLab 使用者介面，查看及刪除時間表。

查看時間表

查看排程，瞭解排程的頻率設定，或查看筆記本檔案最近五次的執行結果。

控制台

前往 Google Cloud 控制台的「Schedules」(排程) 頁面。

前往「時間表」
選取要查看排程的「區域」。
如要開啟「時間表詳細資料」頁面，請按一下時間表名稱。

在「排程詳細資料」頁面中，您可以查看排程的最近五次執行情況。
在執行名稱旁邊按一下「查看結果」，即可開啟已執行的筆記本檔案。

Executor 會在新瀏覽器分頁中開啟結果。

JupyterLab

在代管型筆記本執行個體的 JupyterLab 使用者介面中，按一下導覽選單中的「Notebook Executor」按鈕。
按一下「時間表」分頁標籤。
在要查看的執行作業下方，按一下「查看最新執行結果」。

Executor 會在新瀏覽器分頁中開啟結果。

刪除時間表

刪除排程不會刪除從該排程產生的執行作業。

控制台

前往 Google Cloud 控制台的「Schedules」(排程) 頁面。

前往「時間表」
選取要刪除排程的區域。
選取要刪除的行程。
按一下「Delete」(刪除) 圖示。

JupyterLab

在代管型筆記本執行個體的 JupyterLab 使用者介面中，按一下導覽選單中的「Notebook Executor」按鈕。
按一下「時間表」分頁標籤。
在時間表名稱結尾，按一下「在新視窗中開啟」圖示。該排程的「Schedule details」(排程詳細資料) 頁面隨即會在 Google Cloud 控制台中開啟。
按一下「Delete」(刪除) 圖示。

清除所用資源

如要避免系統向您的 Google Cloud 帳戶收取本頁所用資源的費用，請按照下列步驟操作。

刪除執行個體

前往 Google Cloud 控制台的「受管理筆記本」頁面。

前往代管型筆記本
選取包含執行個體的「Region」(區域)。
選取要刪除的代管筆記本執行個體。
按一下「Delete」(刪除) 圖示。

刪除專案

如果您使用了受管理筆記本執行個體以外的資源 (例如建立排程時所需的 Cloud Storage bucket)，建議刪除專案，以免產生額外費用。

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

後續步驟

進一步瞭解如何建立代管 Notebook 執行個體。