Flyway 数据库版本控制

1. Flyway简介

Flyway是一款有Boxfuse（现Redgate）公司开发并维护的开源数据库版本管理工具，它通过版本化的方式管理数据库的变更和迁移，帮助开发者在不同环境建保持数据库的同步，减少手工操作，降低遗漏的风险。

举个例子：在开发环境对某个表新增了一个字段，而提交测试时却忘了提交该sql脚本，导致出现bug而中断测试，从而会影响开发、测试的工作效率

有了Flyway，我们可以按版本约定，统一管理所有的SQL脚本并更，在所有环境自动同步数据库，而无需人为手动控制，再也不用担心因数据库不同步而导致的各种环境问题

2. 代码工程

1. 引入pom

   <dependency>
     <groupId>org.flywaydb</groupId>
     <artifactId>flyway-core</artifactId>
   </dependency>

2. application.yml

   server:
     port: 8088
   spring:
     # flyway 配置
     flyway:
       # 开启 flyway
       enabled: true
       # 是否禁用数据库清理
       clean-disabled: true
       # SQL 迁移的编码
       encoding: UTF-8
       # 迁移脚本的位置，默认 db/migration.
       locations: classpath:db/migration
       # SQL 迁移的文件名前缀。
       sql-migration-prefix: V
       # SQL 迁移的文件名分隔符。
       sql-migration-separator: __
       # SQL 迁移的文件名后缀。
       sql-migration-suffixes: .sql
       # 是否在执行迁移时自动调用验证。
       validate-on-migrate: true
       # 迁移时发现目标 schema 非空，而且带有没有元数据的表时，是否自动执行基准迁移，默认 false.
       baseline-on-migrate: true
       # JDBC驱动程序的完全限定名称
       #driver-class-name: com.mysql.cj.jdbc.Driver
       #要迁移的数据库URL，默认未设置，则使用主要配置的数据源
       url: jdbc:mysql://localhost:3306/demo?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT
       #要迁移的数据库登陆密码
       password: xiaoyuge
       #要迁移的数据库用户
       user: root
     #mysql配置
     datasource:
       url: jdbc:mysql://localhost:3306/demo?useSSL=false&autoReconnect=true&characterEncoding=utf8
       driver-class-name: com.mysql.cj.jdbc.Driver
       username: root
       password: xiaoyuge

3. 在resources下面创建db/migration文件夹，并编写迁移脚本V1__create_user_version.sql和V1_1__alter_table_user.sql

   Flyway要求迁移脚本按照特定的命名规则进行命名，通常是：V{版本号}__{描述}.sql的格式。

   • Versioned用来进行常规版本升级
   • Undo用来进行回滚，不建议使用
   • Repeatable是可重复执行的sql，每次初始化都会执行

   例如：

    V1__create_user_version.sql： 表示创建表
    V1_1__alter_table_user.sql： 表示修改表结构
   

   

4. 在V1__create_user_version.sql 里面创建表

   DROP TABLE IF EXISTS user ;
   CREATE TABLE `user` (
       `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
       `name` varchar(20) NOT NULL COMMENT '姓名',
       `age` int(5) DEFAULT NULL COMMENT '年龄',
       PRIMARY KEY (`id`)
   ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

5. 在V1_1__alter_table_user.sql修改表结构

   ALTER TABLE `user` ADD COLUMN `address` VARCHAR(20) DEFAULT NULL;

6. 启动程序,第二次并不会执行2个脚本，它会从上次的版本号开始往后执行

   o.f.c.internal.license.VersionPrinter    : Flyway Community Edition 6.4.4 by Redgate
   o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://localhost:3306/demo (MySQL 8.0)
   o.f.core.internal.command.DbValidate     : Successfully validated 2 migrations (execution time 00:00.011s)
   o.f.c.i.s.JdbcTableSchemaHistory         : Creating Schema History table `demo`.`flyway_schema_history` ...
   o.f.core.internal.command.DbMigrate      : Current version of schema `demo`: << Empty Schema >>
   o.f.core.internal.command.DbMigrate      : Migrating schema `demo` to version 1 - user version
   o.f.c.i.s.DefaultSqlScriptExecutor       : DB: Unknown table 'demo.user' (SQL State: 42S02 - Error Code: 1051)
   o.f.c.i.s.DefaultSqlScriptExecutor       : DB: Integer display width is deprecated and will be removed in a future release. (SQL State: HY000 - Error Code: 1681)
   o.f.c.i.s.DefaultSqlScriptExecutor       : DB: Integer display width is deprecated and will be removed in a future release. (SQL State: HY000 - Error Code: 1681)
   o.f.core.internal.command.DbMigrate      : Migrating schema `demo` to version 1.1 - alter table user
   o.f.core.internal.command.DbMigrate      : Successfully applied 2 migrations to schema `demo` (execution time 00:00.057s)
   o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8088 (http) with context path ''
   org.example.App    : Started App in 1.884 seconds (JVM running for 2.298)

7. 查看数据库