分析的數據模型
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Azure DevOps 的分析數據模型是由實體集所組成，其成員（實體）包含可篩選、匯總和摘要的屬性。 此外，它們還包含 將實體與其他實體建立關聯的導覽屬性 ，以提供其他屬性的存取權，以供選取、篩選和分組。
注意
所有 Azure DevOps Services 的生產環境中都會自動啟用及支援 Analytics 服務。 Power BI 整合 及存取 Analytics Service 的 OData 摘要 已正式推出。 我們鼓勵您使用它，並提供意見反應給我們。
可用的數據與版本相關。 最新支援的版本是 v2.0，而最新的預覽版本是 v4.0-preview。 如需詳細資訊，請參閱 OData API 版本控制。
注意
Azure DevOps Server 2020 和更新版本的所有新專案集合都會在生產環境中自動安裝並支援 Analytics 服務。 Power BI 整合 及存取 Analytics Service 的 OData 摘要 已正式推出。 我們鼓勵您使用它，並提供意見反應給我們。 如果您從 Azure DevOps Server 2019 升級，則可以在升級期間安裝 Analytics 服務。
可用的數據與版本相關。 最新支援的版本是 v2.0，而最新的預覽版本是 v4.0-preview。 如需詳細資訊，請參閱 OData API 版本控制。
注意
Azure DevOps Server 2019 的 Analytics 服務處於預覽狀態。 您可以 啟用或安裝 專案集合。 Power BI 整合 和分析 服務的 OData 摘要 存取處於預覽狀態。 我們鼓勵您使用它，並提供意見反應給我們。
可用的數據與版本相關。 最新支援的版本是 v2.0，而最新的預覽版本是 v4.0-preview。 如需詳細資訊，請參閱 OData API 版本控制。
架構命名空間
分析資料模型是以兩個架構命名空間為基礎：
Microsoft.VisualStudio.Services.Analytics.ModelMicrosoft.VisualStudio.Services.Analytics.
實體集和實體類型
實體類型是具有索引鍵的具名結構化型別。 他們會定義每個實體的具名屬性和關聯性。 的EntityType索引鍵是由基本屬性的子集所組成，例如 WorkItemId、PipelineId、ReleasePipelineId 等等實體類型。
實體集是實體的具名集合。 例如， WorkItems 是包含實體的 WorkItem 實體集。 實體的索引鍵可唯一識別實體集內的實體。 如果多個實體集使用相同的實體類型，索引鍵值的相同組合可能會出現在多個實體集中並識別不同的實體，每個實體集都會顯示此索引鍵組合。 每個實體都有不同的實體標識碼。實體集提供數據模型的進入點。
實體集會在 OData 元數據中描述，並依專案而有所不同。 您可以藉由要求專案的 OData 元數據，來探索實體集、實體類型和屬性的完整清單。 若要瞭解如何，請參閱 建構分析的 OData 查詢。
複合實體
複合實體支援特定案例。 它們是由較簡單的實體所組成，通常需要更多運算資源來產生，而且可能會傳回較大的結果集。 若要達到最佳效能並避免不必要的節流，請確定您查詢案例的正確實體。
例如， WorkItemSnapshot 結合 WorkItemRevisions 和 Dates ，讓每個日期每個工作專案都有一個修訂。 此表示法支援將焦點放在已篩選工作專案集趨勢數據的 OData 查詢。 不過，您不應該使用此複合實體來查詢工作專案的目前狀態。 相反地，您應該使用 WorkItems 實體集來產生更快速執行的查詢。
同樣地，某些實體可能包含所有歷史值，而其他實體可能只包含目前的值。 WorkItemRevisions 包含所有工作專案歷程記錄，您不應該在目前值感興趣的案例中使用。
關聯性
若要產生更複雜的查詢結果，您可以使用關聯性來合併實體。 您可以使用關聯性來展開、篩選或摘要數據。
某些導覽屬性會產生單一實體，而其他則會產生實體的集合。 下圖顯示選取實體及其導覽屬性。 為了清楚起見，已省略一些複合實體和關聯性。
關聯性索引鍵
實體關聯性也會表示為外鍵，讓外部工具可以聯結實體。 這些屬性具有後綴 「SK」 而且是整數或 GUID 數據類型。 日期屬性具有具有下列格式的對應整數日期索引鍵屬性： YYYYMMDD。
工作追蹤實體類型和實體集
指定的 API 版本支援下列實體類型和實體集。 如需完整的參考，請參閱 Azure Boards Analytics 的工作追蹤元數據參考。
EntityType/EntitySet |
描述 | v1.0 | v2.0 | v3.0-preview | v4.0-preview |
|---|---|---|---|---|---|
| 適用範圍/ 區域 |
工作專案 區域路徑，具有依區域階層分組和篩選的屬性。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 反覆程序/ 反覆運算 |
工作專案 反覆運算路徑，具有依反覆運算階層分組和篩選的屬性。 | ✔️ | ✔️ | ✔️ | ✔️ |
| BoardLocation/ BoardLocations |
面板數據格位置，如板柱、泳道和分割所識別，包括歷史板設定。 如需每個面板欄位的描述，請參閱 工作流程和面板欄位。 | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate/ 日期 |
用來使用關聯性來篩選和分組其他實體的日期。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 計畫/ 專案 |
針對組織（雲端）或專案集合（內部部署）定義的所有專案。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 處理/ 程序 |
用來展開或篩選工作專案和工作專案類型的待辦項目資訊。 如需使用 進程 來篩選報表的範例，請參閱 需求追蹤範例報告。 | ✔️ | ✔️ | ✔️ | |
| 標籤/ Tags (標籤) |
每個專案的所有工作項目標記。 如需使用 標籤 來篩選報表的範例，請參閱 發行燒毀範例報表。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 小組/ 團隊 |
針對項目定義的所有小組。 如需使用 Teams 篩選報表的範例，請參閱 將小組交叉分析篩選器新增至Power BI報表。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 使用者/ 使用者 |
用來展開或篩選各種工作專案屬性的用戶資訊，例如 [指派給]、 [建立者]。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemBoardSnapshot/ WorkItemBoardSnapshot |
（綜合）每個行事曆日期上每個工作項目的狀態，包括用來產生趨勢報表的面板位置。 如需範例報表，請參閱 累積流程圖 （CF） 範例報表。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemLink/ WorkItemLinks |
工作項目之間的連結，例如 Child、 Parent 和 Related。 只包含連結的最新修訂，沒有歷程記錄。 未包含超連結。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemRevision/ WorkItemRevisions |
所有歷史工作專案修訂，包括目前的修訂。 不包含已刪除的工作專案。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemSnapshot/ WorkItemSnapshot |
（綜合）每個行事曆日期上每個工作專案的狀態，用來支援趨勢報告。 如需範例報告，請參閱 錯誤趨勢範例報告。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItem/ WorkItems |
工作專案的目前狀態。 用來支持狀態報告。 如需範例報表，請參閱 匯總子工作專案值至父範例報表。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemTypeField/ WorkItemTypeFields |
每個工作專案類型和進程的工作項目屬性。 用來支援建置報表。 | ✔️ | ✔️ | ✔️ | ✔️ |
管線實體類型和實體集
v3.0-preview 或 v4.0-preview Analytics 版本支援下列實體類型和實體集。 如需完整的參考，請參閱 管線元資料參考 。
| EntityType/EntitySet | 描述 | v3.0-preview | v4.0-preview |
|---|---|---|---|
| 分支/ 分支 |
測試或管線中使用的分支基本資訊。 如需範例報表，請參閱 進度狀態範例報告。 | ✔️ | ✔️ |
| ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot |
（綜合）支持瞭解平行管線耗用量。 如需平行管線測試的詳細資訊，請參閱 使用Visual Studio測試工作平行執行測試。 | ✔️ | |
| 管線/ 管線 |
管線的屬性。 | ✔️ | ✔️ |
| PipelineJob/ PipelineJobs |
與 TestRun 相關聯的特定測試的個別執行結果 | ✔️ | ✔️ |
| PipelineRun/ PipelineRuns |
管線的執行資訊。 如需範例報表，請參閱 管線通過率趨勢範例報告。 | ✔️ | ✔️ |
| PipelineRunActivityResult/ PipelineRunActivityResults |
特定管線執行內所有階段、步驟、作業和工作的合併記錄。 如需範例報表，請參閱 管線工作持續時間範例報告。 | ✔️ | ✔️ |
| PipelineTask/ PipelineTasks |
管線內使用之工作的屬性。 | ✔️ | ✔️ |
| TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots |
（綜合）支援瞭解集區大小、管線作業和並行。 代理 程式集 區的歷程記錄圖表說明如何使用此實體集。 | ✔️ | |
| TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots |
（綜合） | ✔️ |
測試實體類型和實體集
v3.0-preview 或 v4.0-preview Analytics 版本支援下列實體類型和實體集。 如需完整的參考，請參閱 測試元數據參考。
EntityType/EntitySet |
描述 | v3.0-preview | v4.0-preview |
|---|---|---|---|
| TestConfiguration/ TestConfigurations |
測試計劃組態資訊。 如需設定測試的詳細資訊，請參閱 測試不同的組態 | ✔️ | ✔️ |
| TestResult/ TestResults |
與 TestRun 相關聯的特定測試的個別執行結果。 | ✔️ | ✔️ |
| TestResultsDaily/ TestResultsDaily |
TestResult 執行的每日快照集匯總，依 Test 分組（而非 TestRun）。 如需範例報表，請參閱 測試摘要趨勢範例報告。 | ✔️ | ✔️ |
| TestRun/ TestRuns |
使用匯總 TestResult 在管線下執行之測試的執行資訊。 | ✔️ | ✔️ |
| Test/ 測試 |
測試案例的屬性，例如測試名稱和測試擁有者。 如需定義測試案例的詳細資訊，請參閱 建立手動測試案例。 | ✔️ | ✔️ |
| TestPoint/ TestPoints |
測試點的執行資訊。 測試點是測試案例、測試套件、設定和測試人員的唯一組合。 如需範例報表，請參閱 進度狀態範例報告。 | ✔️ | ✔️ |
| TestPointHistorySnapshot/ TestPointHistorySnapshots |
（綜合）與 TestRun 相關聯的特定測試的個別執行結果。 如需範例報表，請參閱 手動測試執行趨勢範例報告 | ✔️ | ✔️ |
| TestSuite/ TestSuites |
測試套件資訊。 如需定義測試套件的詳細資訊，請參閱 建立測試計劃和測試套件。 | ✔️ | ✔️ |