Flyway自学之路-01（Flyway简介）

约定不等于承诺〃 2023-02-11 15:28 9阅读 0赞

# 1.1、Flyway是什么 #

Flyway是一款数据库迁移（migration）工具。简单点说，就是在你部署应用的时候，帮你执行数据库脚本的工具。Flyway支持SQL和Java两种类型的脚本，你可以将脚本打包到应用程序中，在应用程序启动时，由Flyway来管理这些脚本的执行，这些脚本被Flyway称之为migration。

就目前而言，我们部署应用的流程大概是这样的：

1.  开发人员将应用程序打包、按顺序汇总并整理数据库升级脚本
2.  DBA拿到数据库升级脚本检查、备份、执行，以完成数据库升级
3.  应部署人员拿到应用部署包，备份、替换，以完成应用程序升级

引入Flyway之后的应用部署流程大概是这样的：

1.  开发人员将应用程序打包
2.  应部署人员拿到应用部署包，备份、替换，以完成应用程序升（Flyway将自动执行升级/备份脚本）

# 1.2、Flyway如何工作 #

最简单的理解方式是：简单我们在一个空数据库上部署集成了Flyway的应用：

![è¿éåå¾çæè¿°][70]

Flyway将在这个空数据中创建一张表，用于记录migration的执行情况，表名称默认为：flyway\_schema\_histor，老版本的表名称：schema\_version

![迁移][format_png]

![è¿éåå¾çæè¿°][70 1]

紧接着，Flyway根据表中的记录决定是否执行应用程序包中提供的migration

![è¿éåå¾çæè¿°][70 2]

最后将执行结果写入flyway\_schema\_histor并校验执行结果

![è¿éåå¾çæè¿°][70 3]

flyway\_schema\_histor打印有关所有迁移的详细信息和状态信息。

![信息][format_png 1]

信息可让您知道自己的立场。一览无余，您将看到哪些迁移已被应用，哪些迁移仍在等待执行，何时执行以及它们是否成功。

下次版本迭代时，提供新的migration，会根据flyway\_schema\_histor的记录执行新migration

![è¿éåå¾çæè¿°][70 4]

![è¿éåå¾çæè¿°][70 5]

![è¿éåå¾çæè¿°][70 6]

# 验证 #

对照可用迁移验证已应用的迁移。

![验证][format_png 2]

验证可帮助您验证应用于数据库的迁移是否与本地可用的迁移匹配。

这对于检测可能阻止您可靠地重新创建架构的意外更改非常有用。

# 基准线 #

对现有数据库进行基准测试，不包括直到及包括baselineVersion的所有迁移。

![基准线][format_png 3]

基准是通过将特定[数据库][Link 1]作为基准对Flyway引入[现有数据库][Link 1]。这将导致[Migrate][]忽略直到基线版本（包括基线版本）的所有迁移。然后，将照常应用较新的迁移。

[修理 ][Link 2]

# 1.3、Migration #

Flyway将每一个数据库脚本称之为：migrations，flyway支持三种类型的migration：

1.  Versioned migrations：最常用的migration，可以简单的理解为数据库升级脚本
2.  Undo migrations：数据库版本回退脚本，需要Pro版本，忽略，而且使用过程存在较大风险，undo操作目前只能通过plugin或者command-line来执行
3.  Repeatable migrations：可重复执行的migration，例如create or replace脚本，当脚本checksums改变时会重新执行

SQL：简单的SQL脚本文件，例如：

/* Single line comment */
    CREATE TABLE test_user (
      name VARCHAR(25) NOT NULL,
      PRIMARY KEY(name)
    );
    
    /*
    Multi-line
    comment
    */
    -- Placeholder
    INSERT INTO ${tableName} (name) VALUES ('Mr. T');

# 1.4、所有的migration都需要遵守命名规范 #

![è¿éåå¾çæè¿°][70 7]

文件名由以下部分组成：

*  **前缀**：`V`用于版本控制（可[配置][Link 3]）， `U`用于撤消（可[配置][Link 4]）和 `R`可重复迁移（可[配置][Link 5]）
 *  **版本**：带点或下划线的版本可根据需要分隔尽可能多的部分（不适用于可重复的迁移）
 *  **分隔符**：（`__`两个下划线）（可[配置][Link 6]）
 *  **说明**：下划线或空格分隔单词
 *  **后缀**：`.sql`（[配置][Link 7]）

可选的版本化SQL迁移也可以省略分隔符和描述。

确保版本号唯一，flyway按照版本号顺序执行。repeatable没有版本号，因为repeatable migrations会在内容改变时重复执行。

## 1.5、官网文档链接 ##

*  [https://flywaydb.org/documentation/][https_flywaydb.org_documentation]

[70]: https://img-blog.csdn.net/20180614134116490?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9mbHl3YXlkYi5vcmcvYXNzZXRzL2JhbHNhbWlxL2NvbW1hbmQtbWlncmF0ZS5wbmc?x-oss-process=image/format,png
[70 1]: https://img-blog.csdn.net/20180614134153902?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 2]: https://img-blog.csdn.net/20180614134223343?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 3]: https://img-blog.csdn.net/20180614134240674?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9mbHl3YXlkYi5vcmcvYXNzZXRzL2JhbHNhbWlxL2NvbW1hbmQtaW5mby5wbmc?x-oss-process=image/format,png
[70 4]: https://img-blog.csdn.net/2018061413430553?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 5]: https://img-blog.csdn.net/20180614134326674?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 6]: https://img-blog.csdn.net/20180614134342785?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9mbHl3YXlkYi5vcmcvYXNzZXRzL2JhbHNhbWlxL2NvbW1hbmQtdmFsaWRhdGUucG5n?x-oss-process=image/format,png
[format_png 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9mbHl3YXlkYi5vcmcvYXNzZXRzL2JhbHNhbWlxL2NvbW1hbmQtYmFzZWxpbmUucG5n?x-oss-process=image/format,png
[Link 1]: https://flywaydb.org/documentation/existing
[Migrate]: https://flywaydb.org/documentation/command/migrate
[Link 2]: https://flywaydb.org/documentation/command/repair
[70 7]: https://img-blog.csdn.net/20180614134432985?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NoZW5sZWlraW5n/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[Link 3]: https://flywaydb.org/documentation/commandline/migrate#sqlMigrationPrefix
[Link 4]: https://flywaydb.org/documentation/commandline/migrate#undoSqlMigrationPrefix
[Link 5]: https://flywaydb.org/documentation/commandline/migrate#repeatableSqlMigrationPrefix
[Link 6]: https://flywaydb.org/documentation/commandline/migrate#sqlMigrationSeparator
[Link 7]: https://flywaydb.org/documentation/commandline/migrate#sqlMigrationSuffixes
[https_flywaydb.org_documentation]: https://flywaydb.org/documentation/