如何配置Flyway按顺序执行可重复迁移脚本解决函数依赖报错

核心原理 #

Flyway的可重复迁移脚本（即R__开头的脚本）默认按照文件名字典序依次执行，我们可以利用这个规则调整有依赖关系的脚本执行顺序。

解决方案 #

• 方案1：脚本名加数字前缀（最常用） #

  在R脚本的描述部分前增加数字前缀，被依赖的函数脚本使用更小的数字，保证排序在前。
  示例命名：
  • 创建FN_ID的脚本命名为：R__10_FN_ID.sql
  • 创建FN_ABC的脚本命名为：R__20_FN_ABC.sql
    数字前缀间隔建议设置为10/20，预留空间方便后续新增中间依赖的脚本，不需要批量重命名已有文件。

• 方案2：合并依赖对象到同一脚本 #

  如果函数之间的依赖关系非常复杂，可以把所有存在依赖关联的函数放在同一个R脚本中，在脚本内部按照依赖顺序写SQL语句：

  -- 先创建被依赖的FN_ID
  CREATE OR REPLACE FUNCTION ABC_SCHEMA.FN_ID() RETURNS TABLE (
         ID INT
      ) LANGUAGE SQL AS '
        SELECT 1 AS ID
  ';
  
  -- 再创建依赖FN_ID的FN_ABC
  CREATE OR REPLACE FUNCTION ABC_SCHEMA.FN_ABC() RETURNS TABLE (
         COLUMNS INT
      ) LANGUAGE SQL AS '
        SELECT ID from TABLE(ABC_SCHEMA.FN_ID()) AS c
  ';
  

  同一脚本内的SQL会按书写顺序执行，完全避免依赖顺序问题。

• 方案3：新增占位函数兼容（适配特殊场景） #

  针对支持函数覆盖的数据库，可以先创建所有被依赖函数的空实现占位，再执行正常的创建逻辑，适合存在循环依赖的特殊场景。

注意事项 #

• 函数、存储过程、视图这类可重复覆盖创建的对象，建议统一放在R脚本中管理，不要放在V开头的版本化迁移脚本中，避免后续修改产生大量冗余的版本脚本。
• 如果依赖链路很长，可以按模块分组设置数字前缀，比如公共工具函数用1xx前缀，业务函数用2xx前缀，保证公共层脚本永远先执行。

内容的提问来源于stack exchange，提问作者Karthik