Model danych dla analizy

Azure DevOps Services | Azure DevOps Server 2022 r. — Azure DevOps Server 2019 r.

Model danych analizy dla usługi Azure DevOps składa się z zestawów jednostek, których elementy członkowskie (jednostki) zawierają właściwości, które można filtrować, agregować i podsumowywać. Ponadto zawierają właściwości nawigacji , które odnoszą jednostki do siebie, zapewniając dostęp do innych właściwości do wybierania, filtrowania i grupowania.

Uwaga

Usługa Analytics jest automatycznie włączona i obsługiwana w środowisku produkcyjnym dla wszystkich Azure DevOps Services. Integracja usługi Power BI i dostęp do źródła danych OData usługi Analytics są ogólnie dostępne. Zachęcamy do korzystania z niego i przekazywania nam opinii. Dostępne dane są zależne od wersji. Najnowsza obsługiwana wersja to v2.0, a najnowsza wersja zapoznawcza to v4.0-preview. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji interfejsu API OData.

Przestrzenie nazw schematu

Model danych analizy jest oparty na dwóch przestrzeniach nazw schematu:

• Microsoft.VisualStudio.Services.Analytics.Model
• Microsoft.VisualStudio.Services.Analytics.

Zestawy jednostek i typy jednostek

Typy jednostek są nazywane typami strukturalnych z kluczem. Definiują one nazwane właściwości i relacje każdej jednostki. Klucz elementu EntityType jest tworzony z podzbioru właściwości pierwotnych, na przykład WorkItemId, PipelineId, ReleasePipelineId i innych typów jednostki.

Zestawy jednostek są nazwane kolekcjami jednostek. Na przykład WorkItems jest zestawem jednostek zawierających WorkItem jednostki. Klucz jednostki jednoznacznie identyfikuje jednostkę w zestawie jednostek. Jeśli wiele zestawów jednostek używa tego samego typu jednostki, ta sama kombinacja wartości kluczy może występować w więcej niż jednym zestawie jednostek i identyfikuje różne jednostki, jeden na zestaw jednostek, w którym pojawia się ta kombinacja klawiszy. Każda z tych jednostek ma inny identyfikator jednostki. Zestawy jednostek zapewniają punkty wejścia do modelu danych.

Zestawy jednostek są opisane w metadanych OData i różnią się w zależności od projektu. Pełną listę zestawów jednostek, typów jednostek i właściwości można eksplorować, żądając metadanych OData dla projektu. Aby dowiedzieć się, jak to zrobić, zobacz Konstruowanie zapytań OData na potrzeby analizy.

Jednostki złożone

Jednostki złożone obsługują określone scenariusze. Składają się one z prostszych jednostek, często wymagają większej ilości zasobów obliczeniowych do wygenerowania i mogą zwracać większe zestawy wyników. Aby uzyskać najlepszą wydajność i uniknąć niepotrzebnego ograniczania przepustowości, upewnij się, że wykonasz zapytanie dotyczące odpowiedniej jednostki dla danego scenariusza.

Na przykład łączy WorkItemRevisions i Dates tak, WorkItemSnapshot że każda data ma jedną poprawkę dla każdego elementu roboczego. Ta reprezentacja obsługuje zapytania OData, które koncentrują się na danych trendu dla filtrowanego zestawu elementów roboczych. Nie należy jednak używać tej jednostki złożonej do wykonywania zapytań dotyczących bieżącego stanu elementów roboczych. Zamiast tego należy użyć WorkItems zestawu jednostek, aby wygenerować bardziej szybkie zapytanie.

Podobnie niektóre jednostki mogą zawierać wszystkie wartości historyczne, a inne mogą zawierać tylko bieżące wartości. WorkItemRevisions zawiera całą historię elementów roboczych, której nie należy używać w scenariuszach, w których bieżące wartości są interesujące.

Relacje

Aby wygenerować bardziej złożone wyniki zapytań, można połączyć jednostki przy użyciu relacji. Relacje można stosować w celu rozwijania, filtrowania lub podsumowywania danych.

Niektóre właściwości nawigacji powodują powstanie pojedynczej jednostki, a inne powodują zbieranie jednostek. Na poniższym diagramie przedstawiono wybieranie jednostek i ich właściwości nawigacji. W celu zapewnienia przejrzystości niektóre złożone jednostki i relacje zostały pominięte.

Klucze relacji

Relacje między jednostkami są również reprezentowane jako klucze obce, dzięki czemu narzędzia zewnętrzne mogą łączyć jednostki. Te właściwości mają sufiks "SK" i są typami danych typu liczba całkowita lub identyfikator GUID. Właściwości daty mają odpowiednie właściwości klucza daty całkowitej o następującym formacie: RRRRMMDD.

Typy jednostek i zestawy jednostek śledzenia pracy

Następujące typy jednostek i zestawy jednostek są obsługiwane w przypadku wskazanych wersji interfejsu API. Aby uzyskać pełną dokumentację, zobacz Dokumentacja metadanych śledzenia pracy dla usługi Azure Boards Analytics.

EntityType/EntitySet	Opis	Wersja 1.0	Wersja 2.0	Wersja 3.0 (wersja zapoznawcza)	Wersja 4.0 —wersja zapoznawcza
Obszar/ Obszary	Ścieżki obszaru elementu roboczego z właściwościami grupowania i filtrowania według hierarchii obszarów.	✔️	✔️	✔️	✔️
Iteracji/ Iteracje	Ścieżki iteracji elementu roboczego z właściwościami grupowania i filtrowania według hierarchii iteracji.	✔️	✔️	✔️	✔️
Lokalizacja tablicy/ Tablicelokalizacje	Lokalizacje komórek tablicy Kanban, zidentyfikowane według kolumny tablicy, torów i podziału, obejmują historyczne ustawienia tablicy. Opis każdego pola tablicy Kanban można znaleźć w polach tablicy Przepływ pracy i Kanban.	✔️	✔️	✔️	✔️
Daty kalendarza/ Daty	Daty używane do filtrowania i grupowania innych jednostek przy użyciu relacji.	✔️	✔️	✔️	✔️
Project/ Projekty	Wszystkie projekty zdefiniowane dla organizacji (w chmurze) lub kolekcji projektów (lokalnie).	✔️	✔️	✔️	✔️
Proces/ Procesy	Informacje o liście prac używane do rozwijania lub filtrowania elementów roboczych i typów elementów roboczych. Przykład, który używa procesów do filtrowania raportu, zobacz Przykładowy raport dotyczący śledzenia wymagań.		✔️	✔️	✔️
Tag/ Tagi	Wszystkie tagi elementów roboczych dla każdego projektu. Aby zapoznać się z przykładem użycia tagów do filtrowania raportu, zobacz Przykładowy raport dotyczący postępu wydania.	✔️	✔️	✔️	✔️
Zespołu/ Teams	Wszystkie zespoły zdefiniowane dla projektu. Przykład, który używa usługi Teams do filtrowania raportu, zobacz Dodawanie fragmentatora zespołu do raportu usługi Power BI.	✔️	✔️	✔️	✔️
Użytkownika/ Użytkownicy	Informacje o użytkowniku używane do rozwijania lub filtrowania różnych właściwości elementu roboczego, na przykład Przypisane do, Utworzone przez.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Złożony) Stan każdego elementu roboczego w każdej dacie kalendarza, w tym lokalizacji tablicy Kanban, używany do generowania raportów trendów. Aby zapoznać się z przykładowym raportem, zobacz przykładowy raport diagramu przepływu skumulowanego (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Łącza między elementami roboczymi, na przykład Podrzędne, Nadrzędne i Powiązane. Zawiera tylko najnowszą wersję linków, bez historii. Hiperłącza nie są uwzględniane.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Wszystkie historyczne poprawki elementów roboczych, w tym bieżąca poprawka. Nie obejmuje usuniętych elementów roboczych.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Złożony) Stan każdego elementu roboczego w każdej dacie kalendarza używany do obsługi raportowania trendów. Przykładowy raport można znaleźć w przykładowym raporcie trendów błędów.	✔️	✔️	✔️	✔️
Workitem/ Elementy robocze	Bieżący stan elementów roboczych. Służy do obsługi raportów o stanie. Przykładowy raport można znaleźć w temacie Rollup child work item values to parent sample report (Zbiorcze wartości podrzędnych elementów roboczych w nadrzędnym przykładowym raporcie).	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Właściwości elementu roboczego dla każdego typu i procesu elementu roboczego. Służy do obsługi tworzenia raportów.	✔️	✔️	✔️	✔️

Typy jednostek potoków i zestawy jednostek

Następujące typy jednostek i zestawy jednostek są obsługiwane w wersji 3.0-preview lub 4.0-preview Analytics. Aby uzyskać pełną dokumentację, zobacz Dokumentacja metadanych potoku .

EntityType/EntitySet	Opis	Wersja 3.0 (wersja zapoznawcza)	Wersja 4.0 —wersja zapoznawcza
Oddział/ Gałęzie	Podstawowe informacje o gałęziach używanych w testach lub potokach. Aby uzyskać przykładowy raport, zobacz Przykładowy raport o stanie postępu.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Złożony) Obsługuje zrozumienie użycia potoku równoległego. Aby dowiedzieć się więcej na temat równoległych testów potoków, zobacz Uruchamianie testów równolegle przy użyciu zadania testowego programu Visual Studio.		✔️
Rurociągu/ Pipelines	Właściwości potoku.	✔️	✔️
PotokJob/ PotokiJobs	Pojedyncze wyniki wykonywania dla określonego testu skojarzonego z testemRun	✔️	✔️
PipelineRun/ PotokiRuns	Informacje o wykonywaniu potoków. Aby uzyskać przykładowy raport, zobacz Przykładowy raport trendu szybkości przekazywania potoku.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Scalony dziennik wszystkich etapów, kroków, zadań i zadań w ramach określonego wykonania potoku. Aby uzyskać przykładowy raport, zobacz Przykładowy raport czasu trwania zadania potoku.	✔️	✔️
PipelineTask/ PipelineTasks	Właściwości zadań używanych w potoku.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Złożony) Obsługuje zrozumienie rozmiaru puli, zadań potoku i współbieżności. Wykres historyczny dla pul agentów ilustruje sposób użycia tego zestawu jednostek.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Złożony)		✔️

Testowanie typów jednostek i zestawów jednostek

Następujące typy jednostek i zestawy jednostek są obsługiwane w wersji 3.0-preview lub w wersji 4.0-preview Analytics. Aby uzyskać pełną dokumentację, zobacz Dokumentacja metadanych testowania.

EntityType/EntitySet	Opis	Wersja 3.0 (wersja zapoznawcza)	Wersja 4.0-preview
Testconfiguration/ Konfiguracje testowe	Informacje o konfiguracji planu testowego. Aby uzyskać szczegółowe informacje na temat konfigurowania testów, zobacz Testowanie różnych konfiguracji	✔️	✔️
Testresult/ Testresults	Poszczególne wyniki wykonywania dla określonego testu skojarzonego z testemRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Dzienna agregacja migawek wykonań TestResult pogrupowana według wartości Test (a nie TestRun). Aby uzyskać przykładowy raport, zobacz Przykładowy raport trendu podsumowania testów.	✔️	✔️
Testrun/ TestRuns	Informacje o wykonywaniu testów uruchamianych w ramach potoku z agregowanym elementem TestResult.	✔️	✔️
Test/ Testy	Właściwości przypadku testowego, takie jak nazwa testu i właściciel testu. Aby uzyskać szczegółowe informacje na temat definiowania przypadków testowych, zobacz Tworzenie ręcznych przypadków testowych.	✔️	✔️
Testpoint/ Punkty testowe	Informacje o wykonywaniu punktów testowych. Punkt testu to unikatowa kombinacja przypadku testowego, zestawu testów, konfiguracji i testera. Aby uzyskać przykładowy raport, zobacz Przykładowy raport o stanie postępu.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Złożony) Poszczególne wyniki wykonywania dla określonego testu skojarzonego z testemRun. Aby uzyskać przykładowy raport, zobacz Przykładowy raport trendu wykonywania testów ręcznych	✔️	✔️
TestSuite/ TestSuites	Informacje o zestawach testów. Aby uzyskać szczegółowe informacje na temat definiowania zestawów testów, zobacz Tworzenie planów testów i zestawów testów.	✔️	✔️

Pokrewne artykuły:

• Wytyczne dotyczące zapytań usługi OData Analytics
• Analiza WIT
• Agregowanie danych
• Eksplorowanie metadanych OData analizy
• Śledzenie pracy, przetwarzanie i limity projektu
• Projekt zestawu danych widoków analiz