参数模板、输入和变量
使用 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. 填写本次值并执行
- 点击任务“执行”,在执行弹窗选择参数模板。
- 确认 batchDate 为本次日期,limit 为整数 3;不要把模板名称作为参数值。
- 检查传入项及本次值后提交。
- 打开相应实例,核对输入快照中的日期和整数。
本次输入不会自动修改模板和已有调度。“重新载入”会替换当前草稿,操作前确认需要保留的编辑内容。
4. 核对结果
| 检查项 | 预期 |
|---|---|
| 输入 | batchDate 与提交日期一致,limit 为数字 3 |
| 日志 | 包含 limit=3 |
| 输出变量 | rows 的值为字符串 "3",不是数字 3 |
| 状态 | 脚本正常退出后实例 SUCCESS |
变量输出日志会隐藏变量值,不能仅根据日志缺少 rows 的值判断输出失败。查看变量详情仍受账号权限限制。
用在 SQL 或 ETL 时
SQL 插件 ${limit} 是文本替换;ETL 查询使用 :limit 并配置查询参数。日期转换、脚本原生变量转义和上游合并规则见变量参考。口令和 token 放在资源配置中。
