共用方式為


使用 Power Query 和 Azure DevOps 函式連線

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

適用於 Azure DevOps 的資料連接器包含查詢作者可以使用的 Power Query M 函式。 這些函式可以處理 Azure DevOps 特定需求,例如驗證。 本文說明函式的引數,以及如何使用這些引數連線到 Analytics。

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。帳戶內容

進階函式,將從 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 的論點。內容

Argument Description
url 其中一個 Azure DevOps 服務端點的 URL。
options 用於控制此函數行為的選項記錄。

VSTS 的選項欄位。內容

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

VSTS 支援的子網域。帳戶內容

目前,該 VSTS.AccountContents() 方法僅適用於下面列出的子域。 尚不支援其他服務,例如發行服務:

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