Azure DevOps API WIQL 获取最大最大工作项 ID

问题描述

我正在使用 wiql 查询 Azure DevOps 中的工作项列表。但是，Azure DevOps 将在单个查询中最多返回 20000 个工作项。如果查询结果包含超过 20000 个项目，则返回错误代码而不是工作项目。为了获取与我的查询匹配的所有工作项的列表，我修改了查询以过滤我的 ID，然后循环构建具有多个查询的工作项列表。问题是显然无法知道我何时到达循环结束，因为我不知道系统中的最大工作项 ID。

idlist = []
max_items_per_query = 19000
counter = 0
while not done:
  wiql = ("SELECT [System.Id] FROM WorkItems WHERE [System.WorkItemType] IN ('User Story','Bug') 
  AND [System.AreaPath] UNDER 'mypath' AND System.ID >= count AND System.ID < counter + max_items".format(counter,counter + max_items_per_query))

  url = base_url+'wiql'
  params = {'api-version':'4.0'}
  body = {'query':wiql}

  request = session.post(url,auth=('',personal_access_token),params=params,json=body)

  response = request.json()
  newItems = [w['id'] for w in response['workItems']]
  idlist.extend(newItems)

  if not newItems:
    done = True

这在大多数情况下都有效，但如果在指定区域路径下遇到工作项 ID 中的间隙，则循环会过早退出。理想情况下，如果有一种方法可以查询系统中的最大工作项 ID，然后在计数器达到该值时使用此数字退出，我就可以完成这项工作。但是，我找不到办法做到这一点。有没有办法查询这个数字或可能的其他解决方案，让我获得符合特定条件的所有工作项目的列表？

解决方法

您可以使用 $top 参数获取最后一个。

类似于下面的内容（这只是示例 - 您可以将其扩展到您的查询）

SELECT [System.Id] FROM workitems WHERE [System.Id] > 0 ORDER BY [System.Id] DESC with $top = 1

这将返回最大系统 ID - 因为它按降序排列。

建议：

你也可以像下面一样改变你的逻辑：

SELECT [System.Id] FROM workitems WHERE [System.Id] > 0 ORDER BY [System.Id] ASC with $top = 5000

获取第 5000 个项目 System.Id ，让我们假设它是 5029

下一个查询是：

SELECT [System.Id] FROM workitems WHERE [System.Id] > 5029 ORDER BY [System.Id] ASC with $top = 5000

您将获得从系统 ID-5029 开始的接下来的 5000 个项目。

您可以循环上述逻辑。

对于循环的退出情况，您可以检查作为迭代一部分返回的项目数 - 如果小于 5000，则迭代结束。