You need to enable JavaScript to run this app. TFS 2015下QueryBuilds查询性能优化,高效获取永久保留构建属性
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 23:45:05