老板：把数据库变更，给整利索了

老板：把数据库变更，给整利索了

经过千难万险的开发，系统终于上线了，进入了更加惊险刺激的捉虫阶段。在修修补补之中，给后人留下一堆屎山之前，我们需要把数据库给整利索了。

想想吧，我们在开发环境，修改了多个字段的名称，经历了测试环境的洗礼，还搞了个预上线接受变更。结果，仅仅在线上忘了操作其中一条SQL，就前功尽弃。如果你做的是项目类型的工作，客户半年六个月才升级一次，这些脚本的管理就会乱上加乱。

我们需要把这些数据库变更，使用git这样的工具管理起来，在系统启动的时候，能够自动变更。通过口口相传，太不可信了。

谁也不想背这个锅。翻聊天记录?有用么?都是事后诸葛亮。

人和动物的区别，就是使用工具。经常被使用的两个，有Liquibase和Flyway。但是，Liquibase的迁移脚本写起来太复杂，需要花很多时间维护，远不如Flyway这样的开箱即用(牺牲跨平台)。如果你的项目不是非常复杂，对Liquibase也不熟悉，建议直接选用flyway。

一般，数据库变更，会有下面几种语句，我们都可以使用flyway来完成。

DDL 建表和索引的时候，用到的语句，比如CREATE、ALTER、DROP等DML 就是一些常见的数据操作语句，比如update、delete、insertDCL 用来设置和管理权限方面信息的语句，比如grant、deny、revoke等

下面，就以flyway为例，来看一下数据库的版本，是如何变更的。

1. flyway migrate

首先，使用mvn的命令，创建一个示范项目。

mvn archetype:generate -B \ -DarchetypeGroupId=org.apache.maven.archetypes \     -DarchetypeArtifactId=maven-archetype-quickstart \     -DarchetypeVersion=1.1 \     -DgroupId=foo \     -DartifactId=bar \     -Dversion=1.0-SNAPSHOT \     -Dpackage=foobar

在pom.xml文件中加入下面的内容：

创建数据库变更目录。

mkdir -p src/main/resources/db/migration

创建新的数据库文件，我们把它叫做第一个版本：src/main/resources/db/migration/V1__Create_person_table.sql

create table PERSON (     ID int not null,     NAME varchar(100) not null );

使用mvn命令，即可完成数据库更新。不要怕，这个命令是幂等的。

mvn flyway:migrate

终端将输出下面的内容：

[INFO] Database: jdbc:h2:file:./target/foobar (H2 1.4) [INFO] Successfully validated 1 migration (execution time 00:00.009s) [INFO] Creating Schema History table: "PUBLIC"."flyway_schema_history" [INFO] Current version of schema "PUBLIC": << Empty Schema >> [INFO] Migrating schema "PUBLIC" to version 1 - Create person table [INFO] Successfully applied 1 migration to schema "PUBLIC" (execution time 00:00.038s)

下面，我们准备第二个变更，同样的，我们创建第二版本的文件：src/main/resources/db/migration/V2__Add_people.sql

下面是SQL文件的内容：

insert into PERSON (ID, NAME) values (1, 'Axel'); insert into PERSON (ID, NAME) values (2, 'Mr. Foo'); insert into PERSON (ID, NAME) values (3, 'Ms. Bar');

再次执行mvn flyway:migrate，可以发现第二版本的DML信息，已经被写入到数据库。

2. 如何工作?

那flyway是如何做到幂等的呢?我们使用DBeaver来打开这个h2文件。

在JDBC连接处，输入：jdbc:h2:/private/tmp/bar/target/foobar.mv.db;然后选择H2 Embedded模式。我们发现，数据库中除了用户创建的PERSON表，还多了一个叫做flyway_schema_history的表。

让我们see一see里面的内容。使用mvn flyway:info命令，能看到相同的内容。

可以看到，这个幂等操作，其实是由一张自动创建的状态表，来保证的。里面还躺着一个叫做checksum的字段，李曼存储的是一个CRC32值，用来判断你的SQL文件是否经过了非法篡改(篡改后将不予通过)。

捅破了这层窗户纸，一切神奇的事情忽然就变得豁然开朗。所以如果你想要用flyway，你的账户，应该起码给create table的权限，否则你就需要手动建这种表。

从上面的SQL文件定义，也可以看出来，这些文件，需要遵循一定的规律。大体如上图所示，包含：

前缀版本号分隔符版本描述

flyway就是靠这种约定，来进行库表变更的。所以，要严格按照它的要求去命名Sql文件。

3. SpringBoot项目集成

在pom中加入flyway的坐标。可以看到我们是没有提供版本号的，说明它已经在bom文件中定义过了。而它的autoconfigure，在SpringBoot的autoconfigure包里面默认提供了。

                 org.flywaydb          flyway-core              ... 

我们当然要看一下FlywayProperties这个文件所定义的配置项。可以看到它的前缀，就是spring.flyway。

默认的DB变更文件，放在classpath:db/migration，我们也可以通过locations配置自定义一个，比如classpath:cn/xjjdog/flyway。当然，也可以通过table属性，定义那张his表的名称。url、user、password这些，也可以提供，把his表存储在和业务表不一样的地方。如果不提供，将默认使用datasource所定义的库。

所以，最小配置，就是什么都不做，直接把变更文件，扔在变更目录下面就可以了。

spring:    datasource:        # jdbc配置... flyway:     enable: true     locations: classpath:cn/xjjdog/flyway

End

一根头发一寸金，寸金难买寸光阴。

随着时间的迁移，代码和sql，都会变成屎一样的东西。如何在软件的生命中周期结束之前，让我们的工程师，活的幸福一点，才是我们该做的。