Flyway入门使用

Flyway入门使用

官网：https://flywaydb.org/

导入jar包

<!-- flyway -->
<dependency>
	<groupId>org.flywaydb</groupId>
	<artifactId>flyway-core</artifactId>
</dependency>
<!-- flyway 插件 可有可无-->
<plugin>
   <groupId>org.flywaydb</groupId>
   <artifactId>flyway-maven-plugin</artifactId>
	 <configuration>
	 <user>root</user>
	 <password>1234500</password>
	 <driver>com.mysql.cj.jdbc.Driver</driver>
	 <url>jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&amp;characterEncoding=UTF8&amp;useJDBCCompliantTimezoneShift=true&amp;useLegacyDatetimeCode=false&amp;serverTimezone=Asia/Shanghai&amp;useSSL=false</url>
 <baselineOnMigrate>true</baselineOnMigrate>
 <!--//sql脚本位置，flyway会自动去找到这个目录并且执行里面的sql脚本-->
		<locations>classpath:db/migration/</locations>
	</configuration>
 </plugin>

配置yml文件

spring:
  flyway:
    url: jdbc:mysql://127.0.0.1:3306/flyway?useUnicode=true&characterEncoding=UTF8
    user: root
    password: 自己的
    # 启用或禁用 flyway
    enabled: true
    # flyway 的 clean 命令会删除指定 schema 下的所有 table, 生产务必禁掉。这个默认值是 false 理论上作为默认配置是不科学的。
    clean-disabled: true
    # SQL 脚本的目录,多个路径使用逗号分隔 默认值 classpath:db/migration
    locations: classpath:db/migration
    #  metadata 版本控制信息表 默认 flyway_schema_history
    table: flyway_schema_history
    # 如果没有 flyway_schema_history 这个 metadata 表， 在执行 flyway migrate 命令之前, 必须先执行 flyway baseline 命令
    # 设置为 true 后 flyway 将在需要 baseline 的时候, 自动执行一次 baseline。
    baseline-on-migrate: true
    # 指定 baseline 的版本号,默认值为 1, 低于该版本号的 SQL 文件, migrate 时会被忽略
    baseline-version: 1
    # 字符编码 默认 UTF-8
    encoding: UTF-8
    # 是否允许不按顺序迁移 开发建议 true  生产建议 false
    out-of-order: true
    # 需要 flyway 管控的 schema list,这里我们配置为flyway  缺省的话, 使用spring.datasource.url 配置的那个 schema,
    # 可以指定多个schema, 但仅会在第一个schema下建立 metadata 表, 也仅在第一个schema应用migration sql 脚本.
    # 但flyway Clean 命令会依次在这些schema下都执行一遍. 所以 确保生产 spring.flyway.clean-disabled 为 true
    schemas: flyway
    # 执行迁移时是否自动调用验证   当你的 版本不符合逻辑 比如 你先执行了 DML 而没有 对应的DDL 会抛出异常
    validate-on-migrate: true

添加文件夹

一 。在resources下建个db文件
然后再db文件下再建个migration文件这个文件就是用来放.sql文件的。
二。如果你不想这样建文件，你要在yml文件更改配置
# SQL 脚本的目录,多个路径使用逗号分隔 默认值 classpath:db/migration
locations: classpath:自己的文件名
三 。如果在创建springBoot项目时的Dependencies层中加了Flyway它会自动创建db.migration文件
注：在SQL加Flyway Migration

添加sql文件到db/migration
如果没有添加在启动项目时会报错。
文件可在数据库生成，右击表选择转储SQL文件
文件命名规则

V(Versioned Migrations):
每个文件只会被执行一次
version必须唯一，可以用递增的整型和点（.）组合 例：V1.0.0__Add_table_bd_article.sql

启动项目
诺一切正常将在数据库生成一个
flyway_ schema_history（架构历史记录表）

数据库修改时
再建一个sql文件将要更改的东西写在新的sql文件里，老版sql文件的东西不要改任何东西，否者会包错。
例：V1.0.1 __ Add _ table _ bd _ article.sql将版本号加一。
包错笔记
1.如果你的SQL脚本运行失败，到schema_version表中删除version版本相同的记录。