jOOQ如何根据配置处理多个数据库引擎

Question

我是一个经验丰富且快乐的 jOOQ 用户。

我现在正在开发一个需要支持多个数据库引擎的项目（至少 PostgreSQL、MySQL、Oracle）。

我们想要足够低级别的东西来控制我们的查询。 JPA/Hibernate 对我们来说太高级了。

我知道 jOOQ 使用元模型，并且该元模型是从数据库模式生成的。

有没有办法针对不同的数据库引擎重用相同的 jOOQ 查询定义（具有相同的模式，除了引擎特定的差异）？

如果我们需要在必要时重新编译 java 类，那很好。 编译时配置对我们来说很好。

Answer 1

jOOQ 就是为此而设计的。 你需要做这些事情：

1. 根据您的 JDBC 连接，准备好带有SQLDialect的Configuration 。 那是容易的部分。 该Configuration将为您的所有 jOOQ 查询自动生成特定于供应商的 SQL。 这可以在运行时完成。 无需任何编译时间调整。
2. 确保您的表/列始终使用相同的大小写， 或关闭 jOOQ 标识符中不区分大小写的行为的引用（取决于您的 MySQL 配置，这可能还不够， 请参阅 MySQL 手册）。 然后，您可以在所有其他方言上重新使用从任何数据库方言生成的代码。
3. 确保只使用带有@Support({ MYSQL, ORACLE, POSTGRES })注释的 jOOQ API。 例如，不能使用DSL.toDate() ，因为它不支持 MySQL，但可以使用DSL.trunc() ，因为所有 3 个目标方言都存在。

我们也越来越多地在 jOOQ 手册中添加方言特定信息，例如SHL() function ：

-- ASE, HSQLDB, SQLDATAWAREHOUSE, SQLSERVER, SYBASE
(1 * CAST(power(2, 4) AS int))

-- AURORA_MYSQL, AURORA_POSTGRES, COCKROACHDB, CUBRID, MARIADB, MEMSQL, MYSQL, POSTGRES, SQLITE, VERTICA
(1 << 4)

-- DB2, INFORMIX
(1 * CAST(power(2, 4) AS integer))

-- FIREBIRD
bin_shl(1, 4)

-- H2
lshift(1, 4)

-- ORACLE
(1 * CAST(power(2, 4) AS number(10)))

-- TERADATA
shiftleft(1, 4)

-- ACCESS, DERBY, HANA, INGRES, REDSHIFT
/* UNSUPPORTED */

为了确保您不会意外编写不适用于某些方言的查询，您可以：

1. 运行集成测试，例如在每个目标方言上使用testcontainers
2. 使用jOOQ 的 Checker Framework 或 ErrorProne 集成进行 static 代码分析。 另请参阅此处的此博客文章。