migrating-dbt-project-across-platforms
该技能用于将 dbt 项目从一个数据平台迁移到另一个数据平台(例如从 Snowflake 迁移到 Databricks,或反向迁移)。其核心方法是借助 dbt Fusion 的实时 SQL 编译与详细错误日志进行方言转换:读取 Fusion 报错、修复、重新编译,循环迭代直至通过。迁移前会在源平台生成 dbt 单元测试作为“黄金数据集”,迁移后在目标平台运行这些测试以验证数据一致性。成功标准为:dbtf compile 在目标平台 0 错误 0 警告、所有单元测试通过、所有模型运行成功。迁移过程使用 dbtf compile 作为主要迭代门槛(免费、不消耗仓库计算),仅在编译干净后才执行 dbtf run 和 dbt test。工作流共 7 步:验证 dbt Fusion 安装、评估源项目、在源平台生成单元测试、切换 dbt target、运行 Fusion 编译并修复错误、运行并验证单元测试、最终验证并记录变更。该技能还包含禁止事项(不预先修复 Fusion 未报告的问题、不跳过单元测试、不使用 dbtf run 做迭代验证等)和已知限制(如 Fusion 2.0 版本化模型单元测试可能报错 dbt1048、需清除 target 缓存、Python 模型 dbt.ref() 验证问题等)。