如何将语义模型从Dev工作区迁移至UAT工作区并切换数据源

手动调整（适合少量模型场景） #

• 打开UAT工作区的语义模型编辑器，定位到数据源配置模块
• 替换仓库连接信息：将原Dev环境Gold Layer Warehouse的连接地址、认证信息替换为UAT自建Gold Warehouse的对应内容
• 批量映射数据表：若UAT仓库表结构与Dev完全一致，可使用编辑器的「批量刷新数据源」功能自动映射；若有差异，逐一核对并调整每个表的数据源指向
• 验证发布：保存修改后执行数据刷新，确认连接正常、数据加载无误，再发布更新后的语义模型

配置化管理（适配GitHub版本控制场景） #

• 在GitHub仓库中，将语义模型的数据源配置抽离为环境专属文件（如dev_config.json、uat_config.json），避免硬编码仓库地址
• 修改模型代码中的数据源引用逻辑，改为读取对应环境配置文件中的变量
• 在UAT工作区部署时，指定加载uat_config.json，让模型自动指向UAT的Gold Warehouse
• 将配置文件提交至GitHub，确保后续CI/CD部署流程自动适配UAT环境的数据源

dbt语义模型专属操作 #

• 在dbt项目的profiles.yml中，新增UAT环境的仓库连接配置（包含仓库地址、认证方式、数据库名称等）
• 执行命令 dbt run --target uat，让模型在UAT目标环境下编译，自动关联UAT仓库的数据表
• 检查target/目录下生成的语义模型文件，确认数据源已切换至UAT仓库，再部署到UAT工作区

注意事项 #

• 确保UAT仓库的表结构、字段类型与Dev仓库完全匹配，避免模型出现字段缺失或类型不兼容错误
• 修改前备份UAT工作区现有语义模型，防止操作失误无法回滚
• 团队协作时同步更新GitHub仓库中的配置，保证后续部署都使用正确的数据源

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