跳到主要内容

参数赋值

概述

参数赋值节点用于在离线开发工作流中，将数据库表或 BI 数据集的查询结果赋值给任务参数。配置完成后，参数赋值节点的下游节点可以直接引用这些动态参数，用于增量更新、条件分支判断、脚本执行、文件读取和接口请求等场景。

业务价值

参数赋值节点用于解决上游结果难以在下游节点复用的问题。通过将数据结果直接转换为参数，用户可以在不额外编写中间处理逻辑的情况下，完成增量时间点传递、条件判断、脚本动态入参和请求参数拼装，降低工作流配置复杂度并减少重复同步的数据量。

适用场景

参数赋值节点适用于需要从上游结果中提取单个值或字段集合，并在后续节点中继续使用的场景。

  1. 明细表增量更新时，先获取已同步数据的最后时间点，再同步大于该时间点的新数据，避免重复写入。
  2. 条件分支依赖源表状态动态判断执行路径时，先通过参数赋值节点提取判断依据。
  3. Python、SQL、HTTP 等节点需要根据上游结果动态拼装脚本参数、查询条件或请求体时，复用赋值参数完成配置。

添加参数赋值节点

本章节介绍如何在工作流中新增参数赋值节点，并进入配置页面。

入口说明

在「任务编辑」页面，添加新节点时选择「参数赋值」节点类型。

配置数据来源

本章节介绍参数赋值节点的数据来源配置规则。参数赋值节点支持从数据库和 BI 数据集取值，默认数据类型为「数据库」。

入口说明

在「参数赋值节点配置」页面，先完成基础信息和数据来源配置。

基础配置项

完成节点创建后，先配置以下基础信息：

配置项说明
节点名称设置当前参数赋值节点的名称，便于在工作流中识别。
描述填写节点用途说明，便于协作和后续维护。
数据来源指定参数值的来源类型。
数据类型支持选择「数据库」或「BI 数据集」，默认值为「数据库」。

从数据库取值

当数据类型选择为「数据库」时，请按以下步骤配置。

  1. 在「参数赋值节点配置」页面，将「数据类型」设置为「数据库」。
  2. 选择数据库连接信息。
配置项说明
选择数据库指定需要查询的数据库。
账户类型必选，用于确定连接方式。
数据账户必选，用于连接目标数据库。
配置项显示已选数据库和账户信息。
  1. 在「查询 SQL」输入框填写查询语句。
配置项说明
查询 SQL必填项。请使用所选数据库的语法编写 select 查询语句。
可引用内容支持时间宏参数、任务参数、全局参数。
编辑能力支持格式化和放大查看。
输入框显示 SQL 内容。

从 BI 数据集取值

当数据类型选择为「BI 数据集」时，请按以下步骤配置。

  1. 在「参数赋值节点配置」页面，将「数据类型」设置为「BI 数据集」。
  2. 选择数据集信息。
配置项说明
数据集类型选择目标数据集所属类型。
具体数据集必选，指定需要查询的某个数据集。
配置项显示已选数据集信息。
  1. 在「SQL 查询」输入框确认或修改查询语句。
配置项说明
SQL 查询必填项，默认值为 select * from XXX数据集。
查询结果仅保留符合查询条件的数据。
可引用内容支持任务参数、全局参数和时间宏。
输入框显示 SQL 内容。
  1. 如需更换数据集，重新选择目标数据集。
    系统刷新「SQL 查询」内容。

预览数据

完成数据来源配置后，建议先执行预览，确认字段和结果集符合预期。

  1. 在「参数赋值节点配置」页面，完成必填项配置后执行数据预览。
  2. 系统返回预览结果，最多展示 30 行数据。
  3. 当 SQL 发生变更时，系统提示「sql 发生变更，请重新预览」。

当动态参数已经配置完成后，如果修改了数据来源相关必填项，系统会再次提示重新预览数据。重新预览后，若字段与已配置动态参数不匹配，系统会给出异常提醒。

配置动态参数

本章节介绍如何根据查询结果配置动态参数。动态参数支持配置多个，每个参数可从查询结果中提取单个值或整列值。

入口说明

在「参数赋值节点配置」页面，完成数据来源必填项并成功预览后，点击「添加动态参数」。

添加规则

添加动态参数前，请先了解以下限制：

  1. 仅当数据来源相关必填项已完成配置后，才可点击「添加动态参数」。
  2. 点击添加时，系统会获取数据库表或数据集字段名称；若字段获取失败，系统直接报错。
  3. 动态参数名称在任务级别不可重名，仅支持中文、英文、下划线和 -。

分步指南

  1. 在「参数赋值节点配置」页面，点击「添加动态参数」按钮。
  2. 在动态参数配置区域，填写参数基础信息。
配置项说明
参数名必填。任务级别不可重名。
值类型支持「日期」「文本」「数值」。
值来源指定参数从查询结果中的哪种方式取值。
调试值非必填，仅用于后续节点预览。
配置项显示当前参数的配置内容。
  1. 在「值来源」中选择取值方式。
取值方式说明
整列选择某个字段作为整列值，最多支持 500 个值。
单个值从某个字段中取单个值，默认取第一行作为参数值。
  1. 如需在数据流预览阶段验证逻辑，可填写「调试值」。
    系统将该值用于数据流预览。

「调试值」仅用于预览，不会替代实际运行时从数据来源中读取的参数值。

在下游节点中使用赋值参数

本章节说明参数赋值节点生成的动态参数可在什么位置被引用，以及在不同节点中的使用方式。

入口说明

当参数赋值节点位于某个节点的上游时，可在该下游节点的参数输入区域引用赋值参数。

可引用范围

参数赋值节点的下游节点支持引用这些赋值参数，包括以下场景：

节点或能力可引用位置
数据流 / DB 数据流通用参数输入区域
数据库输入「SQL 查询」
数据库输出「前置清理」
输出数据集「增量」和「前置清理」
文件输入「文件地址」和「文件名称」
ERP「数据过滤」
添加计算列计算表达式配置区域
分组聚合「添加计算列」
筛选数据行筛选条件配置区域
SQL 输入SQL 内容区域
Python「Python 脚本」
SQL 节点「SQL 脚本」
HTTP「请求参数」和「请求体」
条件分支条件配置区域

条件分支中的使用规则

在「条件分支」节点中，可直接使用动态参数参与条件判断。

  1. 在「条件分支」节点的条件配置区域，选择动态参数作为判断项。
  2. 系统根据动态参数的「值类型」透出可选判断方式。
  3. 在「比较项」中，系统根据前置配置和赋值参数值类型，展示可选的动态参数。

子任务中的使用规则

当赋值参数传递到「子任务」节点时，仅供子任务内部使用，不会在子任务外部透出展示。

任务参数列表展示

本章节说明任务参数区域如何区分普通任务参数与动态参数，便于在任务编辑和调试时快速识别参数来源。

展示规则

任务参数区域会区分「任务参数」和「动态参数 [DATADRIVEN_PARAMS.]」两类参数。

参数类型说明
任务参数原有任务参数，仍按既有逻辑维护。
动态参数由参数赋值节点生成，不支持在参数列表中手动修改。

动态参数展示字段

动态参数在参数列表中展示以下信息：

字段说明
参数名称动态参数名称。
值类型动态参数的数据类型。
来源节点生成该参数的参数赋值节点。
调试值当前配置的调试值。

查看运行日志和实例参数

本章节介绍参数赋值节点运行后，用户可以在哪里查看赋值结果，以及失败时系统如何反馈原因。

运行日志

参数赋值节点执行完成后，运行日志会展示各节点的参数值或失败原因。

  1. 在工作流实例详情或节点运行日志中，打开参数赋值节点的日志信息。
  2. 查看各参数赋值节点对应的结果。
日志内容说明
节点名称展示具体的参数赋值节点名称。
参数值展示该节点生成的参数实际值。
获取失败原因当取值失败时，展示失败原因。

实例运行参数

工作流实例的运行参数区域也会展示赋值参数，便于统一查看最终参与执行的参数内容。

字段说明
参数名称赋值参数名称。
来源节点生成该参数的节点。
值类型参数的数据类型。
实际值运行时获取到的真实值。

注意事项/常见问题

本章节汇总参数赋值节点在使用过程中的关键限制、异常提示和待确认事项，便于快速定位问题。

注意事项

  • 修改数据来源、查询 SQL 或其他必填配置后，若已配置动态参数，请重新预览数据。
  • 「整列」取值方式最多支持 500 个值，超出范围时请先通过 SQL 过滤结果集。
  • 「单个值」取值方式默认取查询结果第一行对应字段的值。
  • 动态参数名称在任务级别不可重名，请避免与已有任务参数重复。

常见问题

  • 问题：为什么无法添加动态参数？
    解决方案：请先完成数据来源相关必填项，并确认已成功预览数据。若仍无法添加，请检查数据库表或数据集字段是否获取成功。
  • 问题：为什么数据流中无法使用动态参数？
    解决方案：请确认该参数赋值节点位于当前数据流节点的上游，另外是否有配置调试值，没有调试值不支持数据流使用。
  • 问题：为什么修改 SQL 后原有动态参数提示异常？
    解决方案：SQL 变更后，返回字段可能已经变化。请重新预览数据，并根据最新字段重新校验或调整动态参数配置。
  • 问题：为什么条件分支里看不到某个赋值参数？
    解决方案：请确认该参数赋值节点位于当前条件分支节点的上游，并检查动态参数的值类型是否符合当前比较条件的可选范围。
  • 问题：为什么运行后没有生成参数值？
    解决方案：请检查查询结果是否为空。若来源数据为空，系统会报错「数据表/数据集为空，无法赋值」。

术语解释

本章节用于解释参数赋值节点涉及的关键概念，帮助用户统一理解相关术语。

术语解释
参数赋值节点工作流中的一种节点类型，用于将数据库或 BI 数据集的查询结果转换为任务可引用的参数。
动态参数由参数赋值节点生成的参数，供下游节点运行时引用。
任务参数用户在任务级别预先配置的参数，区别于运行时动态生成的参数。
调试值仅用于数据流预览的临时参数值，不参与正式运行。
值类型动态参数的数据类别，包括日期、文本和数值。