参数模板、输入和变量

使用 ADMIN 完整跟做本页,以便查看日志和变量。OPERATOR 可执行已配置任务和查看概要状态,但不能读取这些详情。

创建两个输入项,手动执行一次任务,再核对本次输入和脚本输出。本页使用 1.0.0;完整语法见变量参考。

1. 创建参数模板

进入“参数模板”,新增模板并逐项填写:

参数名 类型 必填 默认值 用途
batchDate DATE 是 不设置 本次处理的业务日期
limit INTEGER 否 3 本次演示的数量限制

必填和默认值是两个独立设置;空、缺失、0、false 的含义不同。敏感项不能保存默认值。枚举、范围、长度限制应按类型填写,最多 100 项。

包含日期和整数的参数模板

2. 配置任务引用

使用 SCRIPT,本地执行;Windows 选择 BAT,Linux 选择 SHELL。填写:

echo limit=${limit}
echo __VAR__:rows=3
exit 0

本例 limit 必须保持 INTEGER 类型。保存任务会发布新版本,不会执行。创建/修改模板与任务建议使用 ADMIN;手动执行可使用 ADMIN 或 OPERATOR。

3. 填写本次值并执行

  1. 点击任务“执行”,在执行弹窗选择参数模板。
  2. 确认 batchDate 为本次日期,limit 为整数 3;不要把模板名称作为参数值。
  3. 检查传入项及本次值后提交。
  4. 打开相应实例,核对输入快照中的日期和整数。

本次输入不会自动修改模板和已有调度。“重新载入”会替换当前草稿,操作前确认需要保留的编辑内容。

4. 核对结果

检查项 预期
输入 batchDate 与提交日期一致,limit 为数字 3
日志 包含 limit=3
输出变量 rows 的值为字符串 "3",不是数字 3
状态 脚本正常退出后实例 SUCCESS

变量输出日志会隐藏变量值,不能仅根据日志缺少 rows 的值判断输出失败。查看变量详情仍受账号权限限制。

用在 SQL 或 ETL 时

SQL 插件 ${limit} 是文本替换;ETL 查询使用 :limit 并配置查询参数。日期转换、脚本原生变量转义和上游合并规则见变量参考。口令和 token 放在资源配置中。

文档版本 1.0.0。命令中的示例路径、资源和端口需替换为自己的环境。