配置作业参数
本文介绍作业参数功能以及如何使用 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>}}
,将 <name>
替换为拥有标识参数的 key
。
使用不同的参数运行作业时,可以替代配置的作业参数或添加新的参数。 请参阅使用不同参数运行作业。
修复作业运行时也可以替代作业参数。 请参阅重新运行失败的和跳过的任务。