浅谈SpringBoot之开启数据库迁移的FlyWay使用
本文介绍了springboot开启数据库迁移的flyway使用,分享给大家,具体如下:
一,首先我先了解下flyway是如何运转的。
最简单的方案是将flyway指向一个空数据库。
它将尝试找到其元数据表。当数据库为空时,flyway将不会找到它, 而是创建它。您现在拥有一个名为schema_version的单个空表的数据库 :
该表将用于跟踪数据库的状态。之后,flyway将开始扫描应用程序的文件系统或类路径进行迁移。它们可以用sql或java编写。
然后根据其版本号对迁移进行排序,并按顺序应用:
随着应用每个迁移,元数据表将相应更新:
schema_version
随着元数据和初始状态的到位,我们现在可以谈论迁移到较新的版本。
flyway将再次扫描应用程序的文件系统或类路径进行迁移。根据元数据表检查迁移。如果版本号低于或等于标记为当前版本的版本号,则忽略它们。
剩余的迁移是挂起的迁移:可用但未应用。
然后,他们通过版本号进行排序,并依次执行:
该元数据表进行更新,因此:
schema_version
就是这样!每当需要发展数据库时,无论是结构(ddl)还是参考数据(dml),只需创建一个版本号高于当前版本的新迁移。下一次flyway启动时,它会发现并相应地升级数据库。
二,flyway在spingboot的使用
一种途径是通过spring boot的spring.jpa.hibernate.ddl-auto属性将hibernate.hbm2ddl.auto属性设置为create、 create-drop或update。例如,要把hibernate.hbm2ddl.auto设置为create-drop,我们可以在application.yml里加入如下内容:
spring: jpa: hibernate: ddl-auto: create-drop
然而,这对生产环境来说并不理想,因为应用程序每次重启数据库, schema就会被清空,从头开始重建。它可以设置为update,但就算这样,我们也不建议将其用于生产环境。
还有一个途径。我们可以在schema.sql里定义schema。在第一次运行时,这么做没有问题,但随后每次启动应用程序时,这个初始化脚本都会失败,因为数据表已经存在了。这就要求在书写初始化脚本时格外注意,不要重复执行那些已经做过的工作。
一个比较好的选择是使用数据库迁移库(database migration library)。它使用一系列数据库脚本,而且会记录哪些已经用过了,不会多次运用同一个脚本。应用程序的每个部署包里都包含了这些脚本,数据库可以和应用程序保持一致。spring boot为两款流行的数据库迁移库提供了自动配置支持。
- flyway()
- liquibase()
当你想要在spring boot里使用其中某一个库时,只需在项目里加入对应的依赖,然后编写脚本就可以了。让我们先从flyway开始了解吧。
1. 用flyway定义数据库迁移过程
flyway是一个非常简单的开源数据库迁移库,使用sql来定义迁移脚本。它的理念是,每个脚本都有一个版本号, flyway会顺序执行这些脚本,让数据库达到期望的状态。它也会记录已执行的脚本状态,不会重复执行。在阅读列表应用程序这里,我们先从一个没有数据表和数据的空数据库开始。因此,这个脚 本里需要先创建reader和book表,包含外键约束和初始化数据。代码清单8-2就是从空数据库到 可用状态的flyway脚本。
flyway数据库初始脚本
create table reader ( id serial primary key, username varchar(25) unique not null, password varchar(25) not null, fullname varchar(50) not null ); create table book ( id serial primary key, author varchar(50) not null, description varchar(1000) not null, isbn varchar(10) not null, title varchar(250) not null, reader_username varchar(25) not null, foreign key (reader_username) references reader(username) ); create sequence hibernate_sequence; insert into reader (username, password, fullname) values ('craig', 'password', 'craig walls');
如你所见, flyway脚本就是sql。让其发挥作用的是其在classpath里的位置和文件名。flyway脚本都遵循一个命名规范,含有版本号,具体如图8-1所示。
所有flyway脚本的名字都以大写字母v开头,随后是脚本的版本号。后面跟着两个下划线和对脚本的描述。因为这是整个迁移过程中的第一个脚本,所以它的版本是1。描述可以很灵活,主要用来帮助理解脚本的用途。稍后我们需要向数据库添加新表,或者向已有数据表添加新字段。可以再创建一个脚本,标明版本号为2。flyway脚本需要放在相对于应用程序classpath根路径的/db/migration路径下。因此,项目中, 脚本需要放在src/main/resources/db/migration里。你还需要将spring.jpa.hibernate.ddl-auto设置为none,由此告知hibernate不要创建数据表。这关系到application.yml中的如下内容:
spring: jpa: hibernate: ddl-auto: none
剩下的就是将flyway添加为项目依赖。在gradle里,此依赖是这样的:
compile(“org.flywaydb:flyway-core”)
在maven项目里, 是这样的:
<dependency> <groupid>org.flywayfb</groupid> <artifactid>flyway-core</artifactid> </dependency>
在应用程序部署并运行起来后, spring boot会检测到classpath里的flyway,自动配置所需的 bean。 flyway会依次查看/db/migration里的脚本,如果没有执行过就运行这些脚本。每个脚本都执行过后,向schema_version表里写一条记录。应用程序下次启动时,flyway会先看schema_version里的记录,跳过那些脚本。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。