flyway数据库表自动同步更新

Flyway是一款开源的数据库版本管理工具,简化了数据库迁移过程。通过在SpringBoot项目中引入Flyway,配置相关属性并放置SQL脚本,实现自动化数据库同步。遵循特定命名规则的SQL脚本在项目启动时执行,确保数据库与代码同步。遇到问题时,可通过调整Flyway配置或清理历史记录解决。使用Flyway避免手动管理数据库结构,提升开发效率。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

官方文档:Documentation - Flyway by Redgate • Database Migrations Made Easy.icon-default.png?t=M4ADhttps://flywaydb.org/documentation/

1.Flyway是什么?能有什么用?

Flyway是一款开源的数据库版本管理工具,它更倾向于规约优于配置的方式。

能够实现数据库表自动同步更新,减少人工管理sql的压力,减少人为操作,降低人工时间成本,极大的提升代码的部署、测试的自动化流转效率,更快的发现开发过程中的问题,进而可以提升代码质量和效率。

2.SpringBoot项目怎么使用Flyway?

1. pom.xml引入jar

    <!--引入flyway-->
    <dependency>
         <groupId>org.flywaydb</groupId>
         <artifactId>flyway-core</artifactId>
         <version>5.2.4</version>
    </dependency>

2.在application.properties添加Flyway配置:

spring:
  # 数据库连接配置
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/flyway?characterEncoding=utf-8&useSSL=false&serverTimezone=GMT%2B8
    username: xxx
    password: xxx
  flyway:
    # 是否启用flyway
    enabled: true
    # 编码格式,默认UTF-8
    encoding: UTF-8
    # 迁移sql脚本文件存放路径,默认db/migration
    locations: classpath:db/migration
    # 迁移sql脚本文件名称的前缀,默认V
    sql-migration-prefix: V
    # 迁移sql脚本文件名称的分隔符,默认2个下划线__
    sql-migration-separator: __
    # 迁移sql脚本文件名称的后缀
    sql-migration-suffixes: .sql
    # 迁移时是否进行校验,默认true
    validate-on-migrate: true
    # 当迁移发现数据库非空且存在没有元数据的表时,自动执行基准迁移,新建schema_version表
    baseline-on-migrate: true

3.根据在配置文件的脚本存放路径的配置,在resource目录下建立文件夹db/migration

版本号命名规则:flyway 执行的 SQL 脚本必须遵循一种命名规则,V<VERSION>__<NAME>.sql 首先是 V ,然后是版本号,如果版本号有多个数字,使用"_"分隔或者".",比如1_0_0版本号的后面是 2 个下划线"__",或者1.0.0版本号后面2个下划线"__",最后是 SQL 脚本的名称。

注意📢:

V 开头的只会执行一次,下次项目启动不会执行,也不可以修改原始文件,否则项目启动会报错,如果需要对 V 开头的脚本做修改,如果有个 SQL 脚本需要在每次启动的时候都执行,那么将 V 改为 R 开头即可。即随着项目启动,V开头只执行一次,R开头可以重复执行。

使用flyway创建表后,就不要再去数据库手动改这张表的结构了,一切表的结构改动都用flyway,否则会影响修改记录,导致项目报错

上述两种情况的解决方案:找到flyway_schema_history表,删除对应的记录即可。

4.项目启动后,flyway_schema_history该表记录版本号的sql执行记录

sql中的insert语句已经插入到对应数据库表中。

 

success!

 

 

### Flyway 数据库迁移使用指南 #### 创建并初始化项目环境 为了使Flyway能够正常工作,在项目环境中需配置好相应的依赖项。对于Maven项目,可以在`pom.xml`文件中加入如下依赖: ```xml <dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-core</artifactId> <version>${flyway.version}</version> </dependency> ``` 当首次运行Flyway指向一个空数据库时,将会自动创建名为`flyway_schema_history`的格用于记录每次执行过的SQL脚本及其状态信息[^1]。 #### 编写迁移脚本 所有的迁移脚本应放置于特定目录下,默认路径为`src/main/resources/db/migration`。这些脚本按照命名约定编写,通常格式为`V__Description.sql`,其中`V`代版本号,而`Description`是对该次变更简单描述的文字说明。例如: - `V1__Create_person_table.sql`: 定义了创建人员表结构; - `V2__Add_age_column_to_person.sql`: 向已有人员增加年龄字段; 每条语句都应当独立成行,并且确保语法正确无误以便顺利通过解析器验证。 #### 执行迁移命令 可以通过多种方式触发实际的数据迁移过程,比如直接调用API接口、利用Spring Boot内置支持或是借助CLI客户端工具完成操作。下面给出一段基于Java代码实现的例子: ```java import org.flywaydb.core.Flyway; public class DatabaseMigration { public static void main(String[] args){ Flyway flyway = new Flyway(); flyway.setDataSource("jdbc:mysql://localhost:3306/mydb", "root", ""); flyway.migrate(); // 开始执行所有待处理的任务 } } ``` 一旦启动应用程序之后,Flyway便会依据之前提到的那个历史日志去判断哪些更新尚未被执行过,从而依次应用它们直至最新版为止[^3]。 如果遇到诸如校验和不一致等问题,则可能是因为修改后的脚本破坏了原有的哈希值计算结果所致。此时可以考虑清理缓存重新生成新的校验码或者干脆删除旧有的记录让系统重头再来一次完整的同步动作[^2]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值