使用英语阅读

通过


配置作业参数

本文介绍作业参数功能以及如何使用 Databricks 工作区 UI 配置作业参数。 还可以将作业参数添加到用于 REST API、CLI 和 DAB 的 JSON 和 YAML 定义。 请参阅作业 API什么是 Databricks CLI?以及什么是 Databricks 资产捆绑包?

什么是作业参数?

作业参数是键值对,让你能够使用默认静态或动态值将作业参数化。 可以选择在触发新运行时替代作业中配置的参数。 请参阅使用不同参数运行作业

作业参数键只能包含 _ - . 或字母数字字符。 参数值设置为字符串或动态值引用。 请参阅什么是动态值引用?

备注

可以将任何有效的 JSON 作为参数值。 例如,For each 任务类型可以分析列表,如下所示:

[1, 2, 3]
['a', 'b', 'c']

添加或编辑作业参数

使用“作业参数”对话框可以添加新参数、编辑现有参数键和值或删除参数。

使用工作区 UI 编辑参数,请按照以下步骤选择一个现有的作业:

  1. 单击边栏中 工作流图标工作流”。
  2. 在“名称”列中单击作业名称。
  3. 在“作业详细信息”边栏中,单击“编辑参数”。 此时将出现“作业参数”对话框。
  4. 使用“键”和“值”字段可添加或编辑参数。
  5. 单击 Trash 可移除参数。
  6. 单击“保存”应用所做的更改。

备注

单击 { } 可列出可用的动态值引用。 从列表中选择一个选项,以将其插入到“值”字段中。

作业参数下推

作业参数自动作为键值参数向下推送到接受键值参数的所有任务,包括以下任务类型:

  • 笔记本
  • Python wheel(仅当配置了关键字参数时)
  • SQL 查询、旧仪表板或文件
  • 运行作业

传递给任务的作业参数以及配置的任务参数都可在 UI 中的任务配置中查看。

重要

作业参数优先于任务参数。 如果作业参数和任务参数具有相同的键,则作业参数将替代任务参数。

对作业参数的动态值引用

接受动态值引用的所有任务都可以访问作业参数。

使用动态值引用 {{job.parameters.<name>}},将 <name> 替换为拥有标识参数的 key

使用不同参数运行作业

使用不同的参数运行作业时,可以替代配置的作业参数或添加新的参数。 请参阅使用不同参数运行作业

修复作业运行时也可以替代作业参数。 请参阅重新运行失败的和跳过的任务