SQL 执行

适用版本：1.0.0。任务 → 新增/编辑 → 插件 SQL。

入口与准备

使用 ADMIN 创建、配置和保存任务；ADMIN 或 OPERATOR 可以执行已发布定义，详细日志和输入输出变量由 ADMIN 查看。资源必须启用并可被执行节点访问。任务公共超时、重试和版本规则见任务，角色动作见权限矩阵。

字段说明

“默认值”指 1.0.0 新建表单的初始值；空表示尚未填写，不表示必填项可以省略。显示条件决定当前分支中是否出现字段。“条件必填”只在对应分支启用时要求填写。

SQL 执行

• 数据库资源：业务数据库资源。
• SQL 内容：最多 1000000 字符。
• SQL 分隔符：1–16 字符，不接受变量表达式。
• 事务：事务能力取决于数据库及语句。
• 出错后继续：事务开启时禁止出错后继续。
• 查询超时（秒）：1–86400 秒。
• 最小行数（可选）：非负整数，不能超过最大行数。
• 最大行数（可选）：非负整数。
• 结果变量（可选）：最多 128 字符，不接受变量表达式作为名称。

使用边界

• SQL 插件是 ${...} 文本替换，不提供命名参数绑定；校验输入类型和引号。
• 查询超时和任务总超时是不同层级，实例终态可能不同。

典型配置：读取订单总数

按下表填写界面，资源名称需替换为自己的已启用资源。这是配置说明，不是可直接导入的 JSON。完整数据准备与执行步骤见本节末尾教程。

先按链接教程在独立业务库创建三行orders数据。

SQL 内容：

SELECT COUNT(*) AS total FROM orders;

预期结果： 查询成功，输出变量 ordersResult 为标量数字 3。

跟做完整教程。保存定义后再手动执行；实例状态与业务结果分别核对。

真实界面

技术字段对照

以下键名用于导入配置、接口或排障。规则中的 [] 表示集合元素；不需要把这些键名填入界面标签。

相关页面

任务与版本 · 参数与表达式 · 场景教程