BeetlSQL 3.37 发布，增加多对多自动 Fetch
BeetlSQL3.37版本已经正式发布，新增全新的多对多自动Fetch功能，提供@FetchMany2Many注解及配套Action类，利用中间表来实现关联数据自动加载，能够极大简化复杂多表查询。同时修复了SQLServer表元数据读取异常，并升级底层模板引擎至3.20.1稳定版本。
BeetlSQL 从 2015 年就开始投入研发了，核心模块和周边生态组件全都自己动手实现，没有依赖任何第三方 ORM 的内核。它的设计目标很直白：让开发者用得顺手、维护起来轻松、运行起来高效。说白了，就是想要一个学习成本极低、适用场景广泛、还能高度定制化的数据库访问框架。
接下来看看这次版本更新带来的几个实用变化。
- 修复了 SQL Server 在某些场景下无法正确读取表元数据的问题
- Fetch 功能新增了对多对多关系的自动加载支持
- 底层模板引擎 Beetl 升级到了最新的 3.20.1 版本
Fetch 这块新增了一个 @FetchMany2Many 注解，配套提供了 FetchMany2ManyAction 类（配合 @Builder 使用）。这样一来，通过中间表自动拉取多对多关联数据就变得非常自然。来看看注解的定义：
@Retention(RetentionPolicy.RUNTIME)
@Target(value = {ElementType.METHOD, ElementType.FIELD})
@Builder(FetchMany2ManyAction.class)
public @interface FetchMany2Many {
Class tableClass(); // 中间表对应的实体类
String fromAttr(); // 当前实体在中间表中的外键字段名
String toAttr(); // 关联实体在中间表中的外键字段名
String enableOn() default ""; // 启用条件表达式（可选）
}
实际使用的时候，代码非常简洁：
@Table(name="sys_user")
public class MyUser {
@AutoID
Integer id;
String name;
@FetchMany2Many(tableClass = UserRole.class, fromAttr = "userId", toAttr = "roleId")
List roles;
}
BeetlSQL 核心模块说明
| BeetlSQL 核心模块 | 功能 |
| sql-core | 基础核心包，封装 JDBC 调用、SQL 文件管理、注解解析等核心能力 |
| sql-fetch | 提供类似 Hibernate 的 `@Fetch`、`@FetchMany` 等懒加载/预加载注解支持 |
| sql-mapper | Mapper 接口定义与扩展机制，支持用户自定义 Mapper 及其专属注解 |
| sql-intergration | 集成主流框架（如 Spring、Solon、JFinal）的适配器与完整示例 |
| sql-query | Query 与 LambdaQuery 接口，支持通过 Ja va API 构建并执行 SQL |
| sql-mapping | 单表/多表与 POJO 的双向映射能力，支持 JSON、XML 或约定优先等多种配置方式 |
| sql-template | 基于 Beetl 模板引擎实现 SQL 渲染，同时兼容其他模板语言扩展 |
| sql-gen | 代码生成抽象层，内置默认实现，可一键生成 DAO、SQL 文件、接口文档等 |
| sql-db-support | 覆盖 33+ 种数据库的兼容性测试与驱动验证 |
| sql-samples | 涵盖上百个典型业务场景的实战案例 |
| sql-test | 包含数百个高质量单元测试用例，保障稳定性与可靠性 |
BeetlSQL 官方扩展插件列表
| BeetlSQL 扩展包 | 功能 |
| sql-xml | 仿 MyBatis XML 风格语法支持，适合习惯用 XML 编写 SQL 的开发者 |
| sql-accelerator | 性能增强插件，通过反射优化、缓存策略等手段，使性能提升 50%–200%，逼近手写 JDBC 效率 |
| sql-firewall | SQL 防御模块，防止误操作导致的数据破坏或敏感信息泄露 |
| sql-dynamic-table | 动态表访问支持，让程序像操作静态表一样处理运行时创建的表结构 |
| sql-bean-encrypt | 字段级加解密支持，内置 `@MD5`、`@AES` 等常用加密注解 |
| sql-rewrite | SQL 重写引擎，支持单表多租户、逻辑删除、数据权限控制等功能 |
| SAGA（实验性） | 基于 SAGA 模式的分布式事务实现，服务于微服务架构下的事务一致性需求 |
启用加速插件后的性能对比：最高可以跑到原生 JDBC 性能的一半左右。下面列出了各种常见操作的具体数据。
| 查询类型 | 测试场景 | BeetlSQL (ops/ms) | 纯 JDBC | MyBatis | JPA |
| beetlsqlExecuteJdbc | 直接执行 JDBC 语句 | 318 | 678 | / | 64 |
| beetlsqlExecuteTemplate | 执行 Beetl SQL 模板 | 268 | / | 44 | 66 |
| beetlsqlFile | SQL 统一存放于文件中管理 | 266 | / | 41 | / |
| beetlsqlInsert | 单条记录插入 | 129 | 248 | 43 | 59 |
| beetlsqlGetAll | 全量数据查询 | 13 | 40 | 4 | 5 |
| beetlsqlLambdaQuery | 使用 LambdaQuery 构建并执行查询 | 196 | / | 9 | / |
| beetlsqlPageQuery | 分页查询操作 | 159 | / | 17 | 59 |
| beetlsqlSelectById | 根据主键查询单条记录 | 259 | 670 | 43 | 61 |
再来看一下更全面的 JMH 基准测试结果（单位：ops/ms），涵盖了多个框架的对比：
Benchmark Mode Cnt Score Error Units Beetl.addEntity thrpt 5 133.190 ± 38.548 ops/ms Beetl.complexMapping thrpt 5 236.289 ± 288.370 ops/ms Beetl.executeJdbcSql thrpt 5 298.657 ± 80.480 ops/ms Beetl.executeTemplateSql thrpt 5 251.418 ± 77.757 ops/ms Beetl.getAll thrpt 5 14.531 ± 0.605 ops/ms Beetl.getEntity thrpt 5 359.275 ± 85.099 ops/ms Beetl.lambdaQuery thrpt 5 187.228 ± 59.697 ops/ms Beetl.one2Many thrpt 5 178.041 ± 181.829 ops/ms Beetl.pageQuery thrpt 5 148.982 ± 39.327 ops/ms Beetl.sqlFile thrpt 5 249.206 ± 100.083 ops/ms DBVisitor.addEntity thrpt 5 99.294 ± 33.564 ops/ms DBVisitor.executeJdbcSql thrpt 5 185.177 ± 50.993 ops/ms DBVisitor.executeTemplateSql thrpt 5 3.189 ± 0.748 ops/ms DBVisitor.getAll thrpt 5 3.163 ± 0.980 ops/ms DBVisitor.getEntity thrpt 5 125.683 ± 44.190 ops/ms DBVisitor.lambdaQuery thrpt 5 94.314 ± 38.499 ops/ms DBVisitor.pageQuery thrpt 5 49.954 ± 18.254 ops/ms EasyQuery.addEntity thrpt 5 98.904 ± 39.890 ops/ms EasyQuery.complexMapping thrpt 5 67.397 ± 59.919 ops/ms EasyQuery.executeJdbcSql thrpt 5 243.160 ± 48.080 ops/ms EasyQuery.getAll thrpt 5 14.896 ± 2.219 ops/ms EasyQuery.getEntity thrpt 5 134.370 ± 67.962 ops/ms EasyQuery.lambdaQuery thrpt 5 137.292 ± 53.438 ops/ms EasyQuery.one2Many thrpt 5 75.083 ± 53.738 ops/ms EasyQuery.pageQuery thrpt 5 84.596 ± 46.942 ops/ms Flex.addEntity thrpt 5 86.484 ± 40.022 ops/ms Flex.getAll thrpt 5 2.926 ± 0.993 ops/ms Flex.getEntity thrpt 5 73.445 ± 39.437 ops/ms Flex.pageQuery thrpt 5 33.999 ± 26.776 ops/ms Jdbc.addEntity thrpt 5 225.223 ± 304.585 ops/ms Jdbc.executeJdbcSql thrpt 5 691.616 ± 145.280 ops/ms Jdbc.getAll thrpt 5 35.827 ± 7.295 ops/ms Jdbc.getEntity thrpt 5 678.791 ± 165.527 ops/ms Jpa.addEntity thrpt 5 53.219 ± 78.543 ops/ms Jpa.executeJdbcSql thrpt 5 60.734 ± 61.299 ops/ms Jpa.executeTemplateSql thrpt 5 64.478 ± 48.688 ops/ms Jpa.getAll thrpt 5 4.710 ± 2.062 ops/ms Jpa.getEntity thrpt 5 56.325 ± 53.744 ops/ms Jpa.one2Many thrpt 5 92.168 ± 111.591 ops/ms Jpa.pageQuery thrpt 5 58.756 ± 48.056 ops/ms MyBatis.addEntity thrpt 5 40.533 ± 12.461 ops/ms MyBatis.complexMapping thrpt 5 106.348 ± 57.688 ops/ms MyBatis.executeTemplateSql thrpt 5 46.953 ± 13.541 ops/ms MyBatis.getAll thrpt 5 5.394 ± 0.502 ops/ms MyBatis.getEntity thrpt 5 45.303 ± 11.928 ops/ms MyBatis.lambdaQuery thrpt 5 23.756 ± 13.613 ops/ms MyBatis.pageQuery thrpt 5 16.190 ± 5.682 ops/ms MyBatis.sqlFile thrpt 5 42.558 ± 18.025 ops/ms SqlUtils.addEntity thrpt 5 232.501 ± 332.656 ops/ms SqlUtils.executeJdbcSql thrpt 5 682.610 ± 171.506 ops/ms SqlUtils.getAll thrpt 5 44.353 ± 4.346 ops/ms SqlUtils.getEntity thrpt 5 643.873 ± 131.587 ops/ms Wood.addEntity thrpt 5 105.097 ± 79.961 ops/ms Wood.executeJdbcSql thrpt 5 127.020 ± 48.142 ops/ms Wood.executeTemplateSql thrpt 5 129.193 ± 44.455 ops/ms Wood.getAll thrpt 5 2.051 ± 0.524 ops/ms Wood.getEntity thrpt 5 126.104 ± 41.976 ops/ms Wood.lambdaQuery thrpt 5 125.013 ± 43.991 ops/ms Wood.pageQuery thrpt 5 220.101 ± 90.028 ops/ms Wood.sqlFile thrpt 5 132.431 ± 50.141 ops/ms
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。