我是 R2DBC ( https://r2dbc.io/ ) 的新手。我想知道r2dbc的生态系统是否有数据库迁移工具/框架。
似乎 Liquibase 和 Flyway 依赖于 JDBC。是否有计划允许这些框架支持 r2dbc 驱动程序?
欢迎任何输入或反馈。
我是 R2DBC ( https://r2dbc.io/ ) 的新手。我想知道r2dbc的生态系统是否有数据库迁移工具/框架。
似乎 Liquibase 和 Flyway 依赖于 JDBC。是否有计划允许这些框架支持 r2dbc 驱动程序?
欢迎任何输入或反馈。
史蒂夫的回答是正确的,因为 R2DBC 主要是关于与实际数据的交互。我想补充一个不同的观点。
确实,反应式 API 在迁移期间不会提供任何改进。事实上,仔细观察,迁移是启动过程的一部分,通常是同步的,至少在某种程度上是同步的。
迁移时需要 JDBC 会增加这种应用程序安排的复杂性。您需要在现有 R2DBC 设置中包含 JDBC 驱动程序,并且需要配置另一个数据库连接,该连接指向与 R2DBC 相同的数据库。这两个要求都容易出错,因为它们需要配置为执行完全相同的操作。
如今,应用程序配置框架(Spring Boot、Micronaut、Quarkus)会在类路径中提供某个库时激活功能。配置 JDBC 驱动程序会启动应用程序不需要但在启动期间需要的启动功能,这有点浪费资源。
理想情况下,您配置一个单一的数据库连接技术,该技术可重复用于模式迁移和应用程序中的后续数据交互。
在我看来(粗略地浏览一下 R2DBC 网页的首页),R2DBC 的目标似乎与迁移没有任何关系。该页面列出的主要功能如下:
那里没有任何东西可以保证将 R2DBC 支持添加到像 Liquibase 这样的框架中。当前使用的 JDBC 驱动程序不会因使用非阻塞 API 而受到影响,实际上并不需要“反应式 API”,而且几乎可以肯定每个连接不需要多个线程。
迁移工具主要关注数据库的形状/结构而不是内容,而 R2DBC 则针对主要关注实际数据的应用程序。
总而言之,我看不出有人为什么不使用像 Liquibase 这样使用 JDBC 的迁移工具,因为他们的应用程序使用 R2DBC,而且我认为将 R2DBC 支持添加到像 Liquibase 这样的工具没有任何好处。
你可以试试我的包r2dbc-migrate。
在最小配置中(假设您使用的是 Spring Boot 2.3.0.M3),只需添加
<dependency>
<groupId>name.nkonev.r2dbc-migrate</groupId>
<artifactId>r2dbc-migrate-spring-boot-starter</artifactId>
<version>0.0.24</version>
</dependency>
到 pom.xml
然后在类路径中添加 .sql 文件,例如在/db/migration/
然后加
r2dbc.migrate.resourcesPath: classpath:/db/migration/*.sql
到您的 application.yml
如果有人遇到同样的问题并且不想使用maven-flyway-plugin
,请查看FlywayAutoConfiguration
课程。它有@Conditional(FlywayDataSourceCondition.class)
,里面有@ConditionalOnBean(DataSource.class)
。因此,底线是您应该提供一个非反应式数据库环境来使 Flyway 工作。最直接的解决方案是执行以下操作:
@Configuration
public class DataBaseConfig extends AbstractR2dbcConfiguration {
@Value("${spring.data.postgres.host}")
private String host;
@Value("${spring.data.postgres.port}")
private int port;
@Value("${spring.data.postgres.database}")
private String database;
@Value("${spring.data.postgres.username}")
private String username;
@Value("${spring.data.postgres.password}")
private String password;
@Bean
public DatabaseClient databaseClient() {
return DatabaseClient.create(connectionFactory());
}
@Bean
@Override
public PostgresqlConnectionFactory connectionFactory() {
PostgresqlConnectionConfiguration config = PostgresqlConnectionConfiguration.builder()
.host(host)
.port(port)
.database(database)
.username(username)
.password(password)
.build();
return new PostgresqlConnectionFactory(config);
}
@Bean
public DataSource dataSource() {
DataSourceBuilder dataSourceBuilder = DataSourceBuilder.create();
dataSourceBuilder.driverClassName("org.postgresql.Driver");
dataSourceBuilder.url("jdbc:postgresql://" + host + ":" + port + "/" + database);
dataSourceBuilder.username(username);
dataSourceBuilder.password(password);
return dataSourceBuilder.build();
}
}
我这样做是因为我不想:1)在每次启动时运行插件;2)在命令行中传递数据库属性
上面的两个答案都是正确的 - 只是想补充一点,如果您正在寻找快速简便的路径并且您正在使用 maven,那么 Flyway 可能是最方便的操作方式。
您只需要 Flyway Maven 插件、两个 pom 依赖项和迁移 sql 脚本。
例如。假设 spring - r2dbc - postgresql 您只需三个简单的步骤即可准备好迁移基础架构:
(1) 向资源中添加迁移脚本:
resources/db/migration/V1_init.sql
(2)在pom中添加两个依赖
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
</dependency>
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
</dependency>
(3) 和构建部分的一个插件定义:
<plugin>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-maven-plugin</artifactId>
<version>6.0.0-beta2</version>
</plugin>
现在您有一个要迁移的 Maven CLI 命令:
mvn flyway:migrate -Dflyway.url=jdbc:postgresql://localhost:5432/test -Dflyway.user=test -Dflyway.password=test
在此处查看更多 Flyway Maven 插件文档
拜托,最终有一个解决方案,至少是一个临时解决方案,因为还没有 Flyway 官方解决方案(我相信很快我们就会看到正式版本)。