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

Question

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

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

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

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

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

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

Answer 1

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

根据您的 JDBC 连接准备好 Configuration with a SQLDialect。这是最简单的部分。 Configuration 将为您的所有 jOOQ 查询自动生成特定于供应商的 SQL。这可以在运行时完成。无需任何编译时调整。
确保您的表/列始终使用相同的大小写，or turn off quoting in jOOQ's identifiers for case insensitive behaviour (depending on your MySQL configuration, that might not be enough, see the MySQL manual)。然后，您可以在所有其他方言上重复使用任何数据库方言生成的代码。
确保只使用带有 @Support({ MYSQL, ORACLE, POSTGRES }) 注释的 jOOQ API。例如，可以使用 DSL.toDate() cannot be used, because it doesn't support MySQL, but 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 */

为了确保您不会不小心编写了对某些方言不起作用的查询，您可以：

运行集成测试，例如在每个目标方言

testcontainers

使用jOOQ's Checker Framework or ErrorProne integration for static code analysis. See also this blog post here.

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

How can jOOQ be used to deal with multiple database engine depending on configuration

mysql

oracle

postgresql

jooq