太强了!这两款数据库中间件,完美解决 Spring Boot 数据库的版本管理!

Spring Boot集成Quartz:使用Flyway自动化数据库表初始化实战 在Java企业级应用开发中,任务调度是支撑后台作业、定时处理的核心组件。Quartz作为业界广泛采用的调度框架,其持久化机制依赖数据库存储任务状态,确保集群环境下的高可用性。通过JDBC JobStore,Quartz将调度器、触发器与任务详情映射为结构化数据表,实现了任务状态的可靠存储与恢复。为提升部署效率与维护一致性,数据库迁移工具如Flyway应运而生,它通过版本化SQL脚本管理数据库结构变更,使表结构创建与升级过程可追溯、可重复。本文聚焦于Spring Boot项目中,如何整合Flyway与Quar 阅读详情

点击上方“芋道源码”,选择“设为星标”

管她前浪,还是后浪?

能浪的浪,才是好浪!

每天 8:55 更新文章,每天掉亿点点头发...

源码精品专栏

 
“

摘要: 原创出处 http://www.iocoder.cn/Spring-Boot/database-version-control/ 「芋道源码」欢迎转载,保留摘要,谢谢!

  • 1. 概述

  • 2. Flyway

  • 3. Liquibase

  • 666. 彩蛋


“

本文在提供完整代码示例,可见 https://github.com/YunaiV/SpringBoot-Labs 的 lab-20 目录。

原创不易,给点个 Star 嘿,一起冲鸭!

1. 概述

在我们的认知中,我们会使用 SVN 或 Git 进行代码的版本管理。但是,我们是否好奇过,数据库也是需要进行版本管理的呢?

在每次发版的时候,我们可能都会对数据库的表结构进行新增和变更,又或者需要插入一些初始化的数据。而我们的环境不仅仅只有一套,一般来说会有 DEV、UAT、PRED、PROD 四套环境,会对应 DEV、UAT、PROD 三个数据库。

“

PROD 环境,一般连接 PROD 数据库,做准生产的验收。

那么,就意味着我们需要对 DEV、UAT、PROD 数据库都做一遍操作。“人,是系统最大的 BUG”。很多时候,我们并不能保证像机器一样,每次都操作都正确,这就导致在不同的环境下,因为数据的每个版本的初始化,带来额外的验收成本。

甚至说,因为我们常常是手动操作 DEV 数据库,没有整理一个完整清单,保证我们在 UAT、PROD 数据库中执行相同的操作。

基于以上种种,如果我们能像管理代码版本一样,来管理我们的数据库版本,是不是这些问题可以得到很好的解决?答案是,绝大多数是的。

目前,技术社区已经提供了很多解决方案。例如说:

  • Flyway

  • Liquibase

  • dbdeploy

  • SQL Source Control

  • dbv

  • MyBatis Migrations

在 Spring Boot 项目中,提供了对 Flyway 和 Liquibase 的内置支持,所以在有数据库版本的需求时,肯定是推荐它们两。

本文,我们会对 Flyway 和 Liquibase 进行入门学习。这样,我们在学习它们的同时,可以有比较直观的使用感受,方便后续我们对它们进行选型。

2. Flyway

“

示例代码对应仓库:lab-20-database-version-control-flyway 。

在 Flyway 的官网 https://flywaydb.org/ 中,对自己的介绍是:

“

Version control for your database.

数据库的版本管理。

Flyway 支持的数据库,主要是关系数据库。如下图所示:

Flyway 提供了 SQL-based migrations 和 Java-based migrations 两种数据库变更方式。

  • 前者使用简单,无需编写 Java 代码。

  • 后者需要使用 Java 编写代码,胜在灵活。

一般情况下,如果是做表的变更,或者记录的简单插入、更新、删除等操作,使用 SQL-based migrations 即可。

复杂场景下,我们可能需要关联多个表,则需要通过编写 Java 代码,进行逻辑处理,此时就是和使用 Java-based migrations 了。

下面,让我们来使用它们二者,更好的体会它们的区别。

2.1 引入依赖

在 pom.xml 文件中,引入相关依赖。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>lab-20-database-version-control-flyway</artifactId>

    <dependencies>
        <!-- 实现对数据库连接池的自动化配置 -->
        <!-- 同时,spring-boot-starter-jdbc 支持 Flyway 的自动化配置 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency> <!-- 本示例,我们使用 MySQL -->
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>

        <!-- Flyway 依赖 -->
        <dependency>
            <groupId>org.flywaydb</groupId>
            <artifactId>flyway-core</artifactId>
        </dependency>
    </dependencies>

</project>

具体每个依赖的作用,胖友自己认真看下艿艿添加的所有注释噢。

2.2 应用配置文件

在 resources 目录下,创建 application.yaml 配置文件。配置如下:

spring:
  # datasource 数据源配置内容,对应 DataSourceProperties 配置属性类
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/lab-20-flyway?useSSL=false&useUnicode=true&characterEncoding=UTF-8
    driver-class-name: com.mysql.jdbc.Driver
    username: root # 数据库账号
    password: # 数据库密码
  # flyway 配置内容,对应 FlywayAutoConfiguration.FlywayConfiguration 配置项
  flyway:
    enabled: true # 开启 Flyway 功能
    cleanDisabled: true # 禁用 Flyway 所有的 drop 相关的逻辑,避免出现跑路的情况。
    locations: # 迁移脚本目录
      - classpath:db/migration # 配置 SQL-based 的 SQL 脚本在该目录下
      - classpath:cn.iocoder.springboot.lab20.databaseversioncontrol.migration # 配置 Java-based 的 Java 文件在该目录下
    check-location: false # 是否校验迁移脚本目录下。如果配置为 true ,代表需要校验。此时,如果目录下没有迁移脚本,会抛出 IllegalStateException 异常
    url: jdbc:mysql://127.0.0.1:3306/lab-20-flyway?useSSL=false&useUnicode=true&characterEncoding=UTF-8 # 数据库地址
    user: root # 数据库账号
    password: # 数据库密码
  • spring.datasource 配置项,设置数据源的配置。这里暂时没有实际作用,仅仅是为了项目不报数据源的错误。

  • spring.flyway 配置项,设置 Flyway 的属性,而后可以被 FlywayAutoConfiguration 自动化配置。

    • 每个配置项的作用,胖友自己看下注释。更多的配置项,可以看看 《Spring Boot 配置属性详解 -- Migration》 文章。

    • 重点看下 locations 配置项,我们分别设置了 SQL 和 Java 迁移脚本的所在目录。

2.3 Application

创建 Application.java 类,配置 @SpringBootApplication 注解即可。代码如下:

// Application.java

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        // 启动 Spring Boot 应用
        SpringApplication.run(Application.class, args);
    }

}

启动项目。执行日志如下:

// Flyway 的信息
2019-11-16 13:42:34.454  INFO 59115 --- [           main] o.f.c.internal.license.VersionPrinter    : Flyway Community Edition 5.2.4 by Boxfuse
2019-11-16 13:42:34.619  INFO 59115 --- [           main] o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://127.0.0.1:3306/lab-20-flyway (MySQL 8.0)
2019-11-16 13:42:34.643  WARN 59115 --- [           main] o.f.c.i.s.classpath.ClassPathScanner     : Unable to resolve location classpath:db/migration
// 发现 0 个迁移脚本。
2019-11-16 13:42:34.657  INFO 59115 --- [           main] o.f.core.internal.command.DbValidate     : Successfully validated 0 migrations (execution time 00:00.004s)
// 创建 flyway_schema_history 表
2019-11-16 13:42:34.671  INFO 59115 --- [           main] o.f.c.i.s.JdbcTableSchemaHistory         : Creating Schema History table: `lab-20-flyway`.`flyway_schema_history`
// 打印当前数据库的迁移版本
2019-11-16 13:42:34.702  INFO 59115 --- [           main] o.f.core.internal.command.DbMigrate      : Current version of schema `lab-20-flyway`: << Empty Schema >>
// 判断,没有需要迁移的脚本
2019-11-16 13:42:34.702  INFO 59115 --- [           main] o.f.core.internal.command.DbMigrate      : Schema `lab-20-flyway` is up to date. No migration necessary.
// 启动项目完成
2019-11-16 13:42:34.759  INFO 59115 --- [           main] c.i.s.l.d.Application                    : Started Application in 1.2 seconds (JVM running for 1.596)
  • 看下艿艿在日志内容上的注释。

在启动的日志中,我们看到 Flyway 会自动创建 flyway_schema_history 表,记录 Flyway 每次迁移( migration )的历史。表结构如下:

CREATE TABLE `flyway_schema_history` (
  `installed_rank` int(11) NOT NULL, -- 安装顺序,从 1 开始递增。
  `version` varchar(50) COLLATE utf8mb4_bin DEFAULT NULL, -- 版本号
  `description` varchar(200) COLLATE utf8mb4_bin NOT NULL, -- 迁移脚本描述
  `type` varchar(20) COLLATE utf8mb4_bin NOT NULL, -- 脚本类型,目前有 SQL 和 Java 。
  `script` varchar(1000) COLLATE utf8mb4_bin NOT NULL, -- 脚本地址
  `checksum` int(11) DEFAULT NULL, -- 脚本校验码。避免已经执行的脚本,被人变更了。
  `installed_by` varchar(100) COLLATE utf8mb4_bin NOT NULL, -- 执行脚本的数据库用户
  `installed_on` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP, -- 安装时间
  `execution_time` int(11) NOT NULL, -- 执行时长,单位毫秒
  `success` tinyint(1) NOT NULL, -- 执行结果是否成功。1-成功。0-失败
  PRIMARY KEY (`installed_rank`),
  KEY `flyway_schema_history_s_idx` (`success`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
  • 大体看下每个字段的注释,后面对着具体的记录,会更容易理解。

2.4 SQL-based migrations

在 resources/db/migration 目录下,创建 V1.0__INIT_DB.sql SQL 迁移脚本。如下:

-- 创建用户表
CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '用户编号',
  `username` varchar(64) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '账号',
  `password` varchar(32) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '密码',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

-- 插入一条数据
INSERT INTO `users`(username, password, create_time) VALUES('yudaoyuanma', 'password', now());
  • 比较简单,就是创建用户表 users 表,并往里面插入一条记录。

重点在于 V1.0__INIT_DB.sql 的命名上。Flyway 约定如下:

“

FROM https://flywaydb.org/documentation/migrations#naming-1

Naming
  • Prefix 前缀:V 为版本迁移,U 为回滚迁移,R 为可重复迁移。

    “

    在我们的示例中,我们使用 V 前缀,表示版本迁移。绝大多数情况下,我们只会使用 V 前缀。

  • Version 版本号:每一个迁移脚本,都需要一个对应一个唯一的版本号。而脚本的执行顺序,按照版本号的顺序。一般情况下,我们使用数字自增即可。

    “

    在我们的示例中,我们使用 1.0 。

  • Separator 分隔符:两个 _ ,即 __ 。可配置,不过一般不配置。

  • Description 描述:描述脚本的用途。

    “

    在我们的示例中,我们使用 INIT_DB 。

  • Suffix 后缀:.sql 。可配置,不过一般不配置。

我们再次启动 Application 项目。执行日志如下:

// Flyway 的信息
2019-11-16 14:20:25.893  INFO 59615 --- [           main] o.f.c.internal.license.VersionPrinter    : Flyway Community Edition 5.2.4 by Boxfuse
2019-11-16 14:20:26.063  INFO 59615 --- [           main] o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://127.0.0.1:3306/lab-20-flyway (MySQL 8.0)
// 发现一个迁移脚本,就是 V1.0__INIT_DB.sql 。
2019-11-16 14:20:26.096  INFO 59615 --- [           main] o.f.core.internal.command.DbValidate     : Successfully validated 1 migration (execution time 00:00.013s)
// 打印当前数据库的迁移版本
2019-11-16 14:20:26.137  INFO 59615 --- [           main] o.f.core.internal.command.DbMigrate      : Current version of schema `lab-20-flyway`: << Empty Schema >>
// 开始迁移到版本 1.0
2019-11-16 14:20:26.138  INFO 59615 --- [           main] o.f.core.internal.command.DbMigrate      : Migrating schema `lab-20-flyway` to version 1.0 - INIT DB
// 可以忽略,MySQL 报的告警日志
2019-11-16 14:20:26.148  WARN 59615 --- [           main] o.f.c.i.s.DefaultSqlScriptExecutor       : DB: Integer display width is deprecated and will be removed in a future release. (SQL State: HY000 - Error Code: 1681)
// 成功执行一个迁移
2019-11-16 14:20:26.157  INFO 59615 --- [           main] o.f.core.internal.command.DbMigrate      : Successfully applied 1 migration to schema `lab-20-flyway` (execution time 00:00.049s)
// 启动项目完成
2019-11-16 14:20:26.214  INFO 59615 --- [           main] c.i.s.l.d.Application                    : Started Application in 1.236 seconds (JVM running for 1.638)
  • 看下艿艿在日志内容上的注释。

此时,我们去查询下 MySQL 。如下:

mysql> show tables;
+-------------------------+
| Tables_in_lab-20-flyway |
+-------------------------+
| flyway_schema_history   |
| users                   |
+-------------------------+
2 rows in set (0.00 sec)
# 如上,我们可以看到两个表。
# 其中,`users` 表,就是我们需要在 `V1.0__INIT_DB.sql` 迁移脚本中,需要创建的。

mysql> SELECT * FROM users;
+----+-------------+----------+---------------------+
| id | username    | password | create_time         |
+----+-------------+----------+---------------------+
|  7 | yudaoyuanma | password | 2019-11-16 14:21:32 |
+----+-------------+----------+---------------------+
1 row in set (0.00 sec)
# `users` 表的该记录,就是我们希望插入的一条记录。

mysql> SELECT * FROM flyway_schema_history;
+----------------+---------+-------------+------+-------------------+-------------+--------------+---------------------+----------------+---------+
| installed_rank | version | description | type | script            | checksum    | installed_by | installed_on        | execution_time | success |
+----------------+---------+-------------+------+-------------------+-------------+--------------+---------------------+----------------+---------+
|              1 | 1.0     | INIT DB     | SQL  | V1.0__INIT_DB.sql | -1362702755 | root         | 2019-11-16 14:21:32 |             12 |       1 |
+----------------+---------+-------------+------+-------------------+-------------+--------------+---------------------+----------------+---------+
1 row in set (0.00 sec)
# `flyway_schema_history` 表中,增加了一条版本号为 `1.0` 的,使用 `V1.0__INIT_DB.sql` 迁移脚本的日志。
  • 看下每个操作,以及其注释。

我们再再次启动 Application 项目。执行日志如下:

// Flyway 的信息
2019-11-16 14:30:10.925  INFO 59715 --- [           main] o.f.c.internal.license.VersionPrinter    : Flyway Community Edition 5.2.4 by Boxfuse
2019-11-16 14:30:11.089  INFO 59715 --- [           main] o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://127.0.0.1:3306/lab-20-flyway (MySQL 8.0)
// 发现一个迁移脚本,就是 V1.0__INIT_DB.sql 。
2019-11-16 14:30:11.127  INFO 59715 --- [           main] o.f.core.internal.command.DbValidate     : Successfully validated 1 migration (execution time 00:00.014s)
// 打印当前数据库的迁移版本为 `1.0`
2019-11-16 14:30:11.137  INFO 59715 --- [           main] o.f.core.internal.command.DbMigrate      : Current version of schema `lab-20-flyway`: 1.0
// 判断已经到达最新版本,无需执行迁移
2019-11-16 14:30:11.137  INFO 59715 --- [           main] o.f.core.internal.command.DbMigrate      : Schema `lab-20-flyway` is up to date. No migration necessary.
// 启动项目完成
2019-11-16 14:30:11.196  INFO 59715 --- [           main] c.i.s.l.d.Application                    : Started Application in 1.141 seconds (JVM running for 1.528)

下面,我们注释掉 V1.0__INIT_DB.sql 迁移脚本中的,INSERT 操作。我们再再再次启动 Application 项目。会报如下错误:

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'flywayInitializer' defined in class path resource [org/springframework/boot/autoconfigure/flyway/FlywayAutoConfiguration$FlywayConfiguration.class]: Invocation of init method failed; nested exception is org.flywaydb.core.api.FlywayException: Validate failed: Migration checksum mismatch for migration version 1.0
-> Applied to database : -1362702755
-> Resolved locally    : -883795183
  • Flyway 会给每个迁移脚本,计算出一个 checksum 字段。这样,每次启动时,都会校验已经安装( installed )的迁移脚本,是否发生了改变。如果是,抛出异常。这样,保证不会因为脚本变更,导致出现问题。

2.5 Java-based migrations

在 cn.iocoder.springboot.lab20.databaseversioncontrol.migration 包路径下,创建 V1_1__FixUsername.java 类,修复 users 的用户名。代码如下:

// V1_1__FixUsername.java

public class V1_1__FixUsername extends BaseJavaMigration {

    private Logger logger = LoggerFactory.getLogger(getClass());

    @Override
    public void migrate(Context context) throws Exception {
        // 创建 JdbcTemplate ,方便 JDBC 操作
        JdbcTemplate template = new JdbcTemplate(context.getConfiguration().getDataSource());
        // 查询所有用户,如果用户名为 yudaoyuanma ,则变更成 yutou
        template.query("SELECT id, username, password, create_time FROM users", new RowCallbackHandler() {
            @Override
            public void processRow(ResultSet rs) throws SQLException {
                // 遍历返回的结果
                do {
                    String username = rs.getString("username");
                    if ("yudaoyuanma".equals(username)) {
                        Integer id = rs.getInt("id");
                        template.update("UPDATE users SET username = ? WHERE id = ?",
                                "yutou", id);
                        logger.info("[migrate][更新 user({}) 的用户名({} => {})", id, username, "yutou");
                    }
                } while (rs.next());
            }
        });
    }

    @Override
    public Integer getChecksum() {
        return 11; // 默认返回,是 null 。
    }

    @Override
    public boolean canExecuteInTransaction() {
        return true; // 默认返回,也是 true
    }

    @Override
    public MigrationVersion getVersion() {
        return super.getVersion(); // 默认按照约定的规则,从类名中解析获得。可以自定义
    }

}
  • 比较简单,胖友看下代码注释。这里仅仅是示例,实际迁移的逻辑,会更加复杂。

  • Java 迁移脚本,可以通过类名按照和 「2.4 SQL-based migrations」 一样的命名约定,自动获得版本号。当然,也可以通过重写 #getVersion() 方法,自定义版本号。

我们再再再再次启动 Application 项目。执行日志如下:

// Flyway 的信息
2019-11-16 14:45:30.733  INFO 59941 --- [           main] o.f.c.internal.license.VersionPrinter    : Flyway Community Edition 5.2.4 by Boxfuse
2019-11-16 14:45:30.907  INFO 59941 --- [           main] o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://127.0.0.1:3306/lab-20-flyway (MySQL 8.0)
// 发现一个迁移脚本,就是 V1.0__INIT_DB.sql 和 V1_1__FixUsername.java
2019-11-16 14:45:30.946  INFO 59941 --- [           main] o.f.core.internal.command.DbValidate     : Successfully validated 2 migrations (execution time 00:00.014s)
// 打印当前数据库的迁移版本为 `1.0`
2019-11-16 14:45:30.956  INFO 59941 --- [           main] o.f.core.internal.command.DbMigrate      : Current version of schema `lab-20-flyway`: 1.0
// 开始迁移到版本 1.1
2019-11-16 14:45:30.957  INFO 59941 --- [           main] o.f.core.internal.command.DbMigrate      : Migrating schema `lab-20-flyway` to version 1.1 - FixUsername
2019-11-16 14:45:30.977  INFO 59941 --- [           main] c.i.s.l.d.migration.V1_1__FixUsername    : [migrate][更新 user(7) 的用户名(yudaoyuanma => yutou)
// 成功执行一个迁移
2019-11-16 14:45:30.985  INFO 59941 --- [           main] o.f.core.internal.command.DbMigrate      : Successfully applied 1 migration to schema `lab-20-flyway` (execution time 00:00.034s)
// 启动项目完成
2019-11-16 14:45:31.039  INFO 59941 --- [           main] c.i.s.l.d.Application                    : Started Application in 1.221 seconds (JVM running for 1.61)

此时,我们去查询下 MySQL 。如下:

mysql> SELECT * FROM users;
+----+-------------+----------+---------------------+
| id | username    | password | create_time         |
+----+-------------+----------+---------------------+
|  7 | yutou    | password | 2019-11-16 14:21:32 |
+----+-------------+----------+---------------------+
1 row in set (0.00 sec)
# `users` 表的该记录,用户名被修改为 yutou 。

mysql> SELECT * FROM flyway_schema_history;
+----------------+---------+-------------+------+--------------------------------------------------------------------------------+-------------+--------------+---------------------+----------------+---------+
| installed_rank | version | description | type | script                                                                         | checksum    | installed_by | installed_on        | execution_time | success |
+----------------+---------+-------------+------+--------------------------------------------------------------------------------+-------------+--------------+---------------------+----------------+---------+
|              1 | 1.0     | INIT DB     | SQL  | V1.0__INIT_DB.sql                                                              | -1362702755 | root         | 2019-11-16 14:21:32 |             12 |       1 |
|              2 | 1.1     | FixUsername | JDBC | cn.iocoder.springboot.lab20.databaseversioncontrol.migration.V1_1__FixUsername |          11 | root         | 2019-11-16 14:45:30 |             19 |       1 |
+----------------+---------+-------------+------+--------------------------------------------------------------------------------+-------------+--------------+---------------------+----------------+---------+
2 rows in set (0.00 sec)
# `flyway_schema_history` 表中,增加了一条版本号为 `1.1` 的,使用 `V1_1__FixUsername.sql` 迁移脚本的日志。

2.6 其它功能

Flyway 支持 SQL Callbacks 和 Java Callbacks 两种回调方式,让我们在 Flyway 的执行过程中,可以实现自定义的拓展。

在上述的示例,我们是基于 Spring Boot 的使用方式。而 Flyway 还提供了如下方式:

  • API (Java / Android) 直接使用 Java 原生的 API 。

  • Command-line tool 命令行工具

  • Maven 插件

  • Gralde 插件

  • Community Plugins and Integrations ,社区提供了 Ant、Intellij IDEA、Jenkins 等插件。

???? Flyway 还有一些其它细节,建议抽时间,通读下 Documentation 文档。

3. Liquibase

“

示例代码对应仓库:lab-20-database-version-control-liquibase 。

在 Liquibase 的官网 https://www.liquibase.org/ 中,对自己的介绍是:

“

Liquibase is the leading open source tool for database change and deployment management.

Liquibase 是用于数据库变更和部署管理的领先的开源工具。

Liquibase 支持的数据库,主要是关系数据库。如下图表格:

DatabaseType NameNotes
MySQLmysqlNo Issues
MariaDBmysqlMariaDB is 100% compatible with MySQL per MariaDB developers
PostgreSQLpostgresql8.2+ is required to use the "drop all database objects" functionality.
Oracleoracle11g driver is required when using the diff tool on databases running with AL32UTF8 or AL16UTF16
SQL ServermssqlNo Issues
Sybase_EnterprisesybaseASE 12.0+ required. "select into" database option needs to be set. Best driver is JTDS. Sybase does not support transactions for DDL so rollbacks will not work on failures. Foreign keys can not be dropped which can break the rollback or dropAll functionality.
Sybase_AnywhereasanySince 1.9
DB2db2No Issues. Will auto-call REORG when necessary.
Apache_DerbyderbyNo Issues
HSQLhsqldbNo Issues
H2h2No Issues
InformixinformixNo Issues
FirebirdfirebirdNo Issues
SQLitesqliteNo Issues

Liquibase 通过在变更日志( Change Log )文件,配置每一个变更集( Change Set ),实现数据库变更的管理。

Liquibase 提供了多种格式,如下:

  • XML Format

  • YAML Format

  • JSON Format

  • SQL Format

  • Other Formats

在 Spring Boot 中,默认配置使用 YAML Format 。所以我们在入门的示例中,也使用这种格式。

Liquibase 在变更集( Change Set )中,除了提供了和 Flyway 的 SQL-based migrations 和 Java-based migrations 方式之外,额外提供了基于配置,自动生成对应的 SQL 操作。我们姑且称它为 “Property-based migrations” 吧。

下面,就让我们开始入门 Liquibase 吧。

3.1 引入依赖

在 pom.xml 文件中,引入相关依赖。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>lab-20-database-version-control-liquibase</artifactId>

    <dependencies>
        <!-- 实现对数据库连接池的自动化配置 -->
        <!-- 同时,spring-boot-starter-jdbc 支持 Liquibase 的自动化配置 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency> <!-- 本示例,我们使用 MySQL -->
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
<!--            <version>5.1.48</version>-->
        </dependency>

        <!-- Liquibase 依赖 -->
        <dependency>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-core</artifactId>
        </dependency>
    </dependencies>

</project>

具体每个依赖的作用,胖友自己认真看下艿艿添加的所有注释噢。

3.2 应用配置文件

在 resources 目录下,创建 application.yaml 配置文件。配置如下:

spring:
  # datasource 数据源配置内容,对应 DataSourceProperties 配置属性类
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/lab-20-liquibase?useSSL=false&useUnicode=true&characterEncoding=UTF-8
    driver-class-name: com.mysql.jdbc.Driver
    username: root # 数据库账号
    password: # 数据库密码
  # Liquibase 配置内容,对应 LiquibaseProperties 配置项
  liquibase:
    enabled: true # 开启 Liquibase 功能。默认为 true 。
    change-log: classpath:/db/changelog/db.changelog-master.yaml # Liquibase 配置文件地址
    url: jdbc:mysql://127.0.0.1:3306/lab-20-liquibase?useSSL=false&useUnicode=true&characterEncoding=UTF-8 # 数据库地址
    user: root # 数据库账号
    password: # 数据库密码
  • spring.datasource 配置项,设置数据源的配置。这里暂时没有实际作用,仅仅是为了项目不报数据源的错误。

  • spring.liquibase 配置项,设置 Liquibase 的属性,而后可以被 LiquibaseAutoConfiguration 自动化配置。

    • 每个配置项的作用,胖友自己看下注释。更多的配置项,可以看看 《Spring Boot 配置属性详解 -- Migration》 文章。

    • 重点看下 change-log 配置项,我们设置了变更日志( Change Log )文件的路径为 "classpath:/db/changelog/db.changelog-master.yaml" 。

3.3 变更文件 Change Log

在 resources/db/changelog 目录下,创建 db.changelog-master.yaml 变更文件。如下:

databaseChangeLog:
  - changeSet: # 对应一个 ChangeSet 对象
      id: 0 # ChangeSet 编号
      author: yunai # 作者
      comments: 空 # 备注
  • 在 databaseChangeLog 配置下,我们可以配置多个 changeSet 配置项。每个 changeSet 配置项,代表一个 变更集( Change Set )。

  • 这里,我们先配置一个“空”的 changeSet 配置项,方便我们稍后启动项。???? 真正的 changeSet 配置项,我们会按照 Property-based migrations、SQL-based migrations、Java-based migrations 示例顺序,详细解释。

3.4 Application

创建 Application.java 类,配置 @SpringBootApplication 注解即可。代码如下:

// Application.java

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        // 启动 Spring Boot 应用
        SpringApplication.run(Application.class, args);
    }

}

启动项目。执行日志如下:

// 获得 DATABASECHANGELOGLOCK 数量。此时,该 DATABASECHANGELOGLOCK 表是不存在的。
2019-11-16 19:37:01.679  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT COUNT(*) FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK
// 因为 DATABASECHANGELOGLOCK 表不存在,所以进行创建
2019-11-16 19:37:01.697  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : CREATE TABLE `lab-20-liquibase`.DATABASECHANGELOGLOCK (ID INT NOT NULL, `LOCKED` BIT(1) NOT NULL, LOCKGRANTED datetime NULL, LOCKEDBY VARCHAR(255) NULL, CONSTRAINT PK_DATABASECHANGELOGLOCK PRIMARY KEY (ID))
// 重新获得 DATABASECHANGELOGLOCK 数量。
2019-11-16 19:37:01.704  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT COUNT(*) FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK
// 删除 DATABASECHANGELOGLOCK 所有记录。为什么这么做,暂时不造,没去细研究。猜测,避免其他 JVM 进程,异常崩溃,未释放锁
2019-11-16 19:37:01.709  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : DELETE FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK
// 插入 DATABASECHANGELOGLOCK 记录,id = 1
2019-11-16 19:37:01.709  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : INSERT INTO `lab-20-liquibase`.DATABASECHANGELOGLOCK (ID, `LOCKED`) VALUES (1, 0)
// 查询 DATABASECHANGELOGLOCK 记录,id = 1
2019-11-16 19:37:01.711  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT `LOCKED` FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK WHERE ID=1
// 成功获得到 DATABASECHANGELOGLOCK 锁
2019-11-16 19:37:01.716  INFO 65543 --- [           main] l.lockservice.StandardLockService        : Successfully acquired change log lock

// 创建 DATABASECHANGELOG 表
2019-11-16 19:37:02.485  INFO 65543 --- [           main] l.c.StandardChangeLogHistoryService      : Creating database history table with name: `lab-20-liquibase`.DATABASECHANGELOG
2019-11-16 19:37:02.486  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : CREATE TABLE `lab-20-liquibase`.DATABASECHANGELOG (ID VARCHAR(255) NOT NULL, AUTHOR VARCHAR(255) NOT NULL, FILENAME VARCHAR(255) NOT NULL, DATEEXECUTED datetime NOT NULL, ORDEREXECUTED INT NOT NULL, EXECTYPE VARCHAR(10) NOT NULL, MD5SUM VARCHAR(35) NULL, `DESCRIPTION` VARCHAR(255) NULL, COMMENTS VARCHAR(255) NULL, TAG VARCHAR(255) NULL, LIQUIBASE VARCHAR(20) NULL, CONTEXTS VARCHAR(255) NULL, LABELS VARCHAR(255) NULL, DEPLOYMENT_ID VARCHAR(10) NULL)
// 获得 DATABASECHANGELOG 数量。
2019-11-16 19:37:02.494  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT COUNT(*) FROM `lab-20-liquibase`.DATABASECHANGELOG
2019-11-16 19:37:02.496  INFO 65543 --- [           main] l.c.StandardChangeLogHistoryService      : Reading from `lab-20-liquibase`.DATABASECHANGELOG
// 获得 DATABASECHANGELOG 所有记录。
2019-11-16 19:37:02.496  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT * FROM `lab-20-liquibase`.DATABASECHANGELOG ORDER BY DATEEXECUTED ASC, ORDEREXECUTED ASC
// 获得 DATABASECHANGELOGLOCK 数量。
2019-11-16 19:37:02.497  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT COUNT(*) FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK

// 读取 Change Log 文件的 Change Set 配置
2019-11-16 19:37:02.500  INFO 65543 --- [           main] liquibase.changelog.ChangeSet            : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::0::yunai ran successfully in 1ms
// 插入 DATABASECHANGELOG 记录,对应 Change Set id = 0 的迁移,执行成功
2019-11-16 19:37:02.501  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT MAX(ORDEREXECUTED) FROM `lab-20-liquibase`.DATABASECHANGELOG
2019-11-16 19:37:02.503  INFO 65543 --- [           main] liquibase.executor.jvm.JdbcExecutor      : INSERT INTO `lab-20-liquibase`.DATABASECHANGELOG (ID, AUTHOR, FILENAME, DATEEXECUTED, ORDEREXECUTED, MD5SUM, `DESCRIPTION`, COMMENTS, EXECTYPE, CONTEXTS, LABELS, LIQUIBASE, DEPLOYMENT_ID) VALUES ('0', 'yunai', 'classpath:/db/changelog/db.changelog-master.yaml', NOW(), 1, '8:d41d8cd98f00b204e9800998ecf8427e', 'empty', '', 'EXECUTED', NULL, NULL, '3.6.3', '3645022498')

// 释放锁
2019-11-16 19:37:02.506  INFO 65543 --- [           main] l.lockservice.StandardLockService        : Successfully released change log lock

// 应用启动成功
2019-11-16 19:37:02.582  INFO 65543 --- [           main] c.i.s.l.d.Application                    : Started Application in 2.242 seconds (JVM running for 2.675)
  • 看下艿艿在日志内容上的注释。

  • 在整个日志中,我可以看到 ID = 0 的变更集合( Change Set )完成了执行。

在启动的日志中,我们看到 Liquibase 会自动创建两张表:

  • DATABASECHANGELOG 表,数据库变更日志。每一条记录,对应记录每个变更集合( Change Set ) 的执行日志。表结构如下:

    CREATE TABLE `DATABASECHANGELOG` (
      `ID` varchar(255) COLLATE utf8mb4_bin NOT NULL, -- Change Set 编号
      `AUTHOR` varchar(255) COLLATE utf8mb4_bin NOT NULL, -- 作者
      `FILENAME` varchar(255) COLLATE utf8mb4_bin NOT NULL, -- Change Log 文件路径
      `DATEEXECUTED` datetime NOT NULL, -- 执行时间
      `ORDEREXECUTED` int(11) NOT NULL, -- 执行的顺序
      `EXECTYPE` varchar(10) COLLATE utf8mb4_bin NOT NULL, -- 执行类型。枚举值有 EXECUTED/FAILED/SKIPPED/RERAN/MARK_RAN
      `MD5SUM` varchar(35) COLLATE utf8mb4_bin DEFAULT NULL, -- MD5 校验码
      `DESCRIPTION` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL, -- 描述
      `COMMENTS` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL, -- 备注
      `TAG` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL, -- Tag 标签
      `LIQUIBASE` varchar(20) COLLATE utf8mb4_bin DEFAULT NULL, -- LIQUIBASE 版本号
      `CONTEXTS` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL, -- 上下文
      `LABELS` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL, -- Label 标签
      `DEPLOYMENT_ID` varchar(10) COLLATE utf8mb4_bin DEFAULT NULL -- 部署编号
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
    
  • DATABASECHANGELOGLOCK 表,DATABASECHANGELOG 表的锁,用于确保多个 JVM 进程,同时 Liquibase 尝试变更数据库。表结构如下:

    CREATE TABLE `DATABASECHANGELOGLOCK` (
      `ID` int(11) NOT NULL, -- 锁的编号。
      `LOCKED` bit(1) NOT NULL, -- 是否锁。1-锁,0-未锁
      `LOCKGRANTED` datetime DEFAULT NULL, -- 获得锁的时间
      `LOCKEDBY` varchar(255) COLLATE utf8mb4_bin  DEFAULT NULL, -- 锁定人
      PRIMARY KEY (`ID`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
    
    • 目前,只有一条记录。也就是说,有且仅有一个 JVM 进程获得 DATABASECHANGELOG 表的锁成功。

此时,我们去查询下 MySQL 。如下:

mysql> SELECT * FROM DATABASECHANGELOG;
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-------------+----------+------+-----------+----------+--------+---------------+
| ID | AUTHOR | FILENAME                                         | DATEEXECUTED        | ORDEREXECUTED | EXECTYPE | MD5SUM                             | DESCRIPTION | COMMENTS | TAG  | LIQUIBASE | CONTEXTS | LABELS | DEPLOYMENT_ID |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-------------+----------+------+-----------+----------+--------+---------------+
| 0  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 19:37:02 |             1 | EXECUTED | 8:d41d8cd98f00b204e9800998ecf8427e | empty       |          | NULL | 3.6.3     | NULL     | NULL   | 3645022498    |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-------------+----------+------+-----------+----------+--------+---------------+
1 row in set (0.00 sec)
# 查看到一条 `ID = 0` 的 `DATABASECHANGELOG` 记录,表示变更集合( Change Set ) `ID = 0` 完成了执行。

mysql> SELECT * FROM DATABASECHANGELOGLOCK;
+----+--------+-------------+----------+
| ID | LOCKED | LOCKGRANTED | LOCKEDBY |
+----+--------+-------------+----------+
|  1 | 0      | NULL        | NULL     |
+----+--------+-------------+----------+
1 row in set (0.00 sec)
# 查看到一条处于释放状态的锁记录。

再次启动项目。执行日志如下:

// 获得 DATABASECHANGELOGLOCK 数量。
2019-11-16 20:22:24.589  INFO 66473 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT COUNT(*) FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK
2019-11-16 20:22:24.594  INFO 66473 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT COUNT(*) FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK
// 查询 DATABASECHANGELOGLOCK 记录,id = 1
2019-11-16 20:22:24.595  INFO 66473 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT `LOCKED` FROM `lab-20-liquibase`.DATABASECHANGELOGLOCK WHERE ID=1
// 成功获得到 DATABASECHANGELOGLOCK 锁
2019-11-16 20:22:24.603  INFO 66473 --- [           main] l.lockservice.StandardLockService        : Successfully acquired change log lock

// 获得一条 DATABASECHANGELOG 。过滤 MD5SUM 非空且一条记录,有点奇怪,后面在细细研究。
2019-11-16 20:22:25.378  INFO 66473 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT MD5SUM FROM `lab-20-liquibase`.DATABASECHANGELOG WHERE MD5SUM IS NOT NULL LIMIT 1
// 获得 DATABASECHANGELOG 数量。
2019-11-16 20:22:25.379  INFO 66473 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT COUNT(*) FROM `lab-20-liquibase`.DATABASECHANGELOG
// 获得 DATABASECHANGELOG 所有记录。
2019-11-16 20:22:25.380  INFO 66473 --- [           main] l.c.StandardChangeLogHistoryService      : Reading from `lab-20-liquibase`.DATABASECHANGELOG
2019-11-16 20:22:25.380  INFO 66473 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT * FROM `lab-20-liquibase`.DATABASECHANGELOG ORDER BY DATEEXECUTED ASC, ORDEREXECUTED ASC

// 释放锁
2019-11-16 20:22:25.385  INFO 66473 --- [           main] l.lockservice.StandardLockService        : Successfully released change log lock

2019-11-16 20:22:25.447  INFO 66473 --- [           main] c.i.s.l.d.Application                    : Started Application in 2.215 seconds (JVM running for 2.62)
  • 在整个日志中,我可以看到 ID = 0 的变更集合( Change Set )不会重复执行。

下面,我们修改 ID = 0 的变更集合( Change Set ),如下:

databaseChangeLog:
  - changeSet: # 对应一个 ChangeSet 对象
      id: 0 # ChangeSet 编号
      author: yunai # 作者
      comments: 空 # 备注
      changes:
        - createTable: # 创建表,对应 CreateTableChange 对象。
            tableName: users # 表名
            remarkds: 用户表 # 表注释
            columns: # 对应 ColumnConfig 数组
              - column:
                  name: id # 字段名
                  type: int # 字段类型
                  autoIncrement: true # 自增
                  constraints: # 限制条件,对应一个 ConstraintsConfig 对象
                    primaryKey: true # 主键
                    nullable: false # 不允许空
  • 增加了 changes 配置项。

  • 我们再再再次启动项目。会报如下错误:

    Caused by: liquibase.exception.ValidationFailedException: Validation Failed:
         1 change sets check sum
              classpath:/db/changelog/db.changelog-master.yaml::0::yunai was: 8:d41d8cd98f00b204e9800998ecf8427e but is now: 8:2fb4d9484c5982a97eb8d580ba934395
    
    • 我们会发现,Liquibase 会给每个变更集合( Change Set ),计算出一个 MD5SUM 字段。这样,每次启动时,都会校验已经执行的变更集合( Change Set ),是否发生了改变。如果是,抛出异常。这样,保证不会因为 变更集合( Change Set ) 变更,导致出现问题。

  • 测试完成,我们还是将 ID = 0 的变更集合( Change Set ) 恢复原样。

3.5 Property-based migrations

修改 db.changelog-master.yaml 变更日志,增加 ID = 1 的变更集合( Change Set ) 。代码如下:

  - changeSet: # 对应一个 ChangeSet 对象
      id: 1 # ChangeSet 编号
      author: yunai # 作者
      comments: 初始化 users 表 # 备注
      changes: # 对应 Change 数组。Change 是一个接口,每种操作对应一种 Change 实现类
        - createTable: # 创建表,对应 CreateTableChange 对象。
            tableName: users # 表名
            remarkds: 用户表 # 表注释
            columns: # 对应 ColumnConfig 数组
              - column:
                  name: id # 字段名
                  type: int # 字段类型
                  autoIncrement: true # 自增
                  constraints: # 限制条件,对应一个 ConstraintsConfig 对象
                    primaryKey: true # 主键
                    nullable: false # 不允许空
              - column:
                  name: username
                  type: varchar(64)
                  constraints:
                    nullable: false
              - column:
                  name: password
                  type: varchar(32)
                  constraints:
                    nullable: false
              - column:
                  name: create_time
                  type: datetime
                  constraints:
                    nullable: false
        - insert: # 插入记录,对应 InsertDataChange 对象。
            tableName: users # 表名
            columns: # 对应 ColumnConfig 数组
              - column:
                  name: username # 字段名
                  value: yudaoyuanma # 值
              - column:
                  name: password
                  value: password
              - column:
                  name: create_time
                  value: now()
  • 在这个变更集合( Change Set )中,我们添加了两个变更( Change ),分别用于创建 users 表、插入一条 users 记录。

  • Liquibase 基于上述的配置,自动生成对应的 SQL 操作。

启动项目。执行日志如下:

// ... 省略雷同日志

// 创建 `users` 表
2019-11-16 21:21:42.317  INFO 67111 --- [           main] liquibase.executor.jvm.JdbcExecutor      : CREATE TABLE `lab-20-liquibase`.users (id INT AUTO_INCREMENT NOT NULL, username VARCHAR(64) NOT NULL, password VARCHAR(32) NOT NULL, create_time datetime NOT NULL, CONSTRAINT PK_USERS PRIMARY KEY (id))
2019-11-16 21:21:42.323  INFO 67111 --- [           main] liquibase.changelog.ChangeSet            : Table users created

// 插入一条 `users` 表的记录
2019-11-16 21:21:42.323  INFO 67111 --- [           main] liquibase.executor.jvm.JdbcExecutor      : INSERT INTO `lab-20-liquibase`.users (username, password, create_time) VALUES ('yudaoyuanma', 'password', now())
2019-11-16 21:21:42.324  INFO 67111 --- [           main] liquibase.changelog.ChangeSet            : New row inserted into users

// 输出 Change Log 文件的 Change Set 全部执行成功
2019-11-16 21:21:42.325  INFO 67111 --- [           main] liquibase.changelog.ChangeSet            : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::1::yunai ran successfully in 10ms
// 插入 DATABASECHANGELOG 记录,对应 Change Set id = 1 的迁移,执行成功
2019-11-16 21:21:42.326  INFO 67111 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT MAX(ORDEREXECUTED) FROM `lab-20-liquibase`.DATABASECHANGELOG
2019-11-16 21:21:42.327  INFO 67111 --- [           main] liquibase.executor.jvm.JdbcExecutor      : INSERT INTO `lab-20-liquibase`.DATABASECHANGELOG (ID, AUTHOR, FILENAME, DATEEXECUTED, ORDEREXECUTED, MD5SUM, `DESCRIPTION`, COMMENTS, EXECTYPE, CONTEXTS, LABELS, LIQUIBASE, DEPLOYMENT_ID) VALUES ('1', 'yunai', 'classpath:/db/changelog/db.changelog-master.yaml', NOW(), 3, '8:1dcffd4c4f87b02e3758bf6b4ecea471', 'createTable tableName=users; insert tableName=users', '', 'EXECUTED', NULL, NULL, '3.6.3', '3651302309')

// ... 省略雷同日志
  • 看下艿艿在日志内容上的注释。

  • 在整个日志中,我可以看到 ID = 1 的变更集合( Change Set )完成了执行。在这个过程中,我们可以看到两条分别用于创建 users 表和插入 users 记录的 SQL 。

此时,我们去查询下 MySQL 。如下:

mysql> SELECT * FROM DATABASECHANGELOG;
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
| ID | AUTHOR | FILENAME                                         | DATEEXECUTED        | ORDEREXECUTED | EXECTYPE | MD5SUM                             | DESCRIPTION                                         | COMMENTS | TAG  | LIQUIBASE | CONTEXTS | LABELS | DEPLOYMENT_ID |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
| 0  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:35:09 |             1 | EXECUTED | 8:d41d8cd98f00b204e9800998ecf8427e | empty                                               |          | NULL | 3.6.3     | NULL     | NULL   | 3652109350    |
| 1  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:35:09 |             2 | EXECUTED | 8:1dcffd4c4f87b02e3758bf6b4ecea471 | createTable tableName=users; insert tableName=users |          | NULL | 3.6.3     | NULL     | NULL   | 3652109350    |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
2 rows in set (0.00 sec)
# 多查看到一条 `ID = 1` 的 `DATABASECHANGELOG` 记录,表示变更集合( Change Set ) `ID = 1` 完成了执行。并且,在描述中,我们可以看到对该更集合( Change Set )的简单说明。

mysql> SELECT * FROM DATABASECHANGELOGLOCK;
+----+--------+-------------+----------+
| ID | LOCKED | LOCKGRANTED | LOCKEDBY |
+----+--------+-------------+----------+
|  1 | 0      | NULL        | NULL     |
+----+--------+-------------+----------+
1 row in set (0.00 sec)
# 查看到一条处于释放状态的锁记录。

使用 Property-based migrations 方式,我们无需编写相应的 SQL 。虽然在编写上有些啰嗦,但是易读性还是不错的。

3.6 SQL-based migrations

修改 db.changelog-master.yaml 变更日志,增加 ID = 2 的变更集合( Change Set ) 。代码如下:

  - changeSet: # 对应一个 ChangeSet 对象
      id: 2 # ChangeSet 编号
      author: yunai # 作者
      comments: 初始化 users2 表 # 备注
      changes: # 对应 Change 数组。Change 是一个接口,每种操作对应一种 Change 实现类
        - sqlFile: # 使用 SQL 文件,对应 SQLFileChange 对象
            encoding: utf8
            path: classpath:db/changelog/sqlfile/CHAGE_SET_2_INIT_DB.sql
  • 这个示例,我们实现的是和 「3.5 Property-based migrations」 一样的效果,只是操作的是 users2 表。

  • 对应文档为 《Liquibase 文档 —— SQL FILE》 。

  • 通过在 sqlFile 配置项的 path 属性,设置使用自定义 SQL 文件的路径。

在 resources/db/changelog/sqlfile 目录下,创建 CHAGE_SET_2_INIT_DB.sql 变更文件。如下:

-- 创建用户表
CREATE TABLE `users2` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '用户编号',
  `username` varchar(64) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '账号',
  `password` varchar(32) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '密码',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

-- 插入一条数据
INSERT INTO `users2`(username, password, create_time) VALUES('yudaoyuanma', 'password', now());
  • 这里的 SQL ,和我们在 「2.4 SQL-based migrations」 是一样的。

启动项目。执行日志如下:

// ... 省略雷同日志

// 执行 CHAGE_SET_2_INIT_DB.sql 里的 SQL
2019-11-16 21:40:05.793  INFO 67368 --- [           main] liquibase.executor.jvm.JdbcExecutor      : -- 创建用户表
CREATE TABLE `users2` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '用户编号',
  `username` varchar(64) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '账号',
  `password` varchar(32) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '密码',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin
2019-11-16 21:40:05.800  INFO 67368 --- [           main] liquibase.executor.jvm.JdbcExecutor      : -- 插入一条数据
INSERT INTO `users2`(username, password, create_time) VALUES('yudaoyuanma', 'password', now())
2019-11-16 21:40:05.801  INFO 67368 --- [           main] liquibase.changelog.ChangeSet            : SQL in file classpath:db/changelog/sqlfile/CHAGE_SET_2_INIT_DB.sql executed

// 输出 Change Log 文件的 Change Set 全部执行成功
2019-11-16 21:40:05.802  INFO 67368 --- [           main] liquibase.changelog.ChangeSet            : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::2::yunai ran successfully in 13ms

// 插入 DATABASECHANGELOG 记录,对应 Change Set id = 2 的迁移,执行成功
2019-11-16 21:40:05.802  INFO 67368 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT MAX(ORDEREXECUTED) FROM `lab-20-liquibase`.DATABASECHANGELOG
2019-11-16 21:40:05.804  INFO 67368 --- [           main] liquibase.executor.jvm.JdbcExecutor      : INSERT INTO `lab-20-liquibase`.DATABASECHANGELOG (ID, AUTHOR, FILENAME, DATEEXECUTED, ORDEREXECUTED, MD5SUM, `DESCRIPTION`, COMMENTS, EXECTYPE, CONTEXTS, LABELS, LIQUIBASE, DEPLOYMENT_ID) VALUES ('2', 'yunai', 'classpath:/db/changelog/db.changelog-master.yaml', NOW(), 3, '8:c224782d41ad7fac92699ebf392c7f5e', 'sqlFile', '', 'EXECUTED', NULL, NULL, '3.6.3', '3652405782')

// ... 省略雷同日志
  • 看下艿艿在日志内容上的注释。

  • 在整个日志中,我可以看到 ID = 1 的变更集合( Change Set )完成了执行。在这个过程中,我们可以看到 CHAGE_SET_2_INIT_DB.sql 的 SQL 被执行。

此时,我们去查询下 MySQL 。如下:

mysql> SELECT * FROM DATABASECHANGELOG;
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
| ID | AUTHOR | FILENAME                                         | DATEEXECUTED        | ORDEREXECUTED | EXECTYPE | MD5SUM                             | DESCRIPTION                                         | COMMENTS | TAG  | LIQUIBASE | CONTEXTS | LABELS | DEPLOYMENT_ID |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
| 0  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:35:09 |             1 | EXECUTED | 8:d41d8cd98f00b204e9800998ecf8427e | empty                                               |          | NULL | 3.6.3     | NULL     | NULL   | 3652109350    |
| 1  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:35:09 |             2 | EXECUTED | 8:1dcffd4c4f87b02e3758bf6b4ecea471 | createTable tableName=users; insert tableName=users |          | NULL | 3.6.3     | NULL     | NULL   | 3652109350    |
| 2  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:40:05 |             3 | EXECUTED | 8:c224782d41ad7fac92699ebf392c7f5e | sqlFile                                             |          | NULL | 3.6.3     | NULL     | NULL   | 3652405782    |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
3 rows in set (0.00 sec)
# 多查看到一条 `ID = 2` 的 `DATABASECHANGELOG` 记录,表示变更集合( Change Set ) `ID = 2` 完成了执行。并且,在描述中,我们可以看到 `sqlFile` 。

mysql> SELECT * FROM DATABASECHANGELOGLOCK;
+----+--------+-------------+----------+
| ID | LOCKED | LOCKGRANTED | LOCKEDBY |
+----+--------+-------------+----------+
|  1 | 0      | NULL        | NULL     |
+----+--------+-------------+----------+
1 row in set (0.00 sec)
# 查看到一条处于释放状态的锁记录。

相比 Property-based migrations 方式来说,艿艿更愿意使用 SQL-based migrations 。毕竟,我们更加熟悉 SQL 语法,交给 DBA 审计也更加方便。

3.7 Java-based migrations

在 cn.iocoder.springboot.lab20.databaseversioncontrol.migration 包路径下,创建 CHANGE_SET_3_FixUsername.java 类,修复 users 的用户名。代码如下:

// CHANGE_SET_3_FixUsername.java

public class CHANGE_SET_3_FixUsername implements CustomTaskChange {

    private Logger logger = LoggerFactory.getLogger(getClass());

    @Override
    public void execute(Database database) throws CustomChangeException {
        JdbcConnection connection = (JdbcConnection) database.getConnection();
        try (PreparedStatement psmt = connection.prepareStatement("SELECT id, username, password, create_time FROM users")) {
            try (ResultSet rs = psmt.executeQuery()) {
                while (rs.next()) {
                    String username = rs.getString("username");
                    if ("yudaoyuanma".equals(username)) {
                        Integer id = rs.getInt("id");
                        // 这里,再来一刀更新操作,偷懒不写了。
                        logger.info("[migrate][更新 user({}) 的用户名({} => {})", id, username, "yutou");
                    }
                }
            }
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

    @Override
    public String getConfirmationMessage() {
        return null;
    }

    @Override
    public void setUp() throws SetupException {
    }

    @Override
    public void setFileOpener(ResourceAccessor resourceAccessor) {
    }

    @Override
    public ValidationErrors validate(Database database) {
        return null;
    }

}
  • 通过实现 CustomTaskChange 接口,实现 Java 自定义迁移逻辑。

  • 这里有一点比较蛋疼,在 #execute(Database database) 方法中,提供给我们的是 Database 对象,无法方便的获得 DataSource 对象,从而使用 Spring JdbcTemplate 。

修改 db.changelog-master.yaml 变更日志,增加 ID = 3 的变更集合( Change Set ) 。代码如下:

  - changeSet: # 对应一个 ChangeSet 对象
      id: 3 # ChangeSet 编号
      author: yunai # 作者
      comments: 修复 `users` 的用户名 # 备注
      changes: # 对应 Change 数组。Change 是一个接口,每种操作对应一种 Change 实现类
        - customChange: {class: cn.iocoder.springboot.lab20.databaseversioncontrol.migration.CHANGE_SET_3_FixUsername} # 对应 CustomTaskChange
  • 对应文档为 《Liquibase 文档 —— Custom Change》 。

  • 通过在 customChange 配置项的 class 属性,设置使用自定义 CustomTaskChange 的实现的类名。

启动项目。执行日志如下:

// ... 省略雷同日志

// CHANGE_SET_3_FixUsername 的执行日志
2019-11-16 21:56:48.782  INFO 67585 --- [           main] c.i.s.l.d.m.CHANGE_SET_3_FixUsername     : [migrate][更新 user(1) 的用户名(yudaoyuanma => yutou)
2019-11-16 21:56:48.782  INFO 67585 --- [           main] liquibase.changelog.ChangeSet            : null

// 插入 DATABASECHANGELOG 记录,对应 Change Set id = 3 的迁移,执行成功
2019-11-16 21:56:48.783  INFO 67585 --- [           main] liquibase.changelog.ChangeSet            : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::3::yunai ran successfully in 3ms
2019-11-16 21:56:48.783  INFO 67585 --- [           main] liquibase.executor.jvm.JdbcExecutor      : SELECT MAX(ORDEREXECUTED) FROM `lab-20-liquibase`.DATABASECHANGELOG
2019-11-16 21:56:48.784  INFO 67585 --- [           main] liquibase.executor.jvm.JdbcExecutor      : INSERT INTO `lab-20-liquibase`.DATABASECHANGELOG (ID, AUTHOR, FILENAME, DATEEXECUTED, ORDEREXECUTED, MD5SUM, `DESCRIPTION`, COMMENTS, EXECTYPE, CONTEXTS, LABELS, LIQUIBASE, DEPLOYMENT_ID) VALUES ('3', 'yunai', 'classpath:/db/changelog/db.changelog-master.yaml', NOW(), 4, '8:2595b6826984b91149063782c4cd6c29', 'customChange', '', 'EXECUTED', NULL, NULL, '3.6.3', '3653408775')

// ... 省略雷同日志
  • 看下艿艿在日志内容上的注释。

  • 在整个日志中,我可以看到 ID = 3 的变更集合( Change Set )完成了执行。在这个过程中,我们可以看不到 CHANGE_SET_3_FixUsername 的任何信息,除了我们打的 INFO 日志。所以,在使用 Java-based migrations 方式时,最好自己打下日志,方便排查。

此时,我们去查询下 MySQL 。如下:

mysql> SELECT * FROM DATABASECHANGELOG;
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
| ID | AUTHOR | FILENAME                                         | DATEEXECUTED        | ORDEREXECUTED | EXECTYPE | MD5SUM                             | DESCRIPTION                                         | COMMENTS | TAG  | LIQUIBASE | CONTEXTS | LABELS | DEPLOYMENT_ID |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
| 0  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:35:09 |             1 | EXECUTED | 8:d41d8cd98f00b204e9800998ecf8427e | empty                                               |          | NULL | 3.6.3     | NULL     | NULL   | 3652109350    |
| 1  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:35:09 |             2 | EXECUTED | 8:1dcffd4c4f87b02e3758bf6b4ecea471 | createTable tableName=users; insert tableName=users |          | NULL | 3.6.3     | NULL     | NULL   | 3652109350    |
| 2  | yunai  | classpath:/db/changelog/db.changelog-master.yaml | 2019-11-16 21:40:05 |             3 | EXECUTED | 8:c224782d41ad7fac92699ebf392c7f5e | sqlFile                                             |          | NULL | 3.6.3     | NULL     | NULL   | 3652405782    |
+----+--------+--------------------------------------------------+---------------------+---------------+----------+------------------------------------+-----------------------------------------------------+----------+------+-----------+----------+--------+---------------+
3 rows in set (0.00 sec)
# 多查看到一条 `ID = 2` 的 `DATABASECHANGELOG` 记录,表示变更集合( Change Set ) `ID = 2` 完成了执行。并且,在描述中,我们可以看到 `sqlFile` 。

mysql> SELECT * FROM DATABASECHANGELOGLOCK;
+----+--------+-------------+----------+
| ID | LOCKED | LOCKGRANTED | LOCKEDBY |
+----+--------+-------------+----------+
|  1 | 0      | NULL        | NULL     |
+----+--------+-------------+----------+
1 row in set (0.00 sec)
# 查看到一条处于释放状态的锁记录。

3.8 其它功能

在上述的示例,我们是基于 Spring Boot 的使用方式。而 Flyway 还提供了如下方式:

  • Java API 直接使用 Java 原生的 API 。

  • Command Line 命令行工具

  • Ant 任务

  • Maven 插件

  • Gralde 插件

  • ... 等等

???? Liquibase 还有一些其它细节,建议抽时间,通读下 Documentation 文档。

666. 彩蛋

写着写着,突然意识到原来写了这么臭长。能看到这里的胖友,对艿艿一定是真爱。反正我相信了。

在写这篇文章的过程中,艿艿也在网上搜索 Flyway 和 Liquibase 的对比。毕竟,咱仅仅是做了这两者的入门,实际使用的情况,是否有什么最佳实践,又或者有什么坑,需要有在项目中真正在实践的人的经验分享。目前暂时只找到 《数据库迁移工具 Flyway 对比 Liquibase》 一文,作者的观点是:

“

两款数据库迁移工具其实定位上是差别的,一般我的倾向是小项目,整体变动不大的用 Flyway ,而大应用和企业应用用 Liquibase 更合适。

  • 不过从入门看下来,Liquibase 并未看到比 Flyway 带来多大的优势,反倒 Flyway 基于“约定大于配置”的思想,使用上更加便捷。欢迎胖友能够解答下艿艿在这块的疑惑。

关于最佳实践,目前找到比较合适的两篇,如下:

  • 《Spring Boot 使用 Liquibase 最佳实》

  • 《Spring Boot 系列: 使用 flyway 管理数据库版本》 文末的 flyway 最佳实践的部分。

在实际项目使用时,可能还需要额外考虑一些事情,例如说:

  • 大表直接添加索引,直接导致线上故障。

  • 内部有 DBA ,数据库调整需要内部审核。

另外,项目发版时,涉及到的数据变更,不仅仅有关系数据库,可能还有 MongoDB、Redis、Elasticsearch 等等数据源的变更。特别是,可能涉及到数据修复,需要编写 Java 代码的情况。和朋友沟通了下,目前采用如下三种方法:

“

思路都是一致的,只是形态不同。

  • 1、创建迁移 Migration 项目,专门编写数据相关变更的脚本。然后连接各种环境,本机手动运行。

  • 2、在定时任务项目中,创建迁移 Migration Job 类,编写数据变更的脚本。然后,部署到服务器上,通过调度中心触发运行。

  • 3、在业务项目中,创建迁移 API 接口,编写数据变更的脚本。然后,部署到服务器上,通过调用该 API 接口运行。



欢迎加入我的知识星球,一起探讨架构,交流源码。加入方式,长按下方二维码噢:

已在知识星球更新源码解析如下:

最近更新《芋道 SpringBoot 2.X 入门》系列,已经 20 余篇,覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。

提供近 3W 行代码的 SpringBoot 示例,以及超 4W 行代码的电商微服务项目。

获取方式:点“在看”,关注公众号并回复 666 领取,更多内容陆续奉上。

兄弟,艿一口,点个赞!????

Spring Boot集成Druid连接池配置失效排查与解决方案 数据库连接池是Java后端开发中的核心组件,负责管理数据库连接的创建、分配和回收,直接影响应用性能和稳定性。其工作原理是通过预先建立一定数量的连接放入池中,应用需要时从池中获取,使用完毕后归还,避免频繁创建和销毁连接的开销。在Spring Boot项目中,Druid作为一款功能强大的连接池,以其出色的监控能力和防SQL注入等特性被广泛使用。然而,在实际集成过程中,开发者常遇到配置参数不生效、监控页面无法访问等“静默”失效问题,这通常源于Spring Boot自动装配机制与手动配置的优先级冲突。本文将从配置前 阅读详情

相关推荐

IDEA连接MySQL的四种方法:从GUI到Docker与Spring Boot集成

JDBC(Java数据库连接)是Java应用访问关系型数据库的标准API,它通过驱动管理器加载特定数据库的驱动程序来建立连接。其核心原理是作为Java程序与数据库之间的桥梁,将SQL语句发送给数据库并处理返回结果。这项技术的价值在于实现了数据库访问的标准化与可移植性,是Java企业级应用数据持久层的基石。在实际开发中,开发者常借助IDE的图形化工具或框架的自动配置来简化连接管理,例如在IntelliJ IDEA中通过Database工具窗口进行可视化操作,或在Spring Boot项目中通过配置文件自动集成

weixin_30617737的博客 409

免费获取芋道源码ruoyi-vue-pro和yudao-cloud的sql脚本,持续更新!

ruoyi-vue-pro和yudao-cloud都属于芋道源码,但用过的人都知道,这两个开源项目下有商城、ERP、CRM等模块,这些模块的SQL需要加入芋道源码的知识星球才能获取,加入费用为199元,有点小贵!芋道源码的ruoyi-vue-pro和yudao-cloud都已经发布到GoldPanKit上,通过GoldPanKit构建项目不仅可以免费获取到SQL,还能选配功能模块,调整包名,自动配置数据库。

Caesar's blog 1万+

Vibe Coding实战:3分钟快速搭建Spring Boot CRUD服务

在软件开发中,快速原型验证和敏捷开发是提升效率的关键。Spring Boot作为Java领域主流的微服务框架,通过自动配置和起步依赖简化了项目搭建,但其基础CRUD服务的创建仍涉及大量重复的模板代码编写。Vibe Coding作为一种新兴的AI辅助编程范式,通过自然语言交互,将开发流程从“编写代码”前置到“描述需求”,能够自动化生成高度标准化的代码结构。其技术价值在于显著缩短从想法到可运行服务的路径,尤其适用于模式清晰、边界明确的后端服务搭建场景。本文以创建用户管理模块为例,演示如何通过Vibe Codin

weixin_30776545的博客 328

芋道项目笔记(自用

摘了几个自己认为的重点.jpg

hazelzhiye的博客 5934

Spring Boot多数据源下Druid数据库密码加密配置实战

在Java企业级应用开发中,数据库连接池是提升性能和稳定性的关键技术组件,而数据源配置的安全性则是保障系统安全的第一道防线。其核心原理在于通过加密算法对敏感信息进行转换,防止明文泄露。这项技术的价值在于满足安全合规要求,实现配置信息的纵深防御,尤其在生产环境和微服务架构中至关重要。应用场景广泛覆盖主从分离、分库分表及多租户系统等需要配置多个数据库连接的复杂工程实践。本文聚焦于解决Druid连接池在Spring Boot多数据源环境下的密码安全存储问题,详细阐述了如何通过自定义环境处理器实现配置的自动解密,并

486

芋道微服务包含工作流的sql

芋道微服务包含工作流的sql

国产数据库迁移实战:用db-migration解决企业级数据架构升级难题

在数字化转型浪潮中,越来越多的企业选择国产数据库作为核心数据存储方案。然而,在实际迁移过程中,开发团队常常面临以下挑战: **兼容性适配复杂**:不同国产数据库的SQL语法、数据类型存在差异,传统的迁移工具难以完美支持 **版本管理混乱**:多环境部署时,数据库脚本版本不一致导致生产事故频发 **持续集成困难**:自动化流水线中缺乏可靠的数据库变更管理机制 ## 解决方案:db-migra

gitblog_00298的博客 1055

芋道sql ruoyi-vue-pro yudao 项目商城模块相关SQL脚本

芋道sql ruoyi-vue-pro yudao 项目商城模块相关SQL脚本

数据库版本管理的艺术:金仓数据库与Flyway的完美融合

在现代应用开发中,数据库版本管理一直是困扰开发团队的难题。作为一名长期从事企业级应用开发的工程师,我曾经历过各种数据库变更带来的痛苦:开发环境与生产环境不一致、团队协作中的脚本冲突、版本回退的复杂性等等。直到我遇到了Flyway,特别是在金仓数据库KingbaseES项目中的实践,才真正体会到了数据库版本管理的优雅与高效。

私聊前往站内信:https://i.youkuaiyun.com/#/msg/chat/weixin_44976692 3万+

芋道sqlruoyi-vue-pro yudao 项目公众号模块相关SQL脚本

芋道sqlruoyi-vue-pro yudao 项目公众号模块相关SQL脚本,目前ruoyi-vue-pro 项目虽然开源,但是公众号模块被屏蔽了,分享下公众号的sql相关脚本。

芋道ruoyi-vue-pro 工作流最新sql

芋道ruoyi-vue-pro 工作流最新sql 注意,bpm_process_definition_info表中deleted这个字段的默认值为0,并没有写手sql语句,请手劝添加!

国产数据库迁移革命:5大理由选择db-migration实现无缝数据迁移

在当今国产化浪潮中,数据库迁移已成为每个技术团队必须面对的挑战。db-migration作为一款专为国产数据库设计的开源迁移框架,在短短几年内帮助数百家企业解决了达梦、南大通用、OpenGauss等主流国产数据库的版本控制难题。 ## 🎯 为什么你的项目急需数据库迁移工具? 数据库架构变更管理是软件开发中最容易被忽视却至关重要的环节。传统的手工执行SQL脚本方式存在诸多痛点:版本混乱、回滚困

gitblog_00062的博客 1125

ruoyi-vue-pro yudao(芋道) 项目bpm模块SQL脚本

ruoyi-vue-pro yudao(芋道) 项目bpm模块SQL脚本

db-migration:国产数据库迁移的革命性解决方案

在数字化转型浪潮中,国产数据库迁移与版本控制已成为企业级应用开发的关键环节。db-migration 项目作为一款专为国产数据库深度优化的开源框架,彻底解决了传统迁移工具在国产数据库环境中的兼容性痛点。该项目由 mengweijin 开发维护,通过双引擎架构同时支持 Flyway 和 Liquibase 两大主流迁移工具,为开发者提供了前所未有的灵活性。 ## 🎯 为什么选择 db-migra

gitblog_01146的博客 944

芋道 yudao ruoyi-vue-pro crm sql , 更新时间 2024-09-30 ,可对应yudao版本2.4

芋道是一个以CRM系统为核心的开发项目,它采用的是yudao ruoyi-vue-pro的技术栈,其中包含了一套高效的Vue前端框架以及基于Spring Boot的后端系统。CRM(Customer Relationship Management)即客户关系管理系统,主要用来管理公司与客户之间的关系。它的目标是通过一系列的策略与软件工具来优化与提升客户满意度、客户忠诚度,并且提升企业的销售业绩。 芋道CRM系统的特点是高度集成化与模块化设计,使之能够快速部署并且易于扩展。在这个系统中,开发者可以利用Vue.js快速开发出响应式的前端用户界面,而Spring Boot则提供了一个轻量级的、快速启动的Spring应用程序。这样的设计可以大大减少项目开发的复杂度,并提升开发效率。 本次更新的文件名为crm-2024-09-30.sql,是一份SQL文件,它包含了CRM系统的数据库更新脚本。SQL(Structured Query Language)是一种特殊目的的编程语言,主要用于管理关系数据库管理系统中的数据。通过使用SQL,可以进行数据的查询、插入、更新、删除等操作。在CRM系统中,SQL脚本通常用来维护数据结构,例如创建新表、索引、触发器等,或者进行数据的迁移、备份和恢复。 更新时间标记为2024年9月30日,说明这是最新的版本文件。文件更新的内容可能涉及到对系统功能的改进、性能优化、安全加固、用户界面的美化或是新增了一些业务流程模块等。鉴于它被注明可以对应yudao版本2.4.1,这说明开发者在进行此次更新时,很可能针对该版本的特性做了定制化的改进和优化。 从文件名的命名规则上来看,"crm"是该文件的模块标识,表明文件与CRM系统直接相关;"2024-09-30"则精确地指出了文件的更新时间,这有助于开发者追踪历史版本,便于管理不同版本的文件;".sql"作为文件的后缀名,明确指出了该文件是一个SQL脚本文件。 由于这是一个SQL文件,因此它可能包含了创建或修改数据库表的语句、数据库索引的创建语句、视图的定义语句、存储过程和函数等。这些内容对于数据库管理员或开发人员来说是至关重要的,因为它们是CRM系统功能正确执行的基石。SQL文件的更新通常涉及对数据库结构的变更,所以进行更新前应当做好数据备份,以防数据丢失。 在实际使用这个SQL文件进行数据库更新时,通常需要数据库管理员或开发人员登录数据库管理系统,执行SQL脚本中的语句。通常,在执行之前,应当仔细检查脚本内容,确保它符合业务逻辑和数据结构的要求。在某些情况下,还需要对数据库进行锁定,以防止在更新过程中出现数据不一致的情况。一旦执行了SQL脚本,对数据库结构的更新就会立即生效,相应的CRM系统也会反映出这些变化。 从标签来看,"yudao ruoyi-vue-pro crm sql"表明该项目的维护者对于标签的使用是精确的,它不仅涵盖了CRM系统的命名,还关联了前端框架和后端技术,提供了对于技术栈的完整描述。 本SQL文件是芋道CRM系统的一个重要组成部分,它承载了对CRM数据库结构的维护和更新任务。开发者和数据库管理员需要精确地理解和使用这个文件,以保证系统的正常运行和升级。

用钱买的芋道ruoyi-vue-pro 商城模块完整 sql, 芋道宣传的很牛皮,对所有用户永久开源免费,没想到它还是留了一手

用钱买的芋道ruoyi-vue-pro 商城模块完整 sql 。芋道宣传的很牛皮,对所有用户永久开源免费,没想到它还是留了一手。

Spring Boot 与 Docker 的完美结合:容器化你的应用

本文详细介绍了将Spring Boot应用容器化的完整流程。主要内容包括:使用Spring Initializr创建项目、构建可执行JAR包、编写生产级Dockerfile、使用Docker Compose管理多服务依赖、推送镜像到仓库以及部署到云平台。重点讲解了Spring Boot与Docker结合的优势,如快速部署、环境一致性保障和微服务支持,并提供了分层构建、.dockerignore等优化技巧。通过逐步指导,开发者可以轻松实现Spring Boot应用的容器化部署,提升开发效率和运维便利性。

2503_92145588的博客 1785

Xilinx ZYNQ 7000学习笔记二(FSBL代码分析启动-汇编代码)

Xilinx ZYNQ 7000学习笔记

u011116085的博客 4250

Liquibase与Spring Boot集成:微服务架构下的数据库管理方案

在当今微服务架构盛行的时代,**Liquibase**作为一款强大的开源数据库版本控制工具,与**Spring Boot**的完美结合为开发团队提供了可靠的数据库变更管理方案。本指南将详细介绍如何在Spring Boot项目中集成Liquibase,实现数据库变更的自动化管理。 ## 🚀 Liquibase简介与核心优势 **Liquibase**是一个开源的数据库版本控制工具,它通过XML

gitblog_00332的博客 1075

基于Landsat-8数据的山西省吕梁市地表温度反演研究过程(大气校正法)

1.数据下载:本实验采用的数据是 ①从地理空间数据云下载的来自landsat8 卫星,云量<=1%,时间为2017年5月12日的山西省吕梁市影像数据。为全面覆盖吕梁市,选用了两片影像。 ②吕梁市边界矢量图 2.数据预处理 ...

weixin_45747376的博客 6601

从CPU视角看PCIe:深入理解x86/ARM平台上BAR、MMIO和PIO的地址翻译与访问机制

本文深入探讨了CPU如何通过BAR、MMIO和PIO机制访问PCIe设备的配置空间,详细解析了x86和ARM平台在地址翻译与访问路径上的差异。重点分析了PCIe配置空间中BAR寄存器的作用与探测机制,以及操作系统如何管理PCIe资源,为开发者提供了性能优化与调试的实用技巧。

weixin_30175731的博客 325
上一篇: 项目实践:Spring Boot 三招组合拳,手把手教你打出优雅的后端接口
下一篇: JAVA和GO真香!谁用谁知道!
公众号-芋道源码
博客等级 码龄10年 1637粉丝 377原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值