转:http://casheen.iteye.com/blog/1749916
1. 引言
想到要管理数据库的版本,是在实际产品中遇到问题后想到的一种解决方案,当时各个环境的数据库乱作一团,没有任何一个人(开发、测试、维护人员)能够讲清楚当前环境下的数据库是哪个版本,与哪个版本的应用相匹配,如何升级到与新版本的应用相匹配。
想到管理数据库版本时,先是心底形成了一个初步的解决方案,大致是通过数据库中的某张表来记录数据库表结构的历次更新与对应版本,在每次数据库表结构调整时除了提供库表更新sql ,还必须提供更新记录与对应版本的sql,以帮助维护数据库版本信息,并在遇到问题时提供相关的排查依据。
后来据此思路在网络上搜索了一把,结果搜到Liquibase (另一款开源数据库版本管理工具)。在学习了解Liquibase 的时候,经高手介绍又了解到了Flyway 这个项目的存在。经过一番了解,最后我们选择了Flyway ,主要原因是Flyway 支持sql 脚本,而Liquibase 只支持XML 方式的数据库表结构定义,虽然在新的版本中号称在XML 的数据库表结构定义方式中支持了sql 脚本。
虽然Flyway 的中文文档近乎为零,英文文档也凤毛麟角,但它却是我们最理想的数据库版本管理工具,它不但支持sql 脚本,还支持Java 代码直接操作数据库(在版本升级时做数据迁移相当有用),有Maven 插件,支持命令行(我们的平台数据库有部分由C 语言项目管理),而且在Spring 框架的配合下,很容易就能实现应用启动时自动检查并升级数据库的功能。
2. 什么是Flyway
Flyway 是独立于数据库的应用、管理并跟踪数据库变更的数据库版本管理工具。
Flyway 的项目主页是 http://flywaydb.org/ )(最近才迁移到这个主页,之前一直在googlecode 下管理http://code.google.com/p/flyway/ ),在项目的主页上可以看到Flyway 与几款主流数据库版本管理工具的特性对比列表。
3. 为什么使用Flyway
3.1. 我们遇到的问题
我们遇到的问题(以下内容来自Flyway 的一些英文文档,从中抽取出来的我们也遇到的一些主要问题):
- 不同的开发人员在开发产品特性时,都有可能更新数据库(添加新表,新的约束等)。当开发人员完成工作并提交代码时,代码会被合并到主分支并在测试服务器上执行单元测试与集成测试。我们在哪个环节来执行数据库的更新操作呢?由QA 部门手工执行sql 脚本?或者我们开发一断程序自动执行数据库更新?以什么顺序来执行这些更新脚本?这些问题同样存在于生产环境。
- 我们的产品部署在不同的客户服务器上,以及很多的测试、联调、实验局、销售环境上。不同的客户和测试环境上都部署着不同版本的产品。当他们需要升级他们的产品到新的版本时,我们不仅需要让他们的管理员可以升级产品到新的版本,同时需要保留他们的已有数据。在升级产品的步骤中,我们清楚地知道客户数据库的当前版本,以及需要在该数据库上执行哪些数据库更新脚本,来更新数据库表结构与数据库中已存在的数据。当升级完成时,数据库表结构及数据应当与升级后的产品版本保持一致。
- 有的时候,我们需要通过代码(Java )来维护一些已存在的数据,如通过代码来维护blob 类型的用户头像数据。
- 当升级失败时(比如在升级过程中出现网络连接失败),我们应当支持对失败进行修复。
3.2. Flyway 的特性
- 自动升级(自动发现更新项):Flyway 会将任意版本的数据库升级到最新版本。Flyway 可以脱离JVM 环境通过命令行执行,可以通过Ant 脚本执行,通过Maven 脚本执行(这样就可以在集成环境自动执行),并且可以在应用中执行(比如在应用启动时执行)。
- 规约优于配置:Flyway 有一套默认的规约,所以不需要修改任何配置就可以正常使用。
- 既支持SQL 脚本,又支持Java 代码:可以使用SQL 脚本执行数据库更新,也可以使用Java 代码来进行一些高级数据升级操作。
- 高可靠性:在集群环境下进行数据库升级是安全可靠的。
- 支持清除已存在的库表结构:Flyway 可以清除已存在的库表结构,可以从零开始搭建您的库表结构,并管理您的数据库版本升级工作。
- 支持失败修复。新的2.0 版本提供了repair 功能,用于解决数据库更新操作失败问题。
结合我们遇到的问题,与Flyway 所提供的特性,我们认为Flyway 是比较适合于我们的一款数据库版本管理工具。
4. 如何使用Flyway
使用Flyway ,我们需要准备Flyway 将要执行的数据库脚本(Flyway 支持sql 脚本与java 代码,这里认为在Flyway 下执行数据库更新操作的java 代码也是一种数据库脚本),然后通过Flyway 提供的几种不同运行方式来执行这些脚本。(以下配置参数说明基于Flyway 1.7 版本,新的2.0 版本在配置参数上有不少变动,与下面的介绍会有不少出入,以下说明仅供参考)
4.1. 数据库脚本
Flyway 的主要任务是管理数据库的版本更新,在Flyway 中称每次数据库更新为一个migration ,为了更顺口,我们下面称之为数据库脚本。Flyway 支持SQL-based migrations 和Java-based migrations 。
Flyway 支持的数据库脚本有sql 脚本与java 代码,sql 脚本即普通的sql 脚本,包含创建数据库、表,更新库表结构,数据插入、更新、删除等sql 语句,java 代码则是通过一个有效的数据源,使用java 语言来进行数据库的操作,这里针对的读者是对数据库操作有一定熟悉程度的群体,不再详细讲解如何编写数据库脚本。
Flyway 的sql 脚本与java 代码都遵循以下默认规约:
4.1.1. Flyway 默认规约
- SQL 脚本文件默认位置是项目的源文件夹下的db/migration 目录。
- Java 代码默认位于db.migration 包。
- SQL 脚本文件及Java 代码类名必须遵循以下命名规则:V<version>[_<SEQ>][__description] 。版本号的数字间以小数点(. )或下划线(_ )分隔开,版本号与描述间以连续的两个下划线(__ )分隔开。如V1_1_0__Update.sql 。Java 类名规约不允许存在小数点,所以Java 类名中版本号的数字间只能以下划线进行分隔。
4.2. Flyway 的几种运行方式
本章主要讲解我们常用的三种Flyway 的执行方式,Flyway 除了提供这三种执行方式外,还提供Ant 任务方式的执行方式,有兴趣的同学可以去官方网站获取相关信息,这里不进行描述。
4.2.1. 命令行方式
通过命令行方式运行Flyway ,需要下载flyway-commandline 版本并解压到本地,然后flyway (Windows下flyway.cmd ,Linux 下flyway.sh )命令执行Flyway 相关操作。
下图是flyway-commandline-1.7 解压后的目录结构:
命令行方式的特点与规约
- 无需安装JVM ,Maven ,Ant
- 默认读取conf/flyway.properties 中的配置信息,如果在命令行中指定参数,命令行中指定的参数将覆盖配置文件中的配置
- 还可以通过参数-configFlie=myFlyway.properties 来重新指定flyway 配置文件,可以通过-configFileEncoding=GBK 来指定配置文件的编码格式
- 可以将打包好的java 迁移文件放到jars/ 目录下让flyway 可以找到并运行
- 数据库驱动包(jar )放到jars/ 目录下
- sql 脚本文件放到sql/ 目录中
命令行方式运行的配置及使用方法
- 修改conf/flyway.properties 配置文件
- 拷贝数据库jdbc 驱动jar 到jars/ 目录
- 在sql/ 目录下创建配置好的sql 脚本文件目录路径,如flyway 默认的sql 文件路径为db/migration ,我们就需要在sql/ 目录下创建/db/migration 目录结构
- 将数据库维护脚本放到创建好的sql 脚本文件目录中(维护脚本文件名需要遵循命名规范)
- 在命令行执行命令(从flyway 安装目录开始执行)flyway init (初始化Flyway metadata )、flyway migrate(执行Flyway 升级操作)、flyway validate (校验Flyway 数据正确性)
4.2.2. Maven 插件
配置Maven 插件
- <plugin>
- <groupId>com.googlecode.flyway</groupId>
- <artifactId>flyway-maven-plugin</artifactId>
- <version>1.7</version>
- <dependencies>
- <dependency>
- <groupId>mysql</groupId>
- <artifactId>mysql-connector-java</artifactId>
- <version>${mysql.connector.version}</version>
- </dependency>
- </dependencies>
- <configuration>
- <driver>com.mysql.jdbc.Driver</driver>
- <url>jdbc:mysql://localhost/flywaydemo?useUnicode=true&characterEncoding=utf-8</url>
- <user>root</user>
- <password></password>
- <!-- 设置接受flyway进行版本管理的数据库,多个数据库以逗号分隔 -->
- <schemas>flywaydemo</schemas>
- <!-- 设置存放flyway metadata数据的表名 -->
- <table>schema_version</table>
- <!-- 设置flyway扫描sql升级脚本、java升级脚本的目录路径或包路径 -->
- <locations>
- <location>flyway/migrations</location>
- <location>com.kedacom.flywaydemo.migrations</location>
- </locations>
- <!-- 设置sql脚本文件的编码 -->
- <encoding>UTF-8</encoding>
- <!-- 设置执行migrate操作之前的validation行为 -->
- <validationMode>ALL</validationMode>
- <!-- 设置当validation失败时的系统行为 -->
- <validationErrorMode>FAIL</validationErrorMode>
- </configuration>
- </plugin>
上面的插件配置包含了几方面的配置信息:
- 声明插件
- 声明数据库驱动的依赖包
- Flyway 配置——数据库连接配置
- Flyway 配置——Flyway 参数与行为配置
执行Maven 命令进行Flyway 操作(下面列出几种常用的操作)
- mvn flyway:init (初始化Flyway metadata )
- mvn flyway:migrate (执行Flyway 升级操作)
- mvn flyway:validate (校验Flyway 数据正确性)
4.2.3. 在应用启动时自动运行(结合Spring )
定义在应用启动时自动运行Flyway 的Java 类,并实现其逻辑代码
- public class FlywayMigration {
- private DataSource dataSource;
- public void setDataSource(DataSource dataSource) {
- this.dataSource = dataSource;
- }
- public void migrate() {
- Flyway flyway = new Flyway();
- flyway.setDataSource(dataSource);
- flyway.setSchemas("flywaydemo"); // 设置接受flyway进行版本管理的多个数据库
- flyway.setTable("schema_version"); // 设置存放flyway metadata数据的表名
- flyway.setLocations("flyway/migrations", "com.kedacom.flywaydemo.migrations"); // 设置flyway扫描sql升级脚本、java升级脚本的目录路径或包路径
- flyway.setEncoding("UTF-8"); // 设置sql脚本文件的编码
- flyway.setValidationMode(ValidationMode.ALL); // 设置执行migrate操作之前的validation行为
- flyway.setValidationErrorMode(ValidationErrorMode.FAIL); // 设置当validation失败时的系统行为
- flyway.migrate();
- }
- }
在Spring 中根据上面实现的类来定义(实例化)一个bean
- <bean id="flywayMigration" class="com.kedacom.flywaydemo.FlywayMigration" init-method="migrate">
- <property name="dataSource" ref="dataSource" />
- </bean>
从上面的bean 定义中我们可以看到,我们为flywayMigration 这个bean 实例注入了一个数据源,Flyway 的所有操作将针对这个数据源进行;同时我们通过init-method 属性指定了Spring 在实例化该bean 以后,主动执行该bean的migrate 方法,而该方法内会执行Flyway 更新数据库的操作。
至此,我们达到了在应用启动时,Spring 实例化上下文的时候,在Spring 实例化flywayMigration 这个bean 的时候,自动执行Flyway 更新数据库的操作。
但是,我们还没有达到目的,万一Flyway 还在更新数据库,没有完成更新操作之前,应用程序的其他逻辑已经开始使用数据库进行其他操作了,会导致应用程序产生很多bug ,甚至根本运行不起来。
要解决这个问题,我们可以利用Spring 的bean 依赖原理,让关键的数据库操作bean 依赖于flywayMigration 这个bean ,达到在flywayMigration 没有实例化完成(数据库更新操作完成)之前,不能进行任何其他数据库相关操作。
利用Spring 的bean 依赖让flywayMigration 优先处理数据库更新操作
- <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate" depends-on="flywayMigration">
- <property name="dataSource" ref="dataSource" />
- </bean>
- <bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager" depends-on="flywayMigration">
- <property name="dataSource" ref="dataSource" />
- </bean>
5. 总结
本篇我们介绍了什么是Flyway ,为什么使用Flyway ,以及如何使用Flyway ,但实际产品/ 项目中的情况可能更复杂,仅靠对Flyway 技术使用上的了解并不能达到我们满意的解决方案,为此我将在下一篇中介绍我们结合项目实际的问题形成的一些基于Flyway 的数据库版本管理解决方案。下一篇的内容主要包括:
- 我们的项目中实际是如何使用 Flyway 的
- 如何在已有的项目中集成 Flyway
- 如何在多应用、跨平台、跨语言的环境中使用 Flyway
相关推荐
Flyway是一款开源的数据库版本管理工具,它更倾向于规约优于配置的方式。Flyway可以独立于应用实现管理并跟踪数据库变更,支持数据库版本自动升级,并且有一套默认的规约,不需要复杂的配置,Migrations可以写成SQL...
flyway-springboot.zip_springboot集成flyway数据库版本管理工具,用flyway,可以自动监控sql脚本的变化,实现sql脚本的版本管理
Flyway 是一款开源的数据库版本管理工具,它更倾向于规约优于配置的方式。Flyway 可以独立于应用实现管理并跟踪数据库变更,支持数据库版本自动升级,并且有一套默认的规约,不需要复杂的配置,Migrations 可以写成 ...
Flyway 是一款开源的数据库版本管理工具,它更倾向于规约优于配置的方式。Flyway 可以独立于应用实现管理并跟踪数据库变更,支持数据库版本自动升级,并且有一套默认的规约,不需要复杂的配置,Migrations 可以写成 ...
Flyway 是一款开源的数据库版本管理工具。它可以很方便的在命令行中使用,或者在Java应用程序中引入,用于管理我们的数据库版本。 在项目或产品中,很难一开始就把业务理清楚,把数据库表设计好,因此数据表也会在...
java实现的数据库版本管理工具,有效管理已存在的数据库,方便开发人员及维护人员的日常工作
[Flyway](https://link.zhihu.com/?target=https%3A//flywaydb.org/documentation/) 是一款开源的数据库版本管理工具。它可以很方便的在命令行中使用,或者在Java应用程序中引入,用于管理我们的数据库版本。
Flyway是独立于数据库的应用、管理并跟踪数据库变更的数据库版本管理工具。这篇文章主要介绍了flyway使用简介,需要的朋友可以参考下
NullPointerException 目标 目前暂时先以搭建一个完整的博客为主 ...项目管理工具:Gradle 数据库持久层:MyBaits 其他:lombok 服务器系统:CentOS 服务器:Nginx Servlet容器:Tomcat 结构 现在整
大屏设计(AJ-Report)是一个可视化拖拽编辑的,直观,酷炫,具有科技感的图表工具全开源项目。 内置的基础功能包括数据源,数据集,报表管理 SQL初始化 sql文件的目录在:report-core --> src --> main --> ...
Spring-ebean ebean-orm是个神奇的框架,他功能强大,又灵活多变,还保持了轻量级的体积。简单来讲,他相比于hibernate来说,他是小巧灵活的;相比mybatis来说,他支持jpa标准,意味着可以方便的使用...数据库管理工具
产品特点支持Spring和Spring Boot框架支持的版本是Spring 4.3.0+和Spring Boot 1.4.0+ 与Spring TestContext框架自动集成完全支持上下文缓存与Flyway数据库迁移工具无缝集成只需将@FlywayTest批注放置在测试类或方法...
flyway增加开关,解决部分版本不兼容问题,可自行执行数据库脚本 oracle.sql.TIMESTAMP 解析错误处理 时间格式显示优化 各模块编码限制,只能输入英文或数字 数据源、数据集选择框放大 演示环境通过导入新增一张...
该概念与其他数据库迁移工具(例如Liquibase或Flyway)非常相似,但不使用XML / JSON / YML文件。 请注意,索引是在后台构建的,以避免将数据库锁定在生产环境中。 变更集 更改日志示例显示: 创建不同类型的索引...
一个项目管理工具,它包含了我在各个团队中从事软件工作所学到的一切。 除了学习团队成员的专业知识并为相关人员分配相关任务外,Relay AI还考虑了每个人的工作量来计划任务,轻松跟踪在项目上花费的时间,并简化了...
Terraform Redshift提供程序 管理Redshift用户,组,特权,数据库和模式。... 请注意,这里的模式是最低级别的粒度,表应该由其他工具(例如flyway)创建。得到它: 下载适用于amd64(对于其他体系结构
使用Flyway工具完成数据库初始化建表并添加原始数据工作 版本2:每个类的逻辑尝试的少,将版本1的代码进行分解,分成一个独立的模块(高内聚,低转化)通过ORM(对象关系映射) 注意1:代码要小步迭代的更新 2,建立...
RESTful API,可让您管理仓库该项目使用Java和以下工具构建: 作为服务器端框架作为构建自动化工具为ORM / JPA实施作为数据库实现作为Hibernate的顶层作为数据库迁移工具作为动态查询的替代框架应用结构模型域模型是...
Flyway作为数据库迁移工具。 设计考虑 分开的管理和注册URL路径,以促进基于角色和特权的控制。 管理员的路径为/ admin,注册的路径为/ registration。 最初的实现使用README来记录API端点,这很麻烦。 将Swagger...
- **flywaydb** 以版本化的方式管理数据库脚本 - **thymeleaf** 模板框架,用于实现后台管理界面 - **Redis** 主要用作缓存实现 (暂未实现) - **lombok** ## 认证流程 **OAuth2**认证流程可参考博客 [理解OAuth ...