C# 中使用 HiSql 实现跨数据库 SQL 转换

结果与目标

在混合多种数据库类型的项目中，直接编写 SQL 往往需要针对每种数据库进行特殊的语法调整。引入 HiSql 的目标是建立一套中间 SQL 表达层，使开发人员只需书写标准或近标准的 SQL 语句，即可让底层框架根据配置的目标数据库生成对应的方言语句（如关键字引号、分页逻辑、日期格式等）。

准备条件

要实现跨库 SQL 转换，需要在项目中正确引入并初始化 HiSql 客户端实例。假设环境中已存在名为 sqlClient 的实例对象，该对象负责管理数据库连接及方言识别。此外，需熟悉基础的 SQL 构建逻辑，以便理解从输入到输出的映射关系。

第1步：初始化客户端实例

目的：获取能够处理 SQL 语义分析且具备多方言生成能力的工具实例。 入口：项目中的依赖项管理与配置文件。 动作：确保 NuGet 包已安装，并通过代码创建 HiSql 客户端对象。虽然具体初始化代码未在此列出，但后续所有操作均需依赖于这个 sqlClient 对象来调用 HiSql() 方法。

真实操作顺序：核心功能与转换示例

第1步：执行单表基础查询

目的：验证基础 SELECT 语法在不同数据库间的时间与字段命名规范差异。 入口：在 C# 代码中调用 sqlClient.HiSql()。 动作：传入一句通用的 SQL 字符串，包含时间范围判断。调用 ToSql() 方法时，系统会根据当前连接的数据库方言重写 SQL。

var _sql = sqlClient.HiSql("select * from HTest01 where CreateTime>='2022-02-17 09:27:50' and CreateTime<='2022-03-22 09:27:50'").ToSql();

转换结果分析：

• SQL Server：会自动为表名和字段名添加方括号 []，并对日期字符串扩展毫秒精度（.000）。
• MySQL：会反引号包裹标识符（`），保持日期的原始精度或依驱动配置。
• PostgreSQL：默认会将未加引号的标识符转为小写，并使用双引号 " 包裹。

注意：SELECT * 在某些情况下会被扩展为全字段列表，这可能与 Hi_FieldModel 系统表配置的默认排序有关。

第2步：聚合与分组过滤

目的：测试 GROUP BY 及 HAVING 子句的兼容性处理。 入口：构建包含 COUNT、MAX 等聚合函数的查询。

string sql_having = sqlClient.HiSql("select FieldName, count(FieldName) as NAME_count,max(FieldType) as FieldType_max from Hi_FieldModel group by FieldName having count(FieldName) > 1").ToSql();

转换特点：HiSql 会识别聚合行为，并确保 HAVING 子句紧跟在 GROUP BY 之后。生成的 SQL 在各数据库中均能正确保留聚合后的筛选逻辑，但在个别数据库对别名支持上可能存在细微差异，此工具进行了统一抽象。

第3步：多表关联查询 (JOIN)

目的：解决内连接与条件合并的语法一致性。

var sql = sqlClient.HiSql("select a.tabname from hi_fieldmodel as a inner join Hi_TabModel as b on a.tabname =b.tabname ...").ToSql();

在该操作中，HiSql 处理了别名（Alias）的引用方式。生成的最终语句中，不同数据库会使用各自的标识符包围符（方括号、反引号或双引号）严格区分字段所属表，防止歧义。

第4步：实现分页逻辑

目的：将简单的 Take/Skip 链式调用翻译为对应数据库的分页方言。

var sql = sqlClient.HiSql("...查询语句...").Take(2).Skip(2).ToSql();

内部机制与转换结果对比：

• SQL Server：采用子查询配合 ROW_NUMBER() OVER(...) 函数，通过 BETWEEN 范围进行切片，以符合早期版本兼容性。
• MySQL：转换为标准子查询排序后接 LIMIT offset, size。
• PostgreSQL：转换为 LIMIT size OFFSET offset 形式。

这种封装避免了手动编写复杂的窗口函数或偏移量计算，极大简化了分页组件的开发。

第5步：安全参数化处理

目的：防止 SQL 注入并提供动态传参能力。

string sql1= sqlClient.HiSql("select * from hi_tabmodel where tabname=@tabname", new { TabName="H_test" }).ToSql();

HiSql 支持通过匿名对象、字典或集合传递参数。在执行 ToSql() 前，参数会被安全地替换或绑定至命令上下文，而非简单字符串拼接，确保了跨库执行的安全性。

第6步：混合链式 API 查询

目的：结合 DSL 链式 API 与字符串语法。

string sql = sqlClient.HiSql("select A.FieldType from Hi_FieldModel as A ")
                .Where("A.TabName='GD_UniqueCodeInfo'")
                .Take(2).Skip(2)
                .ToSql();

开发者可以先传入一段静态 SQL 骨架，再利用后续的 Where、Sort、Take 等方法追加动态条件。这种方式非常适合构建动态报表或复杂搜索模块，由框架统一组装最终的方言 SQL。

完成判断

当调用 ToString() 或调试查看变量值时，如果输出内容包含了正确的目标数据库特有语法（例如 MySQL 的反引号和 LIMIT，或 SQL Server 的 ROW_NUMBER 逻辑），则说明跨库转换已成功生效。此时，同一段 C# 业务逻辑即可无缝对接不同的数据存储后端。

简要总结

以上就是 C# 利用 HiSql 实现跨数据库 SQL 语句统一与转换的详细内容，更多关于 C# ORM 框架与数据库交互的资料请关注本站其它相关文章！