本文介绍作业参数功能以及如何使用 Databricks 工作区 UI 配置作业参数。 还可以将作业参数添加到用于 REST API、CLI 和 Databricks 资产捆绑包的 JSON 和 YAML 定义。 请参阅作业 API、什么是 Databricks CLI?以及什么是 Databricks 资产捆绑包?
什么是作业参数?
作业参数是键值对,让你能够使用默认静态或动态值将作业参数化。 可以选择在触发新运行时替代作业中配置的参数。 请参阅使用不同参数运行作业。
作业参数键只能包含 _ - . 或字母数字字符。 参数值设置为字符串或动态值引用。 请参阅什么是动态值引用?。
注意
可以将任何有效的 JSON 作为参数值。 例如,For each 任务类型可以分析列表,如下所示:
[1, 2, 3]
['a', 'b', 'c']
添加或编辑作业参数
使用“作业参数”对话框可以添加新参数、编辑现有参数键和值或删除参数。
使用工作区 UI 编辑参数,请按照以下步骤选择一个现有的作业:
在 Azure Databricks 工作区的边栏中,单击作业和管道。
(可选)选择作业和归我所有筛选器。
单击作业的名称链接。
在“作业详细信息”边栏中,单击“编辑参数”。 此时将出现“作业参数”对话框。
使用“键”和“值”字段可添加或编辑参数。
单击
可移除参数。单击“保存”应用所做的更改。
注意
单击 { } 可列出可用的动态值引用。 从列表中选择一个选项,以将其插入到“值”字段中。
作业参数下推
作业参数以不同的方式推送到不同的任务类型。 若要了解如何传递它们以及如何在任务中访问它们,请参阅 任务的 Access 参数值。
重要
作业参数优先于任务参数。 如果作业参数和任务参数具有相同的键,则作业参数将替代任务参数。
使用不同参数运行作业
使用不同的参数运行作业时,可以替代配置的作业参数或添加新的参数。 请参阅 运行具有不同设置的作业。
修复作业运行时也可以替代作业参数。 请参阅重新运行失败的和跳过的任务。