About TestFlyway

软件开发时，随着项目的进展，数据库表结构等不可避免的会一直在变化。不断变化必然导致繁琐的工作，如果只需要支持一种数据库，最简单的就是直接改 Sql 脚本。但是如果要同时兼容多种数据库时，全靠手工去改的话，一没效率，二不能保证正确；

只需要维护一种数据库的时候，一般都是编写数据库 ER 图，然后导出 Sql 脚本；

以 Mysql 为例，可以用 Mysql WorkBench 设计数据库，然后导出 Mysql 脚本，最后导入数据库；

Mysql 创建表

使用 EER Diagram 可以很方便的管理各表的关系

当然这些还远远不够！

为了实现只需要维护一份数据库，必须有各数据库之间脚本转换工具 （主要是建表语句, 不是数据迁移）。

// TODO 已经在写，完善之后迁移到 Github

About Flyway

官网的介绍 *
Evolve your Database Schema easily and reliably across all your instances
大概意思是，可以在任何地方简单可靠地实现你的数据库版本演变

如何使用

具体怎么使用，不是本文重点，感兴趣可以去 Flyway 官网查看。

测试内容

主要测试 Flyway Migrate 功能对数据库脚本的转化 / 兼容能力；

Migrate 功能介绍

Sqlite sql to Sqlite Db

版本	主键	自增长	结果
V1__COMMON.sql	无	无	√
V2__KEY.sql	有	无	√
V3__KEYAndAI.sql	有	有	√

Sqlite 脚本详细

-- V1__COMMON.sql
CREATE TABLE TB_COMMON
(	
	ID INTEGER NOT NULL ,
	NAME VARCHAR(32) NOT NULL 

);

-- V2__KEY.sql
CREATE TABLE TB_KEY
(	
	ID INTEGER NOT NULL ,
	NAME VARCHAR(255) 
);

-- V3__KEYAndAI.sql
CREATE TABLE TB_KEY_AI
(	
	ID INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT ,
	NAME VARCHAR(255) 
);

测试结果详细

脚本 = sqlite, 版本 = v1, 结果 = true
脚本 = sqlite, 版本 = v2, 结果 = true
脚本 = sqlite, 版本 = v3, 结果 = true

Mysql sql to Sqlite Db

版本	主键	自增长	结果
V1__COMMON.sql	无	无	×
V2__KEY.sql	有	无	×
V3__KEYAndAI.sql	有	有	×

MySql 脚本详细

-- V1__COMMON.sql
CREATE TABLE TB_COMMON
(	
	ID INTEGER NOT NULL ,
	NAME VARCHAR(32) NOT NULL 

)
ENGINE = InnoDB
DEFAULT CHARACTER SET = gbk
COLLATE = gbk_chinese_ci;

-- V2__KEY.sql
CREATE TABLE TB_KEY
(	
	ID INTEGER NOT NULL ,
	NAME VARCHAR(255) ,
    PRIMARY KEY (ID)
)
ENGINE = InnoDB
DEFAULT CHARACTER SET = gbk
COLLATE = gbk_chinese_ci;

-- V3__KEYAndAI.sql
CREATE TABLE TB_KEY_AI
(	
	ID INTEGER NOT NULL AUTO_INCREMENT ,
	NAME VARCHAR(255) ,
    PRIMARY KEY (ID)
)
ENGINE = InnoDB
DEFAULT CHARACTER SET = gbk
COLLATE = gbk_chinese_ci;

测试结果详细

Migration V1__COMMON.sql failed
SQL State : null
Error Code : 1
Message : [SQLITE_ERROR] SQL error or missing database (near “ENGINE”: syntax error)
Location : db/migration/mysql/v1/V1__COMMON.sql (D:\Git_github_corningsun\test\flyway\source\target\classes\db\migration\mysql\v1\V1__COMMON.sql)
Line : 1
Statement : CREATE TABLE TB_COMMON
(
ID INTEGER NOT NULL ,
NAME VARCHAR(32) NOT NULL

)
ENGINE = InnoDB
DEFAULT CHARACTER SET = gbk
COLLATE = gbk_chinese_ci

脚本 = mysql, 版本 = v1, 结果 = false

Migration V2__KEY.sql failed
SQL State : null
Error Code : 1
Message : [SQLITE_ERROR] SQL error or missing database (near “ENGINE”: syntax error)
Location : db/migration/mysql/v2/V2__KEY.sql (D:\Git_github_corningsun\test\flyway\source\target\classes\db\migration\mysql\v2\V2__KEY.sql)
Line : 1
Statement : CREATE TABLE TB_KEY
(
ID INTEGER NOT NULL ,
NAME VARCHAR(255) ,
PRIMARY KEY (ID)
)
ENGINE = InnoDB
DEFAULT CHARACTER SET = gbk
COLLATE = gbk_chinese_ci

脚本 = mysql, 版本 = v2, 结果 = false

Migration V3__KEYAndAI.sql failed
SQL State : null
Error Code : 1
Message : [SQLITE_ERROR] SQL error or missing database (near “AUTO_INCREMENT”: syntax error)
Location : db/migration/mysql/v3/V3__KEYAndAI.sql (D:\Git_github_corningsun\test\flyway\source\target\classes\db\migration\mysql\v3\V3__KEYAndAI.sql)
Line : 1
Statement : CREATE TABLE TB_KEY_AI
(
ID INTEGER NOT NULL AUTO_INCREMENT ,
NAME VARCHAR(255) ,
PRIMARY KEY (ID)
)
ENGINE = InnoDB
DEFAULT CHARACTER SET = gbk
COLLATE = gbk_chinese_ci

脚本 = mysql, 版本 = v3, 结果 = false

测试总结

数据源只能是脚本文件 / Java 类，不支持连接数据库
使用脚本初始化数据库功能很好用
Sqlite 数据库脚本可以 migrate 到 Sqlite 数据库
Mysql 的数据库脚本无法 migrate 到 Sqlite 数据库
没有脚本转换的功能

对简单的建表语句支持还可以。但是主键、自增长、特殊字段等，兼容性不好；

测试用例下载

https://github.com/corningsun/test_Flyway