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

Question

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

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

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

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

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

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

Answer 1

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

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

我们也越来越多地在 jOOQ 手册中添加特定方言的信息，例如对于the 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's Checker Framework or ErrorProne integration 进行静态代码分析。 See also this blog post here。