使用 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/