前言

数据库迁移是每个开发者都将面对的挑战，尤其是在项目持续扩展、数据库架构频繁调整的背景下，如何确保数据一致性并顺利完成迁移，常常成为一项复杂且容易出错的任务。幸运的是，Flyway 这款开源工具应运而生，它简化了数据库迁移的流程。通过自动化管理迁移脚本，Flyway 让数据库架构的变动变得更加规范、可控。今天，我们将一同探索 Flyway，掌握如何高效执行数据库迁移，从此告别复杂的手动操作，让工作流程更加顺畅。

简介

Flyway 是一款广受欢迎的数据库迁移工具，它支持多种数据库（如 MySQL、PostgreSQL、Oracle 等）。通过 Flyway，开发者可以轻松管理数据库的版本控制，从而确保开发、测试、生产等不同环境中的数据库结构保持一致。

在 Flyway 中，数据库迁移是通过执行 SQL 脚本来完成的。这些 SQL 脚本按顺序执行，Flyway 会确保每个迁移都只被执行一次，避免重复执行。这使得团队合作中的数据库变更管理变得更加规范化、自动化。

专业名词

迁移（Migration）：指对数据库结构进行变更的操作，包括但不限于添加表、修改字段、插入数据等。每一次迁移都代表一次数据库架构的更新。

版本化迁移（Versioned Migrations）：每个迁移脚本都附带一个唯一的版本号，确保数据库迁移按照指定的顺序逐步应用，从而避免冲突和重复操作。

未执行（Pending）：已添加至 Flyway 管理中的迁移脚本，但尚未被应用到数据库中。它们等待执行，直到数据库迁移进程运行时才会生效。

已执行（Executed）：指已成功应用至数据库的迁移脚本。Flyway 会记录并标记每个已执行的迁移，确保其不会重复运行。

Flyway 命令（Flyway Commands）：包括多个数据库迁移相关命令，如 Migrate（应用迁移脚本）、Clean（清理数据库）、Info（查看迁移状态）等，这些命令帮助开发者高效管理数据库的迁移与版本控制。

关键点

跨平台支持：Flyway 支持多种主流数据库类型，如 MySQL、PostgreSQL、Oracle 等，使其成为跨平台开发团队管理数据库迁移的理想工具。

版本化管理：数据库迁移脚本通过版本控制管理，每个脚本都附带唯一的版本号，确保迁移严格按照顺序执行，从而避免潜在的冲突与遗漏。

多方式操作：Flyway 提供命令行工具（CLI）和桌面应用两种方式，开发者可根据需求选择最合适的方式进行数据库迁移管理，实现灵活、高效的操作体验。

操作步骤

1.在“迁移”标签页中，您应该能够看到刚刚添加的脚本处于“待处理（Pending）”状态。

2.右侧下拉菜单中会显示可用的 Flyway 命令。请确保选择“迁移（Migrate）”选项，然后点击“运行迁移（Run migrate）”按钮。

如果您希望查看将要执行的实际 Flyway 命令，请先展开“查看命令（x 参数）”部分。我们希望这能帮助您学习不同的 CLI 语法，以便日后在 CI/CD 系统中自动化此过程。

3.Flyway Desktop 应显示迁移已成功完成。

4.点击“关闭（Close）”，然后取消勾选“仅显示待处理迁移（Only show pending migrations）”。此时，您将看到迁移状态为“成功（Success）”，并能查看执行该迁移脚本所花费的时间。

5.接下来，我们将重复此过程添加第二个迁移脚本。点击“+ 添加迁移（Add migration）”。

6.输入以下详细信息：

a. 类别（Category）：版本化（应默认选中）

b. 版本（Version）：默认值为 002_yyyymmddhhmmss，时间戳默认包含，避免多个用户使用相同版本号。

c. 描述（Description）：添加人员

d. 脚本（Script）：

e.点击“保存（Save）”按钮。

7.这个新迁移应处于“待处理（Pending）”状态，因为它尚未应用到我们的目标数据库。

8.再次，右侧下拉菜单中显示可用的 Flyway 命令，您可以查看 CLI 命令。确保选择“迁移（Migrate）”选项，然后点击“运行迁移（Run migrate）”按钮。

9.Flyway Desktop 应显示迁移成功。点击“关闭”。

10.现在，第三个迁移显示为“成功（Success）”状态，您可以看到执行该迁移脚本所花费的时间。

11.要查看磁盘上的迁移脚本，请点击右上角的蓝色文件夹图标。

12.这将带您进入项目文件夹。双击“migrations”文件夹查看您的两个迁移脚本。

常见问题

1. 为什么 Flyway 的迁移脚本未执行？

迁移脚本未执行的原因可能是脚本的版本号未按顺序递增，或脚本文件名未遵循 Flyway 的命名规范。请确保每个迁移脚本的版本号独特且严格按时间顺序排列，以确保迁移脚本能被正确识别和执行。

2. 可以回滚数据库迁移吗？

Flyway 本身不支持直接回滚迁移操作。然而，您可以手动编写“撤销”脚本来实现回滚，或者通过数据库备份恢复之前的状态。通过这种方式，您可以有效管理和应对意外情况。

3. 如何自动化 Flyway 迁移？

您可以将 Flyway 命令集成进 CI/CD 流程，在每次部署时自动执行迁移。这样，迁移过程便能与代码发布同步进行，确保数据库始终保持最新状态，且不受人工操作干扰。

适用场景

1.跨团队协作

当多个开发者共同维护同一数据库时，Flyway 提供的迁移版本控制可以确保数据库架构的一致性，避免各自为政带来的冲突与混乱。

2.自动化部署

在 CI/CD 流程中，Flyway 自动执行数据库迁移，确保每次代码更新后数据库结构紧跟版本，消除手动迁移的繁琐，提升整体部署效率。

3.数据库变更版本控制

若希望通过代码管理数据库变更，Flyway 提供清晰的版本化方案，使得每次数据库变更都有据可依，简化变更管理过程，提升项目的可维护性。

注意事项

1.迁移脚本测试

在执行每个迁移脚本前，务必进行充分测试，确保脚本的正确性和兼容性，避免在生产环境中引发不可预见的风险。

2.定期检查迁移状态

在开发过程中，定期执行 Info 命令查看迁移状态，确保所有迁移脚本都已按时执行，避免遗漏重要的更新。

3.schema history 表的重要性

Flyway 依赖 schema history 表记录所有已执行的迁移。如果该表发生异常或损坏，可能会导致迁移失败。务必确保该表的完整性和稳定性。

最佳实践

1.命名规范

严格遵循 Flyway 的脚本命名规则，确保每个迁移脚本的版本号和描述都清晰、简洁且具有可读性。规范的命名有助于团队协作和迁移过程的可追溯性。

2.脚本验证

在将迁移脚本应用到生产环境之前，务必在开发和测试环境中进行充分验证。这样能够提前发现潜在问题，确保迁移脚本在正式环境中顺利执行。

3.分阶段迁移

针对大型数据库变更，建议将迁移脚本拆分为多个小阶段，逐步实施。这样能有效降低单次迁移带来的风险，并便于快速定位和解决问题。

总结

Flyway 使数据库迁移变得简洁高效。通过自动化的版本控制和迁移管理，开发者能够轻松维护数据库架构的一致性，同时提升团队协作效率。无论是在本地开发、持续集成，还是生产环境中，Flyway 都能有效地减少人工操作和潜在错误。如果你仍在为数据库迁移而困扰，Flyway 无疑是一个值得尝试的解决方案，它将帮助你彻底摆脱数据库变更的复杂和风险。