TFS 2015下QueryBuilds查询性能优化,高效获取永久保留构建属性
TFS 2015 永久保留构建检索性能优化
原实现的核心问题
- 逐构建定义循环调用
QueryBuilds(),会产生大量重复的网络往返请求,耗时随构建定义数量线性增长 - 默认查询逻辑会拉取构建关联的工作项、测试结果、日志摘要等全量字段,无关数据的传输开销占比极高
- 未在服务端做保留状态过滤,需要将所有构建记录拉取到本地后再判断
KeepForever值,冗余数据量极大 - 此前无法通过
IBuildDetailSpec拿到KeepForever属性值的核心原因:未配置查询的元数据加载范围,导致该属性与DropLocation始终返回默认空值
关键配置逻辑
- 基于
IBuildServer.CreateBuildDetailSpec()创建跨构建定义的全局查询规则,不需要逐定义单独发起请求 - 直接将
IBuildDetailSpec.KeepForever属性设置为true,由TFS服务端在数据库层面直接筛选出永久保留的构建,省略本地全量判断的逻辑 - 显式配置
InformationTypes字段,仅加载构建核心摘要元数据:- 指定加载
OverallSummary类型的信息,即可正常返回KeepForever、DropLocation属性值 - 不加载测试结果、构建日志、工作项关联等冗余内容,大幅降低传输开销
- 指定加载
- 可按需配置
MaxBuildsPerDefinition阈值,避免单次请求返回过多数据
优化后实现代码
public void BackupOnlyRetainedBuilds(string TeamProjectName, string DestinationPath) { // 初始化TFS连接 Uri configurationServerUri = new Uri("http://builder:8080/tfs"); TfsTeamProjectCollection server = new TfsTeamProjectCollection(configurationServerUri); var buildServer = (IBuildServer)server.GetService(typeof(IBuildServer)); // 创建全局构建查询规则 IBuildDetailSpec buildSpec = buildServer.CreateBuildDetailSpec(TeamProjectName); // 服务端直接过滤出永久保留的构建 buildSpec.KeepForever = true; // 仅加载需要的核心元数据,解决KeepForever、DropLocation返回空值的问题 buildSpec.InformationTypes = new string[] { BuildInformationTypes.OverallSummary }; // 可选:限制单定义返回的最大构建数 buildSpec.MaxBuildsPerDefinition = 1000; // 单次请求获取所有符合条件的构建记录 IBuildQueryResult queryResult = buildServer.QueryBuilds(buildSpec); IBuildDetail[] retainedBuilds = queryResult.Builds; // 执行部署包复制逻辑 foreach (var build in retainedBuilds) { string sourceDropPath = build.DropLocation; if (!Directory.Exists(sourceDropPath)) continue; // 创建目标目录结构 foreach (string dirPath in Directory.GetDirectories(sourceDropPath, "*", SearchOption.AllDirectories)) { Directory.CreateDirectory(dirPath.Replace(sourceDropPath, DestinationPath)); } // 复制所有构建产物文件 foreach (string filePath in Directory.GetFiles(sourceDropPath, "*.*", SearchOption.AllDirectories)) { File.Copy(filePath, filePath.Replace(sourceDropPath, DestinationPath), true); } } }
性能提升说明
- 网络往返次数从“构建定义数量次”降低为1次,大幅减少请求等待耗时
- 拉取的数据量从“全量构建记录”降低为“仅永久保留的构建记录”,通常可减少90%以上的传输数据
- 仅加载必要的核心字段,避免冗余信息加载带来的额外开销
- 配置后查询到的
KeepForever值与TFS Web端展示的“永久保留”标记完全一致,不存在数据偏差
内容的提问来源于stack exchange,提问作者Erelephant
相关产品推荐
相关产品推荐

