Jet SQL 构建器新增自定义表达式支持

Jet SQL 构建器在最新版本中引入了一项重要功能更新，使得开发者能够更灵活地处理各种SQL方言中的特殊函数语法。这项改进特别针对那些包含关键字参数的SQL函数调用场景。

背景与挑战

在标准SQL和各类数据库方言中，存在大量使用关键字参数的函数调用形式。例如：

• 标准SQL中的SUBSTRING函数：SUBSTRING(extraction_string FROM starting_position)
• MySQL的TRIM函数：TRIM(LEADING 'x' FROM str)
• PostgreSQL的ARRAY_AGG函数：ARRAY_AGG(a ORDER BY b DESC)

过去，Jet用户需要使用Raw表达式来处理这些特殊语法，这不仅不够优雅，而且在处理复杂表达式时尤为不便。特别是当参数不是简单的列名而是复杂表达式时，缺乏类型安全的构建方式。

解决方案

Jet v2.12.0版本引入了两个关键功能来解决这一问题：

1. CustomExpression函数：允许开发者自由组合SQL表达式片段
2. Token类型：表示SQL中的固定文本标记

通过这两个新功能，开发者可以轻松构建各种特殊语法的SQL函数调用。例如，实现PostgreSQL风格的ARRAY_AGG函数现在可以这样写：

func ARRAY_AGG_ORDER_BY(a Expression, b Expression) Expression {
    return CustomExpression(
        Token("array_agg("),
        a,
        Token("ORDER BY"),
        b,
        Token(")"),
    )
}

或者使用更简洁的Func组合方式：

func ARRAY_AGG_ORDER_BY(a Expression, b Expression) Expression {
    return Func("array_agg", CustomExpression(a, Token("ORDER BY"), b))
}

实际应用示例

假设我们需要构建一个包含ORDER BY子句的ARRAY_AGG查询，现在可以这样实现：

query := SELECT(
    ARRAY_AGG_ORDER_BY(table.Column1, table.Column2.DESC()),
).FROM(table)

这种方式不仅保持了类型安全，还能确保生成的SQL语法完全符合目标数据库的要求。

优势与价值

这一改进为Jet用户带来了几个重要好处：

1. 更好的类型安全：不再需要依赖Raw表达式和字符串拼接
2. 更高的灵活性：可以处理各种数据库特有的函数语法
3. 更清晰的代码：自定义函数封装使业务逻辑更易读
4. 更好的可维护性：集中管理特殊语法，减少重复代码

对于需要支持多种数据库方言的项目，这项功能尤为重要，它使得开发者能够在不牺牲类型安全的前提下，灵活应对各种SQL语法差异。

总结

Jet SQL构建器通过引入CustomExpression和Token支持，显著提升了处理特殊SQL函数语法的能力。这一改进使得Jet在保持强类型优势的同时，能够更好地适应各种数据库方言的特殊需求，为开发者提供了更强大、更灵活的工具来构建复杂的SQL查询。