flyway

标签: SQL SQL 版本管理 | 发表时间:2022-03-30 10:44 | 作者:
出处:http://iwantjingjing.com/

是什么

数据库版本管理工具

官网

github

为什么

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

怎么做

集成依赖

1     
2
3
4
<dependency>     
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
</dependency>

在项目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

参考文档

相关 [flyway] 推荐:

flyway

- - I want jing jing
自己写的SQL忘了在所有环境执行. 别人写的SQL我们不能确定是否都在所有环境执行了. 有人修改了已经执行过的SQL,期望再次执行. 每次发版需要手动控制先发DB版本,再发布应用版本. 在项目resources中添加目录. cd 你的目录/resources. 在项目配置中添加flyway配置. # 如果数据库不是空表,需要设置成 true,否则启动报错.

flyway的使用

- - 行业应用 - ITeye博客
想到要管理数据库的版本,是在实际产品中遇到问题后想到的一种解决方案,当时各个环境的数据库乱作一团,没有任何一个人(开发、测试、维护人员)能够讲清楚当前环境下的数据库是哪个版本,与哪个版本的应用相匹配,如何升级到与新版本的应用相匹配. 想到管理数据库版本时,先是心底形成了一个初步的解决方案,大致是通过数据库中的某张表来记录数据库表结构的历次更新与对应版本,在每次数据库表结构调整时除了提供库表更新sql ,还必须提供更新记录与对应版本的sql ,以帮助维护数据库版本信息,并在遇到问题时提供相关的排查依据.

flyway中文教程

- - 研发管理 - ITeye博客
前言:最近工作上遇到个问题,项目开发过程中,开发代码可以通过svn来版本控制,但数据库又该如何来管理呢. 多个人接触数据库,当对表、字段或数据修改后,又怎么来同步呢. 经过苦寻,发现了个叫flyway的开源项目:http://flywaydb.org/,java编写,官方的介绍就是我的初衷,岂能不心动.

使用flyway对应用的数据库版本控制

- - Java - 编程语言 - ITeye博客
转载自:http://kkuang.net/why-db-migration-tools-flyway/  . 为什么要使用DB migration tools. 我们可以想象,多位开发人员,多个数据库环境. 先前有用过mybatis中的migration,但经常出现莫名其名的异常,并且也不支持多条SQL在1个文件中.

比较Flyway与Liquibase两大数据库迁移工具_Java

- -
众所周知,对于那些使用着关系型数据库引擎的各类应用程序而言,数据库迁移工具的选用是至关重要的. 它们不但能够让各种复杂且重复的过程更加自动化,而且可以让我们更加轻松且准确地完成各种大型的迁移任务. 下面,我将对两种最常见的开源迁移工具--Flyway和Liquibase,进行介绍与比较,以方便您在实际项目中做出合理的选择.

Spring Boot 2 实战:使用 Flyway 管理你数据库的版本变更 - SegmentFault 思否

- -
随着项目的不断迭代,数据库表结构、数据都在发生着变化. 甚至有的业务在多环境版本并行运行. 数据为王的时代,管理好数据库的版本也成为了迫切的需要. Git之类的版本控制工具来管理数据库. Liquibase来管理数据库版本. Flyway相对来说比较受欢迎. Flyway大受欢迎是因为它具有以下优点:.