欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

浅谈SpringBoot之开启数据库迁移的FlyWay使用

程序员文章站 2024-02-11 17:34:46
本文介绍了springboot开启数据库迁移的flyway使用,分享给大家,具体如下: 一,首先我先了解下flyway是如何运转的。 最简单的方案是将flyway指向一...

本文介绍了springboot开启数据库迁移的flyway使用,分享给大家,具体如下:

一,首先我先了解下flyway是如何运转的。

最简单的方案是将flyway指向一个空数据库。

浅谈SpringBoot之开启数据库迁移的FlyWay使用 

它将尝试找到其元数据表。当数据库为空时,flyway将不会找到它, 而是创建它。您现在拥有一个名为schema_version的单个空表的数据库 :

浅谈SpringBoot之开启数据库迁移的FlyWay使用 

该表将用于跟踪数据库的状态。之后,flyway将开始扫描应用程序的文件系统或类路径进行迁移。它们可以用sql或java编写。
然后根据其版本号对迁移进行排序,并按顺序应用:

浅谈SpringBoot之开启数据库迁移的FlyWay使用 

随着应用每个迁移,元数据表将相应更新:

schema_version

浅谈SpringBoot之开启数据库迁移的FlyWay使用 

随着元数据和初始状态的到位,我们现在可以谈论迁移到较新的版本。

flyway将再次扫描应用程序的文件系统或类路径进行迁移。根据元数据表检查迁移。如果版本号低于或等于标记为当前版本的版本号,则忽略它们。

剩余的迁移是挂起的迁移:可用但未应用。

浅谈SpringBoot之开启数据库迁移的FlyWay使用 

然后,他们通过版本号进行排序,并依次执行:

浅谈SpringBoot之开启数据库迁移的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为两款流行的数据库迁移库提供了自动配置支持。

  1. flyway()
  2. 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所示。

浅谈SpringBoot之开启数据库迁移的FlyWay使用 

所有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里的记录,跳过那些脚本。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。