Spring Boot Flyway管理数据库版本 - josdem

19-01-17 banq
         

您知道在软件开发中使用版本控制的好处,例如GitSubversion。这次我将向您展示Flyway来管理数据库的版本控制,因此您可以使用Gradle和Spring Boot 轻松跟踪架构在所有环境中的演变。

让我们开始创建一个包含web和jpa依赖项的新Spring Boot项目:

spring init --dependencies=web,jpa --language=groovy --build=gradle spring-boot-flyway

这是生成的build.gradle文件:

buildscript {
  ext {
    springBootVersion = '1.5.12.RELEASE'
  }
  repositories {
    mavenCentral()
  }
  dependencies {
    classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
  }
}

apply plugin: 'groovy'
apply plugin: 'org.springframework.boot'

version = '0.0.1-SNAPSHOT'
sourceCompatibility = 1.8

repositories {
  mavenCentral()
}

dependencies {
  compile 'org.springframework.boot:spring-boot-starter-web'
  compile 'org.springframework.boot:spring-boot-starter-data-jpa'
  compile 'mysql:mysql-connector-java:5.1.34'
  compile 'org.codehaus.groovy:groovy'
  testCompile 'org.springframework.boot:spring-boot-starter-test'
}

然后让我们在gradle.properties添加Flyway插件来连接到MySQL数据库:

plugins {
  id "org.flywaydb.flyway" version "5.0.7"
}

flyway {
  url = 'jdbc:mysql://localhost:3306/flyway_demo'
  user = 'flywayUser'
  password = 'flywaySecret'
}

现在让我们创建第一个迁移src/main/resources/db/migration/V1__person_create.sql:

DROP TABLE IF EXISTS `person`;
CREATE TABLE `person` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `firstname` varchar(255) NOT NULL,
  `lastname` varchar(255) NOT NULL,
  PRIMARY KEY (`id`)
);

其次,让我们添加第二个迁移src/main/resources/db/migration/V2__person_insert.sql:

INSERT INTO `person` VALUES (1, 'Jose Luis', 'De la Cruz Morales'), (2, 'Eric', 'Haddad')

让我们运行Flyway来使用gradle迁移我们的数据库:

gradle flywayMigrate -i

如果一切顺利,您应该看到以下输出:

Flyway Community Edition 5.0.7 by Boxfuse
Database: jdbc:mysql://localhost:3306/flyway_demo (MySQL 5.7)
Successfully validated 2 migrations (execution time 00:00.039s)
Current version of schema `flyway_demo`: << Empty Schema >>
Migrating schema `flyway_demo` to version 1 - person create
Migrating schema `flyway_demo` to version 2 - person insert
Successfully applied 2 migrations to schema `flyway_demo` (execution time 00:00.985s)

我们可以在gradle 按照以下方式执行依赖于bootRun任务的flywayMigrate任务:

bootRun.dependsOn rootProject.tasks['flywayMigrate']

Flyway使用VX__description.sql约定名称。我们application.properties用来指定嵌入式数据库驱动程序类,凭证和ddl(数据定义语言)策略。

spring.datasource.url=jdbc:mysql://localhost:3306/flyway_demo
spring.datasource.username=flywayUser
spring.datasource.password=secret
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

spring.jpa.generate-ddl=false
spring.jpa.hibernate.ddl-auto=none

JPA具有DDL生成功能,可以将这些功能设置为在数据库启动时运行。这是通过前两个属性控制的:

  • spring.jpa.generate-ddl (布尔值)打开和关闭功能,与供应商无关。
  • spring.jpa.hibernate.ddl-auto(枚举)是一种Hibernate功能,它以更细粒度的方式控制行为。这个特点是:create,create-drop,validate,和update。

在生产中使用Flyway版本控制时,强烈建议您使用none或仅指定此属性。

这是我们的Person实体:

@Entity
class Person {

  @Id
  @GeneratedValue(strategy=AUTO)
  Long id

  @Column(nullable = false)
  String firstname

  @Column(nullable = false)
  String lastname

}

源码下载