共用方式為

解決與分析檢視相關聯的錯誤

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

分析檢視提供簡化的方式，可根據分析數據指定Power BI報表的篩選準則。 分析提供 Azure DevOps 的報告平臺。 你可以在 Azure DevOps 的網頁入口網站管理分析視圖，然後用 Power BI 資料連接器存取它們。

本文提供針對分析檢視常見問題的故障排除指引，包括大小警告、驗證錯誤及 Power BI 連線問題。

重要

分析檢視僅支援 Azure Boards 資料（工作專案）。 分析檢視不支援其他數據類型，例如管線。 檢視提供扁平的工作項目清單，且不支援工作項目階層。 此時，沒有計劃更新連接器以支援其他類型的數據。 如需其他方法的相關信息，請參閱 關於PowerBI整合。

先決條件

類別 要求
存取層級 - 專案成員。
- 至少 基本 存取權。
權限 根據預設，項目成員具有查詢分析及建立檢視的許可權。 如需有關服務與功能啟用和一般數據追蹤活動之其他必要條件的詳細資訊，請參閱 存取 Analytics的許可權和必要條件。

解決尺寸警示

警告：此檢視可能包含太多數據

當 Power BI 判斷無法載入檢視中包含的所有數據時，就會出現此警告。 當您尚未在檢視中指定足夠的篩選，或已指定以每日數據粒度載入所有歷程記錄時，通常會發生此情況。

解決步驟：

  1. 新增更具體的篩選條件：套用額外的 工作項目篩選 器以縮小資料範圍：

    • 依特定工作項目類型篩選（錯誤、使用者故事、任務）
    • 限制於特定領域或迭代
    • 套用狀態過濾器（啟用、已解決、關閉）
    • 設定創建或修改日期的日期範圍過濾器

  2. 調整歷史設定：修改 歷史或細緻度以擴大 檢視結果範圍：

    • 從「所有歷史」改為特定時間範圍（過去30、60或90天）
    • 將細緻度從每日增加到每週或每月
    • 如果你不需要歷史趨勢資料，請使用「僅目前」

  3. 儲存前請先驗證：儲存前務必 先驗證 你的檢視，以確保它能在 Power BI 中順利載入。

小提示

拉取大量資料的檢視在 Power BI 中可能需要很長時間才能重新整理和載入。 對於擁有大量資料的組織，甚至可能無法完全載入。

解決驗證錯誤

錯誤：欄位 'FieldName' 已經存在

這個錯誤表示你的專案其中一個 自訂欄位 與 Analytics 欄位名稱相同。

主意： 重新命名你的自訂欄位以避免命名衝突。 如果你沒有修改自訂欄位的權限，請聯絡你的專案管理員。

錯誤：欄位已不存在

此錯誤表示您的 工作項目篩選 或 檢視欄位 中，引用了已從 專案流程中移除的欄位。

解決步驟：

  1. 在 Azure DevOps 中編輯你的檢視。
  2. 前往 「工作項目 」或 「欄位 」標籤。
  3. 移除與已刪除欄位相關的篩選器或欄位。
  4. 驗證並儲存該畫面。

錯誤：過濾條件無效

當你的專案中過濾器值不再存在（例如已刪除區域、迭代或工作項目狀態）時，會發生此錯誤。

解決方案： 檢視並更新篩選條件，以使用您專案中當前有效的值。

解決 Power BI 連線錯誤

分析檢視不存在，或者你沒有權限查看

在您嘗試刷新 Power BI 中已不存在於 Azure DevOps 的視圖時，會出現這個錯誤。

常見原因：

  • 該視圖被重新命名或刪除
  • 你存取該視圖的權限已被移除
  • 視圖從 共享 改為 私人
  • 組織或專案存取權被撤銷

重新整理失敗 - 檢視不存在

解決步驟：

  1. 驗證檢視存取權限：登入 Azure DevOps 並確認你能存取檢視。
  2. 檢查權限：確保你有 使用該視圖的權限。
  3. 驗證分析權限：確認您擁有 專案的「檢視分析 」權限。
  4. 更新 Power BI：如果檢視被重新命名，請在 Power BI 中更新連線，使用新名稱。
  5. 移除損壞的資料表：如果該檢視已經不存在，請從你的 Power BI 報告中刪除該資料表。

該領域已存在於紀錄中

此錯誤表示某個自訂欄位與 Azure DevOps 保留欄位的顯示名稱相同，導致 Power BI 產生碰撞。

解決方法：

  1. 在 Azure DevOps 中編輯檢視。
  2. 前往 欄位 標籤。
  3. 從 欄位列表中移除重複欄位。
  4. 儲存視圖並在 Power BI 中重新整理。

查詢結果超過大小上限

當你的檢視回傳超過 250,000 筆紀錄，超出 Power BI 的載入限制時，會發生此錯誤。

解決步驟：

  1. 新增時間篩選器：限制日期範圍（從過去30到90天，而非所有歷史紀錄）。
  2. 篩選工作項目：套用更具體的工作項目類型、區域或迭代過濾器。
  3. 提升細緻度：資料點由每日調整為每週或每月。
  4. 分割視圖：建立多個較小的視圖，而非一個大視圖。

認證與存取錯誤

錯誤訊息：

  • 「使用者未被授權」
  • 「禁止進入該資源」
  • 「專案不存在，或者你沒有權限」

解決步驟：

  1. 檢查專案存取權：確認你是 Azure DevOps 專案的成員。
  2. 驗證 Analytics 權限：確保您擁有 Analytics 存取權限。
  3. 檢視憑證：清除 Power BI 憑證後重新登入。
  4. 聯絡管理員：與您的專案管理員合作解決權限問題。

利用 AI 來排解分析檢視的問題

以下 Copilot Chat 的範例提示幫助你排除 Analytics 檢視與 Power BI 整合問題。 將此提示複製貼上到 Copilot Chat，並用你的具體資訊取代佔位符。

為了獲得最佳的 AI 協助，請提供具體細節，例如你的 Analytics 檢視名稱、Power BI Desktop 版本、欄位名稱，以及可能與問題相關的篩選器設定。

I'm getting this Azure DevOps Analytics view error: [PASTE YOUR ERROR MESSAGE HERE]

Analytics view details:
- View name: [YOUR VIEW NAME]
- Organization: [YOUR ORGANIZATION NAME]
- Project: [YOUR PROJECT NAME]
- Power BI Desktop version: [YOUR VERSION]
- Specific fields or filters involved: [LIST RELEVANT FIELDS/FILTERS]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the Analytics view problem
2. Fix the view configuration or Power BI connection issue
3. Verify the Analytics view loads correctly in Power BI

Context: This is for an Analytics view in Azure DevOps that I'm trying to connect to Power BI. The error might be related to view verification, field conflicts, data size limits, or Power BI refresh issues.

Copilot 是由 AI 所提供，因此可能會有驚喜和錯誤。 如需詳細資訊，請參閱 Copilot 一般使用常見問題。

進階疑難排解

效能優化

如果你的分析檢視載入緩慢或逾時：

  1. 減少欄位選擇：只包含報告中真正需要的欄位。
  2. 使用適當的細緻度：每月或每週的資料載入速度比每日快。
  3. 套用有效的過濾條件：應在資料管線的初始階段進行過濾，而非在 Power BI 中。
  4. 考慮增量更新：在 Power BI 中為大型資料集設定增量更新。

資料刷新問題

針對自動刷新的問題：

  1. 驗證憑證：確保 Power BI 服務中儲存的憑證有效。
  2. 檢查檢視權限：確認服務帳號是否能存取分析檢視。
  3. 監控閘道連接：如適用，確認本地閘道連接性。
  4. 檢視刷新歷史：請查看 Power BI 的更新日誌以了解具體錯誤細節。
  • Last updated on