使用 Power Query 和 Azure DevOps 函式進行連線

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

適用于 Azure DevOps 的資料連線器包含Power Query M 函式，可供查詢作者使用。 這些函式可以為您處理 Azure DevOps 特定需求，例如驗證。 本文說明函式的引數，以及如何使用這些引數來連線到分析。

VSTS。AccountContents 函式是 Power Query M 函式Web.Contents 的替代專案。 適用于更進階的案例 VSTS。AccountContents 會以二進位值傳回從 Analytics URL 下載的內容。 您可以使用它來呼叫 AzureDevOps REST API。

重要

  • 使用 VSTS。AccountContents 僅適用于 存取 Analytics 中無法使用的資料。 它會直接從 Azure DevOps 提取資料，並保護其他 Azure DevOps 使用者，很容易受到節流影響。 請參閱 VSTS 支援的子域。本文稍後的 AccountContents 一節 。 如需其他方法的相關資訊，請參閱 Power BI 整合概觀。
  • VSTS。AccountContents 僅支援 (工作專案) Azure Boards資料。 資料連線器不支援其他資料類型，例如管線。 目前，我們沒有計劃更新連接器以支援其他資料類型。

VSTS。AccountContents

進階函式，傳回從 Analytics URL 下載的內容做為二進位值。

函 VSTS.AccountContents 式具有與 相同的引數、選項和傳回值格式 Web.Contents 。 如需詳細資訊，請參閱Power Query (M) 公式參考 - Web.Contents。

如果您已經使用 Web.Contents 從 Analytics (REST API 或 OData) 存取工作追蹤資料，您可以將它 VSTS.AccountContents 取代為 ，以使用資料連線器驗證。 它會通知 Power BI 這些要求參考相同的資料來源。 您可以結合資料，而不違反 Power BI 服務中的單一資料來源條件約束。 不過， VSTS.AccountContent 僅支援來自Azure Boards的資料，而且無法用來支援管線或其他服務的查詢。

'VSTS。AccountContents' 提供可透過 'OData.Contents' 取得的引數和選項子集。 下表概述特定限制：

VSTS 的引數。內容

引數 描述
url 其中一個 Azure DevOps 服務端點的 URL。
options 用來控制此函式行為的選項記錄。

VSTS 的選項欄位。內容

欄位 描述
IsRetry 將此邏輯值指定為 true 會在擷取資料時忽略快取中的任何現有回應。
ManualStatusHandling 將此值指定為清單，可防止回應具有下列其中一個狀態碼的 HTTP 要求內建處理。
MaxSize 控制用戶端感興趣的資料表大小上限。 如果要求超過此限制，則伺服器可以立即失敗要求。 預設值為零，可告訴伺服器伺服器使用其預設值。
Query 以程式設計方式將查詢參數新增至 URL。
RelativePath 在提出要求之前，請將此值指定為文字附加至基底 URL。
Timeout 將此值指定為持續時間，將會變更 HTTP 要求的逾時。 預設值為 600 秒。
Version 資料模型的版本。 此選項是診斷的主要選項。

VSTS 支援的子域。AccountContents

目前，此方法 VSTS.AccountContents() 僅適用于下面所列的子域。 尚未支援其他服務，例如發行服務：

  • https://dev.azure.com/
  • https://analytics.dev.azure.com/
  • https://vsrm.dev.azure.com/