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

Question

我是一个有经验和快乐的jOOQ用户。

我现在正在从事一个需要支持多个数据库引擎(至少是PostgreSQL、MySQL、Oracle )的项目。

我们希望有足够低的级别来控制我们的查询。JPA/Hibernate对我们来说太高了。

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

是否有任何方法对不同的数据库引擎重用相同的jOOQ查询定义(除了引擎特定的差异之外，具有相同的模式)？

如果必要的话，如果需要重新编译java类，也可以。编译时配置对我们来说很好。

Answer 1

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

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

我们也越来越多地将方言特定信息添加到jOOQ手册中，例如用于函数

-- 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. 运行集成测试，例如对每个目标方言使用测试容器
2. 使用jOOQ的检查框架或ErrorProne集成进行静态代码分析。也请看这里的博客文章。