使用 Python 腳本 任務來執行 Python 檔案。
Requirements
- 你必須將 Python 腳本上傳到使用者設定工作時可存取的位置。 Databricks 建議使用 workspace 檔案來處理 Python 腳本。 請參閱 什麼是工作區檔案？。
設定一個 Python 腳本任務
Note
工作 UI 會根據其他已設定的設定動態顯示選項。
Databricks 建議不要使用 DBFS 根或掛載區儲存程式碼或資料。 相反，可以將 Python 指令碼移轉至工作區檔案或磁碟區，或者使用 URI 來存取雲端物件儲存體。
若要開始流程以設定 Python script 任務：
- 流覽至 [工作 UI] 中的 [任務] 索引標籤。
- 點擊
新增任務。 - 在 [任務名稱] 欄位中輸入名稱。
- 在 Type 下拉選單中，選擇
Python script。
設定來源
在 Source 下拉選單中，使用以下選項之一選擇Python腳本的位置。
Workspace
使用 Workspace 來設定儲存在 workspace 檔案中的 Python 腳本。
- 按一下 [路徑] 欄位。 會出現 Select Python File對話框。
- 瀏覽Python腳本，點選高亮該檔案，然後點Confirm。
Note
您可以使用此選項，在儲存於 Databricks Git 資料夾中的 Python 指令碼上設定任務。 Databricks 建議使用Git 提供者選項和遠端 Git 存放庫來對排程工作中的資產進行版本控制。
DBFS/ADLS
使用 DBFS/ADLS 來設定儲存在磁碟區、雲端物件儲存位置或 DBFS 根中的 Python 指令碼。
Databricks 建議將 Python 指令碼儲存在 Unity Catalog 磁碟區或雲端物件儲存體中。
在 [路徑] 欄位中，輸入 Python 指令碼的 URI。 例如，dbfs:/path/to/script.py 或 abfss://container-name@storage-account-name.dfs.core.windows.net/path/to/script.py。
Git 提供者
使用 Git provider 來設定儲存在遠端 Git 儲存庫中的 Python 腳本。
UI 所顯示的選項取決於您是否已在其他地方設定了 Git 提供者。 只有一個遠端 Git 存放庫可用於工作中的所有任務。 請參見「使用 Git 搭配 Lakeflow 工作」。
[路徑] 欄位會出現在您設定 Git 參考之後。
輸入 Python 指令碼的相對路徑，例如 etl/bronze/ingest.py。
這很重要
當您輸入相對路徑時，請勿以 / 或 ./開頭。 例如，如果你想存取的Python碼的絕對路徑是 /etl/bronze/ingest.py，請在 etl/bronze/ingest.py 欄位輸入 。
設定計算和相依程式庫
- 使用 [計算] 來選取或設定在指令碼中支援邏輯的叢集。
- 如果您使用
Serverless計算，請使用 [環境和程式庫] 欄位來選取、編輯或新增環境。 請參閱 設定無伺服器環境。 - 對於所有其他運算配置，請點擊 在「相依函式庫」下新增。
新增相依程式庫對話方塊隨即出現。
- 您可以選取現有的連結庫或上傳新的連結庫。
- 只能使用儲存在計算組態所支援位置的程式庫。 請參見 Python 函式庫支援。
- 每個程式庫來源都有不同的程式庫選取或上傳流程。 請參閱 安裝連結庫。
完成工作組態
- （可選）將 Parameters 配置為一串字串，作為 CLI 參數傳遞給 Python 腳本。 請參閱設定任務參數。
- （可選）若要設定重試、執行時長或串流待辦清單閾值，或通知，請參閱 進階任務設定。
- 按一下 [儲存任務]。
若要編輯、複製、停用或刪除此任務，請參閱 Lakeflow Jobs 中的「配置與編輯任務」。
其他資源
- Python 腳本任務：將 Python 腳本任務定義為使用 Declarative Automation Bundles 的程式碼。
- 設定任務參數：將參數以 CLI 參數傳遞給你的 Python 腳本。
- Python 輪任務用於工作：執行打包好的 Python 程式碼與相關的 Python 輪任務。