設定作業參數
本文說明作業參數功能，以及使用 Databricks 工作區 UI 設定作業參數。 您也可以將作業參數新增至搭配 REST API、CLI 和 DAB 使用的 JSON 和 YAML 定義。 請參閱作業 API、什麼是 Databricks CLI？，以及什麼是 Databricks 資產套件組合？。
什麼是作業參數？
作業參數是索引鍵/值組，可讓您使用預設靜態或動態值將作業參數化。 在觸發新執行時，您可以選擇性地覆寫在作業中設定的參數。 請參閱使用不同參數執行作業。
作業參數索引鍵只能包含 _ - . 或英數字元。 參數值會設定為字串或動態值參考。 請參閱什麼是動態值參考？。
注意
您可以使用任何有效的 JSON 作為參數值。 例如，For each 任務類型可以剖析清單，如下所示：
[1, 2, 3]
['a', 'b', 'c']
新增或編輯作業參數
使用 [作業參數] 對話方塊來新增參數、編輯現有的參數索引鍵和值，或刪除參數。
若要使用工作區 UI 編輯參數，請使用下列步驟選取現有的作業：
- 按一下側邊欄中的
[工作流程]。 - 在 [名稱] 資料行，按下工作名稱。
- 在 [作業詳細資料] 提要欄位中，按兩下 [編輯參數]。 [作業參數] 對話方塊隨即出現。
- 使用 [索引鍵] 和 [值] 欄位新增或編輯參數。
- 按兩下
以移除參數。 - 按一下 [儲存] 套用變更。
注意
按兩下 { } 以列出可用的動態值參考。 從清單中選取選項，將其插入 [值] 欄位中。
作業參數下推
作業參數會自動向下推送為索引鍵/值參數至接受索引鍵/值參數的所有工作，其中包括下列工作類型：
- 筆記本
- Python Wheel（只有在使用關鍵字引數設定時）
- SQL 查詢、舊版儀表板或檔案
- 執行作業
傳遞至工作的作業參數會顯示在 UI 的工作組態中，以及設定工作參數。
重要
工作參數優先於任務參數。 如果工作參數和任務參數具有相同的索引鍵，則工作參數會覆寫任務參數。
作業參數的動態值參考
接受動態值參考的所有工作都可以存取作業參數。
使用動態值參考 {{job.parameters.<name>}}，以可識別 參數的 key 取代 <name>。
使用不同參數執行作業
當您使用不同的參數執行作業時，可以覆寫已設定的作業參數或新增作業參數。 請參閱使用不同參數執行作業。
您也可以在修復作業執行時覆寫作業參數。 請參閱重新執行失敗和略過的工作。