flyway

是什么

数据库版本管理工具

官网

github

为什么

  • 自己写的SQL忘了在所有环境执行
  • 别人写的SQL我们不能确定是否都在所有环境执行了
  • 有人修改了已经执行过的SQL,期望再次执行
  • 需要新增环境做数据迁移
  • 每次发版需要手动控制先发DB版本,再发布应用版本

怎么做

集成依赖

1     
2
3
4
     
org.flywaydb
flyway-core

在项目resources中添加目录

1     
2
cd 你的目录/resources     
$ mkdir -p db/migration

在项目配置中添加flyway配置

1     
2
3
4
5
6
7
8
9
spring:     
flyway:
enabled: true
# 禁止清理数据库表
clean-disabled: true
# 如果数据库不是空表,需要设置成 true,否则启动报错
baseline-on-migrate: true
# 与 baseline-on-migrate: true 搭配使用
baseline-version: 0

命名规范

示例:

1     
2
3
V1.1.__description.sql     

R__description.sql

prefix:可配置,前缀标识,默认值 V 表示 Versioned,R 表示 Repeatable;

Version:标识版本号,由一个或多个数字构成,数字之间的分隔符可用点.或单下划线_;

separator:分隔符,默认是双下划线;

description:描述信息,文字之间可以用单下划线或空格分隔

suffix:可配置,后续标识,后续标识,默认为 .sql;

Versioned migration 用于版本升级,每个版本都有唯一的版本号并只能 apply 依次。(也就是V开头的)

Repeatable migration 是指可重复加载的 migration,可以重复修改内容使用一旦脚本的 checkksum 有变动,flyway 就会重新应用该脚本,它并不用于版本更新,这类的 migration 总是在 versioned migration 执行之后才被执行(R开头的)

spring配置

1     
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
flyway:     
#开启
enabled: true
#当迁移时发现目标schema非空,而且带有没有元数据的表时,是否自动执行基准迁移,默认false.
baseline-on-migrate: true
# 检测迁移脚本的路径是否存在,如不存在,则抛出异常
check-location: true
#sql脚本位置
locations: classpath:db/migration
#是否允许无序的迁移,默认false
out-of-order: false
#编码
encoding: UTF-8



# flyway.baseline-description对执行迁移时基准版本的描述.
# flyway.baseline-on-migrate当迁移时发现目标schema非空,而且带有没有元数据的表时,是否自动执行基准迁移,默认false.
# flyway.baseline-version开始执行基准迁移时对现有的schema的版本打标签,默认值为1.
# flyway.check-location检查迁移脚本的位置是否存在,默认false.
# flyway.clean-on-validation-error当发现校验错误时是否自动调用clean,默认false.
# flyway.enabled是否开启flywary,默认true.
# flyway.encoding设置迁移时的编码,默认UTF-8.
# flyway.ignore-failed-future-migration当读取元数据表时是否忽略错误的迁移,默认false.
# flyway.init-sqls当初始化好连接时要执行的SQL.
# flyway.locations迁移脚本的位置,默认db/migration.
# flyway.out-of-order是否允许无序的迁移,默认false.
# flyway.password目标数据库的密码.
# flyway.placeholder-prefix设置每个placeholder的前缀,默认${.
# flyway.placeholder-replacementplaceholders是否要被替换,默认true.
# flyway.placeholder-suffix设置每个placeholder的后缀,默认}.
# flyway.placeholders.[placeholder name]设置placeholder的value
# flyway.schemas设定需要flywary迁移的schema,大小写敏感,默认为连接默认的schema.
# flyway.sql-migration-prefix迁移文件的前缀,默认为V.
# flyway.sql-migration-separator迁移脚本的文件名分隔符,默认__
# flyway.sql-migration-suffix迁移脚本的后缀,默认为.sql
# flyway.tableflyway使用的元数据表名,默认为schema_version
# flyway.target迁移时使用的目标版本,默认为latest version
# flyway.url迁移时使用的JDBC URL,如果没有指定的话,将使用配置的主数据源
# flyway.user迁移数据库的用户名
# flyway.validate-on-migrate迁移时是否校验,默认为true.

  • 坑一:命名SQL文件问题

    没有按标准命名,导致执行不成功

  • 坑二:执行失败的文件,再次启动时执行不了,可以删除数据库中 flyway_schema_history表最后一条数据,然后再重启

  • 坑三:云家园装配后不生效,但maven可以生效,目前还在解决中。

竞品对比

nextep(开源)
http://www.nextep-softwares.com/

dbdeploy(开源)
http://dbdeploy.com/

Liquibase(开源)
http://www.liquibase.org/

Post Facto(开源)
http://www.post-facto.org/

下面是red gate公司的商业软件

SQL Source Control (商业软件)
http://www.red-gate.com/products/SQL_Source_Control/index.htm

参考文档

  • 官网
  • “ https://www.jianshu.com/p/567a8a161641"
  • “ https://blog.csdn.net/chenleiking/article/details/80691750"
  • “ https://segmentfault.com/a/1190000038960756"
  • “ https://juejin.cn/post/6844903802215071758"
  • “ https://blog.csdn.net/qq_33430083/article/details/105508025"
  • “ https://blog.51cto.com/u_15076233/4273411"
  • “ https://www.saoniuhuo.com/article/detail-30226.html"
  • 这个用的比较新的flyway
  • 知乎的这篇原理介绍还可以
  • 知乎的这篇讨论也有点意思,尤其是其中的其他链接
  • 这是要删库跑路的节奏啊
  • 这篇讲的实战中k8s结合flyway很高大上
  • 这篇中idea新建项目及sql文件命名讲的不错
  • 这就是我遇到的一个坑,自己创建映射目录时没注意
  • 这篇值得深入研究 比较数据版本控制工具-2020
  • 几个数据库的版本控制工具
  • 数据库版本控制工具介绍

你可能感兴趣的:(SQL,SQL,版本管理)