建手机网站软件,建设通属于官方网站,英网站建设,广州比较好的网站设计1、简单介绍一下flyway
Flyway 是一款开源的数据库版本控制工具#xff0c;主要用于管理数据库结构的变更#xff08;如创建表、修改字段、插入数据等#xff09;。它通过跟踪和执行版本化的迁移脚本#xff0c;帮助团队实现数据库变更的自动化。接下来简单介绍一下flyway…1、简单介绍一下flyway
Flyway 是一款开源的数据库版本控制工具主要用于管理数据库结构的变更如创建表、修改字段、插入数据等。它通过跟踪和执行版本化的迁移脚本帮助团队实现数据库变更的自动化。接下来简单介绍一下flyway的工作流程
1.1、 初始化阶段 检查元数据表 Flyway 首先检查目标数据库中是否存在 flyway_schema_history 表默认表名称也可以自定义历史表名称。 不存在自动创建该表用于记录迁移历史 已存在读取已有迁移记录
千万不要手动的修改历史表的任何数据不然肯定会导致版本管理错误。
1.2、 迁移扫描 脚本加载 扫描配置的 locations 路径默认 classpath:db/migration识别两类脚本 版本化迁移脚本V 开头 可重复迁移脚本R 开头
1.3、校验阶段 校验 Checksum 对比已执行脚本的 checksum 与本地文件的 checksum 若已执行脚本的 checksum 发生变化 → 抛出错误防止篡改历史脚本 校验通过 → 进入迁移阶段
1.4、 迁移执行 版本化迁移 按版本号顺序执行所有 未应用 的 V 前缀脚本且 仅执行一次 可重复迁移 按文件名顺序执行 R 前缀脚本当脚本内容变化时 重新执行
1.5、 更新元数据
每个成功执行的脚本会被记录到 flyway_schema_history 表包含
版本号
脚本名称
checksum
执行时间
执行状态
如图就是一个默认的历史表中数据。 在这里详细解释一个flyway中的两种字母开头的执行脚本的不同
V 开头 vs R 开头脚本的区别
1. 版本化迁移脚本V 前缀 命名规则 VVersion__Description.sql例如 V1.2__Create_User_Table.sql Version唯一且不可变的版本号建议使用语义化版本如 1.0.1 Description人类可读的描述使用下划线分隔单词 核心特性 一次性执行每个脚本仅执行一次 顺序敏感按版本号顺序依次执行 内容不可变已执行的脚本内容不可修改否则校验失败 典型场景 创建/修改表结构 新增索引或约束 一次性数据迁移如初始化基础数据
2. 可重复迁移脚本R 前缀 命名规则 R__Description.sql例如 R__Update_Product_View.sql 没有版本号 Description描述脚本作用按字母顺序排序执行 核心特性 重复执行脚本内容变化时自动重新执行 顺序依赖按文件名字母顺序执行 内容可变允许修改后重新应用 典型场景 维护视图View或存储过程Stored Procedure 更新静态数据如多环境差异化配置 重建索引或物化视图
关键对比总结
特性V 前缀脚本R 前缀脚本执行次数仅一次内容变化时重复执行版本号必须唯一且递增无版本号内容修改禁止修改会导致校验失败允许修改触发重新执行执行顺序按版本号顺序按文件名字母顺序适用场景结构变更、一次性操作可重复逻辑、数据维护 最佳实践建议 版本化脚本 (V) 使用语义化版本如 V1.2.3 每个脚本完成一个独立的变更任务 禁止修改已提交到代码仓库的 V 脚本 可重复脚本 (R) 用于维护视图、存储过程等易变对象 通过文件名控制执行顺序如 R__01_ViewA.sql, R__02_ViewB.sql 谨慎修改生产环境的 R 脚本可能触发全量更新 混合使用策略 用 V 脚本管理表结构变更 用 R 脚本管理视图和存储过程
示例
db/migration/
├── V1.0__Create_Tables.sql
├── V1.1__Add_Indexes.sql
└── R__Update_Views.sql 校验保护 生产环境务必启用 validate-on-migrate: true 开发环境可开启 flyway.validate-migration-naming: true 强制命名校验
通过合理使用 V 和 R 脚本可以实现数据库变更的 原子性 和 可追溯性同时适应不同场景的灵活性需求。
2、使用spring boot项目整合flyway
2.1、新创建一个spring boot项目并导入一些初始的依赖 dependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactId/dependencydependencygroupIdorg.flywaydb/groupIdartifactIdflyway-core/artifactId!-- 无需指定版本Spring Boot 已管理 --/dependency!-- druid连接池 --dependencygroupIdcom.alibaba/groupIdartifactIddruid-spring-boot-starter/artifactIdversion1.2.18/version/dependency!-- MySQL--dependencygroupIdcom.mysql/groupIdartifactIdmysql-connector-j/artifactId/dependency!-- 无需指定版本Spring Boot 已管理 --dependencygroupIdorg.flywaydb/groupIdartifactIdflyway-mysql/artifactId/dependencydependencygroupIdorg.projectlombok/groupIdartifactIdlombok/artifactIdoptionaltrue/optional/dependencydependencygroupIdorg.mybatis.spring.boot/groupIdartifactIdmybatis-spring-boot-starter/artifactIdversion3.0.3/version/dependency/dependencies
需要注意的一点是spring官方自动管理的flyway的版本所以我们只需要指定spring的版本就自动会兼容合适的flyway版本我的spring boot版本为3.3.9
我们主要使用到的依赖有三个
flyway-coreflyway的核心依赖
flyway-mysql指定数据库的类型
mybatis-spring-boot-starter 数据源的自动配置也可以是其他的依赖坐标。不一定要是mybatis如JDBC、JPA等都可以
2.2、配置相应的yml配置文件
spring:datasource:type: com.alibaba.druid.pool.DruidDataSourcedriver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/testflyway?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneUTCusername: rootpassword: 123456flyway:enabled: truelocations: [classpath:db/migration] # 修正为数组格式table: flyway_schema_historybaseline-on-migrate: true # 必须启用处理已有表场景sql-migration-prefix: Vsql-migration-separator: __sql-migration-suffixes: [.sql] # 数组格式
logging:level:org.flywaydb: TRACE # 输出最详细日志
我们只需要配置一些flyway的属性就可以直接使用flyway了。
2.3、编写相应的sql执行语句并且存放在固定的文件地址
-- 创建用户表
CREATE TABLE IF NOT EXISTS user (id INT AUTO_INCREMENT PRIMARY KEY,username VARCHAR(50) NOT NULL UNIQUE,email VARCHAR(100) NOT NULL,created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);-- 初始数据插入
INSERT INTO user (username, email) VALUES(admin, adminexample.com),(user1, user1example.com);
我这里就创建了一张数据表并且插入了一些数据
将SQL脚本放在合适的位置 注意SQL脚本的存放位置不是乱放的要符合我们之前在yml配置文件中书写的配置SQL脚本的名称也不是随便取得要符合flyway的命名规范。
2.4、运行spring boot项目
我们配置好了这些之后就可以直接启动spring boot项目了。如果你是第一次启动项目flyway会自动扫描相应文件夹下的SQL脚本并在你的数据库中建立一个历史记录表 flyway_schema_history。要特别注意的是我们千万不要手动的修改这张表中的任何数据flyway就是根据这张历史记录表来进行SQL脚本的执行等等一系列操作。 我们可以直接在控制台中看到flyway已经顺利的执行我们相应的SQL脚本
我们现在可以连接一下数据库来看看是否正确 可以看到数据库中已经有了相应的数据表并且数据表中已经有了一些初始数据了
这个是我们第一次启动spring boot项目时自动执行的SQL脚本。那么等我们第二次启动时flyway还是会扫描相应的SQL脚本同时查询 flyway_schema_history 历史表来判断SQL脚本要不要执行。当我们在此运行spring boot项目 我们在控制台的日志中可以很清楚的看到flyway的执行过程。
3、总结
以上就是我们使用spring boot整合flyway来进行数据库的版本管理。总体来说是非常简单的我们只需要一些简单的配置和遵守一些flyway的命名规定就可以直接使用flyway了。这也是spring官方一直在努力推行的
约定大于配置配置大于编码
当然flyway的功能还有很多这篇文章也只是初步帮你认识一下flyway。并且使用spring boot来简单的使用flyway的基本功能但总的来说我们几乎可以只通过一些配置文件中属性来使用flyway的绝大部分功能一下我整理了一些常用的flyway属性供大家参考
spring:flyway:# 基础配置enabled: true # 是否启用 Flyway默认 trueurl: jdbc:mysql://localhost:3306/db # 覆盖默认数据库连接可选user: root # 覆盖默认数据库用户可选password: root # 覆盖默认数据库密码可选# 脚本管理locations: # 迁移脚本路径默认 classpath:db/migration- classpath:db/migrations- filesystem:/opt/migrationsencoding: UTF-8 # 脚本文件编码默认 UTF-8sql-migration-prefix: V # 版本迁移脚本前缀默认 Vrepeatable-sql-migration-prefix: R # 可重复迁移脚本前缀默认 Rsql-migration-separator: __ # 脚本名称分隔符默认双下划线sql-migration-suffixes: # 脚本后缀列表默认 [.sql]- .sql- .pgsql# 迁移规则schemas: public # Flyway 管理的 schema 列表逗号分隔table: flyway_history # 元数据表名默认 flyway_schema_historybaseline-on-migrate: false # 迁移时自动执行基线默认 falsebaseline-version: 1 # 基线版本号默认 1baseline-description: Initial Setup # 基线描述target: latest # 目标版本默认最新版本可用版本号如 3.1)out-of-order: false # 是否允许乱序执行迁移默认 falsevalidate-on-migrate: true # 迁移时校验脚本默认 trueignore-missing-migrations: false # 忽略缺失的迁移记录默认 false# 占位符配置placeholder-replacement: true # 启用占位符替换默认 trueplaceholders: # 自定义占位符键值对key1: value1key2: value2# 高级配置clean-on-validation-error: false # 校验失败时自动执行 clean危险默认 falseconnect-retries: 3 # 连接失败重试次数默认 0lock-retry-count: 50 # 获取锁的重试次数默认 50group: false # 将相同版本的迁移合并为单个事务默认 falsemixed: false # 是否允许混合 DDL 和 DML默认 falseskip-default-callbacks: false # 跳过默认回调默认 falseskip-default-resolvers: false # 跳过默认解析器默认 falseinit-sqls: # 获取连接后立即执行的 SQL 语句- SET ROLE myuser# 多环境配置示例
---
spring:profiles: prodflyway:url: jdbc:mysql://prod-db:3306/prod_dblocations:- classpath:db/migration/common- classpath:db/migration/prodignore-migration-patterns: *:pending 关键配置说明 基础配置默认会复用 spring.datasource 配置需要覆盖时单独指定 脚本管理通过前缀/后缀/路径控制脚本识别规则 迁移规则控制基线、校验、执行顺序等核心行为 生产环境注意事项 clean-on-validation-error 应始终保持 false out-of-order 需谨慎启用 建议明确指定 target 版本控制生产环境迁移 最佳实践 使用 classpath 和 filesystem 组合路径管理脚本 通过 placeholders 实现环境差异化配置 启用校验确保迁移安全
可以通过 flyway.validateMigrationNaming 配置项默认 false开启严格的脚本命名校验建议开发环境开启。
flyway的官网地址为https://flywaydb.org/
你有如果想了解更多有关flyway的信息可以直接访问官网 文章转载自： http://www.morning.qgkcs.cn.gov.cn.qgkcs.cn http://www.morning.yzxhk.cn.gov.cn.yzxhk.cn http://www.morning.cmhkt.cn.gov.cn.cmhkt.cn http://www.morning.llcgz.cn.gov.cn.llcgz.cn http://www.morning.jgrjj.cn.gov.cn.jgrjj.cn http://www.morning.lsqmb.cn.gov.cn.lsqmb.cn http://www.morning.qfdmh.cn.gov.cn.qfdmh.cn http://www.morning.tbqdm.cn.gov.cn.tbqdm.cn http://www.morning.qsyyp.cn.gov.cn.qsyyp.cn http://www.morning.irqlul.cn.gov.cn.irqlul.cn http://www.morning.rlxnc.cn.gov.cn.rlxnc.cn http://www.morning.lnckq.cn.gov.cn.lnckq.cn http://www.morning.qnqt.cn.gov.cn.qnqt.cn http://www.morning.gghhmi.cn.gov.cn.gghhmi.cn http://www.morning.gnjtg.cn.gov.cn.gnjtg.cn http://www.morning.huayaosteel.cn.gov.cn.huayaosteel.cn http://www.morning.jgzmr.cn.gov.cn.jgzmr.cn http://www.morning.srmpc.cn.gov.cn.srmpc.cn http://www.morning.jfbgn.cn.gov.cn.jfbgn.cn http://www.morning.lgqdl.cn.gov.cn.lgqdl.cn http://www.morning.fycjx.cn.gov.cn.fycjx.cn http://www.morning.ryfq.cn.gov.cn.ryfq.cn http://www.morning.qbkw.cn.gov.cn.qbkw.cn http://www.morning.sskns.cn.gov.cn.sskns.cn http://www.morning.zlcsz.cn.gov.cn.zlcsz.cn http://www.morning.daxifa.com.gov.cn.daxifa.com http://www.morning.cgdyx.cn.gov.cn.cgdyx.cn http://www.morning.jrkzk.cn.gov.cn.jrkzk.cn http://www.morning.mwmtk.cn.gov.cn.mwmtk.cn http://www.morning.bmgdl.cn.gov.cn.bmgdl.cn http://www.morning.mgfnt.cn.gov.cn.mgfnt.cn http://www.morning.haolipu.com.gov.cn.haolipu.com http://www.morning.fbmrz.cn.gov.cn.fbmrz.cn http://www.morning.mkxxk.cn.gov.cn.mkxxk.cn http://www.morning.nhpgm.cn.gov.cn.nhpgm.cn http://www.morning.cprbp.cn.gov.cn.cprbp.cn http://www.morning.xylxm.cn.gov.cn.xylxm.cn http://www.morning.drywd.cn.gov.cn.drywd.cn http://www.morning.smpb.cn.gov.cn.smpb.cn http://www.morning.khpx.cn.gov.cn.khpx.cn http://www.morning.mjtft.cn.gov.cn.mjtft.cn http://www.morning.knqck.cn.gov.cn.knqck.cn http://www.morning.snlxb.cn.gov.cn.snlxb.cn http://www.morning.flqkp.cn.gov.cn.flqkp.cn http://www.morning.qnpyz.cn.gov.cn.qnpyz.cn http://www.morning.snnwx.cn.gov.cn.snnwx.cn http://www.morning.jcrlx.cn.gov.cn.jcrlx.cn http://www.morning.mmqhq.cn.gov.cn.mmqhq.cn http://www.morning.hwhnx.cn.gov.cn.hwhnx.cn http://www.morning.mhbcy.cn.gov.cn.mhbcy.cn http://www.morning.nrll.cn.gov.cn.nrll.cn http://www.morning.nxtgb.cn.gov.cn.nxtgb.cn http://www.morning.jtjmz.cn.gov.cn.jtjmz.cn http://www.morning.smszt.com.gov.cn.smszt.com http://www.morning.prfrb.cn.gov.cn.prfrb.cn http://www.morning.jwsrp.cn.gov.cn.jwsrp.cn http://www.morning.kxscs.cn.gov.cn.kxscs.cn http://www.morning.kpygy.cn.gov.cn.kpygy.cn http://www.morning.bwmm.cn.gov.cn.bwmm.cn http://www.morning.nrlsg.cn.gov.cn.nrlsg.cn http://www.morning.hxhrg.cn.gov.cn.hxhrg.cn http://www.morning.pqwhk.cn.gov.cn.pqwhk.cn http://www.morning.rnyhx.cn.gov.cn.rnyhx.cn http://www.morning.zmlnp.cn.gov.cn.zmlnp.cn http://www.morning.ngznq.cn.gov.cn.ngznq.cn http://www.morning.jbmsp.cn.gov.cn.jbmsp.cn http://www.morning.sfwcx.cn.gov.cn.sfwcx.cn http://www.morning.rqgbd.cn.gov.cn.rqgbd.cn http://www.morning.hmnhp.cn.gov.cn.hmnhp.cn http://www.morning.kwpnx.cn.gov.cn.kwpnx.cn http://www.morning.pghry.cn.gov.cn.pghry.cn http://www.morning.lprfk.cn.gov.cn.lprfk.cn http://www.morning.pzrnf.cn.gov.cn.pzrnf.cn http://www.morning.rqmqr.cn.gov.cn.rqmqr.cn http://www.morning.lpsjs.com.gov.cn.lpsjs.com http://www.morning.lbrrn.cn.gov.cn.lbrrn.cn http://www.morning.cklld.cn.gov.cn.cklld.cn http://www.morning.webife.com.gov.cn.webife.com http://www.morning.nngq.cn.gov.cn.nngq.cn http://www.morning.frnjm.cn.gov.cn.frnjm.cn
