跳到主要内容

6. SQL 执行器

SQL 执行器是 DataQL 的扩展模块，通过代码片段执行数据库语句。脚本声明 SQL 和参数，再像函数一样调用片段；查询结果可以继续参与计算和转换。

使用条件

应用需要接入 dataql-sqlproc 并提供数据库连接，配置见 DataQL 引擎：SQL 执行器。本章介绍脚本用法。

hint FRAGMENT_SQL_OPEN_PACKAGE = 'off';
hint FRAGMENT_SQL_COLUMN_CASE = 'lower';
var find = @@selectSql(minAge)<%
    SELECT name, age FROM people WHERE age >= #{minAge} ORDER BY id
%>;
return find(25) => [{"name", "nextAge": age + 1}];

示例使用 SQL 执行中的 people 表，返回 [{"name":"Alice","nextAge":26},{"name":"Bob","nextAge":31}]。

使用指引​

  • SQL 执行：选择片段入口，执行查询、增删改和批量操作。
  • 参数绑定：位置参数、名称参数、SQL 文本替换、规则传参、参数选项和符号转义。
  • 动态规则：按规则生成语句、展开集合、选择分支和嵌套模板。
  • XML 动态 SQL：查阅各个 SQL 标签的属性、完整用法和生成结果。
  • 结果与主键、分页与方言：读取查询结果和分页数据。
  • 类型处理：Java/JDBC 类型关系、基础类型、JSON、流与二进制、数组和向量。
  • 事务：提交与回滚、七种传播行为、隔离级别和数据源范围。
  • 存储过程与多结果：调用存储过程并读取输出。
  • SQL Hint：查阅全部 SQL 执行选项。

新增规则、方言和处理器见引擎扩展。