分析的資料模型
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 版本設定。
注意
分析服務目前為 2019 Azure DevOps Server預覽版。 您可以為專案集合 啟用或安裝它 。 Power BI 整合 並存取 Analytics Service 的 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 |
Kanban 面板資料格位置，由面板資料行、泳道和分割所識別，包括歷史面板設定。 如需每個工作流程看板面板欄位的描述，請參閱 工作流程和工作流程看板面板欄位。 | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate/ 日期 |
用來使用關聯性篩選和分組其他實體的日期。 | ✔️ | ✔️ | ✔️ | ✔️ |
| Project/ 專案 |
針對組織定義的所有專案， (雲端) 或專案集合 (內部部署) 。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 過程/ 程序 |
用來展開或篩選工作專案和工作專案類型的待辦專案資訊。 如需使用 進程 篩選報表的範例，請參閱 需求追蹤範例報告。 | ✔️ | ✔️ | ✔️ | |
| 標記/ Tags (標籤) |
每個專案的所有工作專案標記。 如需使用 標籤 篩選報表的範例，請參閱 發行待用範例報表。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 團隊/ Teams |
為專案定義的所有小組。 如需使用 Teams 篩選報表的範例，請參閱 將小組交叉分析篩選器新增至 Power BI 報表。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 使用者/ 使用者 |
用來展開或篩選各種工作專案屬性的使用者資訊，例如 [指派給]、[ 建立者]。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemBoardSnapshot/ WorkItemBoardSnapshot |
(複合) 用來產生趨勢報表的每個行事曆日期上每個工作專案的狀態，包括工作流程看板位置。 如需範例報表，請參閱 () 範例報表的累積流程圖。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemLink/ WorkItemLinks |
工作專案之間的連結，例如 Child、 Parent和 Related。 僅包含連結的最新修訂，不包含任何歷程記錄。 不包含超連結。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemRevision/ WorkItemRevisions |
所有歷史工作專案修訂，包括目前的修訂。 不包含已刪除的工作專案。 | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemSnapshot/ WorkItemSnapshot |
(複合) 每個行事曆日期上每個工作專案的狀態，用來支援趨勢報告。 如需範例報告，請參閱 Bug 趨勢範例報告。 | ✔️ | ✔️ | ✔️ | ✔️ |
| 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 在管線下執行測試的執行資訊。 | ✔️ | ✔️ |
| 測試/ 測試 |
測試案例的屬性，例如測試名稱和測試擁有者。 如需定義測試案例的詳細資訊，請參閱 建立手動測試案例。 | ✔️ | ✔️ |
| TestPoint/ TestPoints |
測試點的執行資訊。 測試點是測試案例、測試套件、設定和測試人員的唯一組合。 如需範例報表，請參閱 進度狀態範例報表。 | ✔️ | ✔️ |
| TestPointHistorySnapshot/ TestPointHistorySnapshots |
(複合) 與TestRun相關聯的特定測試個別執行結果。 如需範例報表，請參閱 手動測試執行趨勢範例報表 | ✔️ | ✔️ |
| TestSuite/ TestSuites |
測試套件資訊。 如需定義測試套件的詳細資訊，請參閱 建立測試計劃和測試套件。 | ✔️ | ✔️ |
相關文章
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應