本地DevOps迁移Azure遇VS403286错误及集合挂载异常求助

一、解决dacpac被误判为配置数据库的问题 #

1. 确认目标数据库为集合库 #

• 检查数据库名称：本地DevOps的配置库默认命名为Tfs_Configuration，集合库通常为Tfs_<你的集合名称>，确保生成dacpac的是集合库而非配置库。
• 验证数据库扩展属性：执行SQL查询确认集合库标识：

  SELECT name, value 
  FROM sys.extended_properties 
  WHERE name IN ('TFS_COLLECTION_ID', 'TFS_SNAPSHOT_STATE')
  

  集合库会返回TFS_COLLECTION_ID的值，而配置库没有该属性；同时确认TFS_SNAPSHOT_STATE = 'complete'。

2. 重新生成纯净的集合库dacpac #

避免直接从分离的数据库备份生成dacpac，改用SqlPackage.exe直接从运行中的集合库提取（无需分离）：

SqlPackage.exe /Action:Extract 
/SourceServerName:"你的SQL服务器实例名" 
/SourceDatabaseName:"Tfs_你的集合名" 
/TargetFile:"C:\temp\Collection_Dev.dacpac" 
/ExtractAllTableData:true

提取完成后再用迁移工具测试，避免携带配置库的关联元数据。

3. 强制迁移工具指定集合库类型 #

如果使用官方Azure DevOps迁移工具，在启动迁移时通过参数明确指定集合数据库：

vstfm migrate /collection:"http://你的本地DevOps服务器:8080/tfs/你的集合" 
/targetTeamProject:"AzureDevOps项目名" 
/dacpac:"C:\temp\Collection_Dev.dacpac" 
/isCollectionDb:true

二、解决管理控制台无法识别分离数据库的问题 #

1. 检查运行权限 #

确保管理控制台的运行账户拥有SQL服务器的sysadmin权限，或至少能读取master库的系统视图（sys.databases、sys.extended_properties）。

2. 清除管理控制台缓存 #

• 关闭管理控制台，删除以下路径的缓存文件：

  C:\Users\<你的账户>\AppData\Local\Microsoft\Team Foundation\<版本号>\Cache
  

• 重新启动管理控制台，刷新服务器注册列表。

3. 验证数据库状态 #

执行SQL命令确认分离后的集合数据库状态正常：

SELECT name, state_desc, is_read_only 
FROM sys.databases 
WHERE name LIKE 'Tfs_%' AND name != 'Tfs_Configuration'

确保状态为ONLINE，且is_read_only = 0。

4. 用TfsConfig同步数据库列表 #

运行以下命令让服务器重新扫描数据库，再检查管理控制台：

TfsConfig.exe Configure /ListDatabases /ServerName:"你的SQL服务器实例名"

三、额外验证步骤 #

1. 用TfsConfig.exe成功挂载集合后，确认集合能正常访问（通过浏览器打开集合地址），再执行分离操作。
2. 尝试将分离的集合数据库恢复到一台测试SQL服务器，重新提取dacpac后再进行迁移测试，排除原服务器环境的干扰。

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