flyway版本号_数据库版本控制之flyway

一、Flyway

1.1 介绍

Flyway 是用来进行数据库的版本控制，帮助用户完成数据库迁移的工作。使用 Flyway ，用户可以从任意一个数据库版本迁移到最新版本，简单而且有效。

1.3 使用场景

适合团队共同维护数据库结构，而不是将数据库版本维护工作统一交给一个人处理。

方便为不同的环境，维护数据库版本

1.4 工作原理

1) 在数据库中维护一张名为 flyway_schema_history 的元数据表，里面存储着已执行的各个版本的记录；

2) 扫描系统文件或者应用的类路径中特定的文件，它们可以由 SQL 或 Java 编写。

3) 基于文件的版本号进行排序

4) 与元数据表进行校验，如果版本号低于或等于当前标记的版本,它们将被忽略，高于标记的文件将会被执行并更新元数据表

1.5 运行方式

基于命令行模式，用户从官网下载工具包，进行一些必要的配置，就可以通过命令行使用其功能。

基于Java API，用户可以将 Flyway 提供的第三方包加入 classpath，通过 Flyway 提供的 API 来使用其功能。

基于 Maven 或 Gradle，用户可以通过配置插件，运行 mvn 或 gradle 命令来使用其功能。

1.6 脚本文件命名规则

V__.sql

大写字母 V 开头

版本号，小版本号可以用下划线隔开，如 2_1

脚本名称，脚本名称和版本号之间以两个下划线隔开

文件后缀为 .sql

二、 基于 SpringBoot 下使用 flyway

2.1 引入 pom 依赖

org.flywaydb

flyway-core

6.5.7

org.springframework.boot

spring-boot-starter-jdbc

mysql

mysql-connector-java

runtime

2.2 创建脚本文件

flyway 默认存放路径是 src/main/resources/db/migration 这里我们采用自定义的目录

src/main/resources/db/dev/v1

在目录中新建 V1_1__createTable.sql 文件，内容如下:

CREATE TABLE `sys_user` (

`user_id` bigint(21) NOT NULL COMMENT '用户编码',

`user_name` varchar(50) DEFAULT NULL COMMENT '用户名',

PRIMARY KEY (`user_id`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2.3 配置应用属性

在 application.yml 文件中填写上数据库和 flyway 相关配置：

spring:

# flyway 相关配置

flyway:

# 启用 flyway

enabled: true

# 字符集编码

encoding: utf-8

# 脚本文件存放地址，默认存放地址为 classpath:db/migration

locations: classpath:db/dev

# 数据库相关配置

datasource:

driver-class-name: com.mysql.cj.jdbc.Driver

url: jdbc:mysql://localhost:3306/flyway_test?serverTimezone=UTC&useUnicode=true&useSSL=false&useUnicode=true&characterEncoding=utf8

username: root

password: sa000

2.4 启动应用

查看数据库，发现新增了如下两张表：

查看 flyway_schema_history 表：

可以看到执行的版本记录

三、 flyway 遇到的问题

3.1 在非空数据库下执行

默认情况下在非空数据库下执行，会抛出异常：

Caused by: org.flywaydb.core.api.FlywayException: Found non-empty schema(s) `test` but no schema history table. Use baseline() or set baselineOnMigrate to true to initialize the schema history table.

配置属性baseline-on-migrate 为 true 即可：

spring:

flyway:

# 在没有元数据表的情况下，针对非空Schema执行迁移时是否自动调用基线。 (默认值：false)

baseline-on-migrate: true

# 配合 baseline-on-migrate 使用,否则 V1 的版本不会执行

baseline-version=0: