Analytics OData-metaadatok

Azure DevOps Services | 2022. Azure DevOps Server – 2019. Azure DevOps Server

Az elemzési entitásmodellhez társított metaadatok megismerése előfeltétele az adatmodell programozott lekérdezésének az Elemzéshez. Az OData-metaadatok az ügyfélhasználat engedélyezésére tervezett entitásmodell géppel olvasható leírása.

Megjegyzés

"Az Open Data Protocol (OData) egy olyan adatelérési protokoll, amely olyan alapvető protokollokra épül, mint a HTTP, és általánosan elfogadott módszerek, például a REST a weben. Az OData-szolgáltatások használatához különböző kódtárak és eszközök használhatók." - Az OData szervezet alapszintű oktatóanyaga.

Ebből a cikkből megtudhatja, hogyan:

• Adott projekt metaadatainak lekérdezése
• Egy szervezet metaadatainak lekérdezése
• Az entitáshoz társított kulcsok, tulajdonságok és navigációs tulajdonságok azonosítása
• Az Analytics OData-végpont képességeinek azonosítása

Az összes OData-elem részletes leírását lásd: OData-modell. A metaadatok lekérdezésével kapcsolatos információkért lásd: OData-lekérdezések létrehozása az Elemzéshez.

Megjegyzés

Az Elemzési szolgáltatás éles környezetben automatikusan engedélyezve és támogatva van az összes Azure DevOps Services esetében. Általánosan elérhető a Power BI integrációja és az Elemzési szolgáltatás OData-hírcsatornájának elérése. Javasoljuk, hogy használja, és küldjön nekünk visszajelzést. Az elérhető adatok verziófüggőek. A legújabb támogatott verzió a v2.0, a legújabb előzetes verzió pedig .v4.0-preview További információ: OData API-verziószámozás.

Entitáskészletek és entitástípusok

Az entitások az adatmodellek alapvető identitástípusai. Az entitáskészletek entitások nevesített gyűjteményei. Például Projects egy entitáskészlet, amely Project entitásokat tartalmaz. Egy entitás legfeljebb egy entitáskészlet tagja lehet.

EntitySets és EntityTypes határozza meg az Elemzési modellben szereplő entitásokat, beleértve a tulajdonságokat és a kapcsolatokat. Az entitástípusok határozzák meg az entitások elnevezett tulajdonságait és kapcsolatait. Az entitástípusok más entitástípusokból származó egyetlen örökléssel származhatnak. Az entitástípusok kulcsa a primitív tulajdonságok egy részhalmazából jön létre.

Az alábbi példa az entitástípushoz Project társított metaadatokat mutatja be.

<EntityType Name="Project">
  <Key>
    <PropertyRef Name="ProjectSK"/>
  </Key>
  <Property Name="ProjectSK" Type="Edm.Guid" Nullable="false"/>
  <Property Name="ProjectId" Type="Edm.Guid" Nullable="false">
    <Annotation Term="Display.DisplayName" String="Project Id"/>
  </Property>
  <Property Name="ProjectName" Type="Edm.String" Nullable="false">
    <Annotation Term="Display.DisplayName" String="Project Name"/>
  </Property>
  <Property Name="AnalyticsUpdatedDate" Type="Edm.DateTimeOffset"/>
  <Property Name="ProjectVisibility" Type="Microsoft.VisualStudio.Services.Analytics.Model.ProjectVisibility">
    <Annotation Term="Display.DisplayName" String="Project Visibility"/>
  </Property>
  <NavigationProperty Name="Areas" Type="Collection(Microsoft.VisualStudio.Services.Analytics.Model.Area)"/>
  <NavigationProperty Name="Iterations" Type="Collection(Microsoft.VisualStudio.Services.Analytics.Model.Iteration)"/>
  <NavigationProperty Name="Teams" Type="Collection(Microsoft.VisualStudio.Services.Analytics.Model.Team)"/>
</EntityType>

Kulcsok

Keys határozza meg a navigációs tulajdonságként használható entitástulajdonságokat.

<Key>
   <PropertyRef Name="ProjectSK"/>
</Key>

Tulajdonságok

A lekérdezéshez elérhető entitástulajdonságok halmaza. A széljegyzetek egy adott tulajdonság egyéb részleteit jelölik.

Az Analytics bármely olyan tulajdonsága, amelynek láthatónak kell lennie a végfelhasználók számára, egy jegyzettel DisplayNamevan el eltitkosítva.

<Property Name="ProjectSK" Nullable="false" Type="Edm.Guid"/>
<Property Name="ProjectId" Nullable="false" Type="Edm.Guid">
   <Annotation String="Project Id" Term="Display.DisplayName"/>
</Property>
<Property Name="ProjectName" Nullable="false" Type="Edm.String">
   <Annotation String="Project Name" Term="Display.DisplayName"/>
</Property>

A ReferenceName egy másik gyakori széljegyzet, amellyel egy adott tulajdonság rendszerazonosítóját definiálhatja.

<Property Name="State" Type="Edm.String">
   <Annotation String="State" Term="Display.DisplayName"/>
   <Annotation String="System.State" Term="Ref.ReferenceName"/>
</Property>

Navigációs tulajdonságok

Az egyes entitások lekérdezése hasznos. Végül valószínűleg egy másik entitás adatait szeretné szűrni vagy kibontani. Ehhez ismernie kell az entitásmodell navigációs tulajdonságainak használatát.

A NavigationaProperty gyűjteménytípus egy több-a-többhöz kapcsolatot jelöl a modellben.

<NavigationProperty Name="Teams" Type="Collection(Microsoft.VisualStudio.Services.Analytics.Model.Team)"/>

ReferentialConstraints összekapcsolhatja a navigációs tulajdonságokat egy entitás egy adott kulcsával, amely egy több-az-egyhez kapcsolatot jelöl a modellben.

<NavigationProperty Name="Project" Type="Microsoft.VisualStudio.Services.Analytics.Model.Project">
   <ReferentialConstraint ReferencedProperty="ProjectSK" Property="ProjectSK"/>
</NavigationProperty>

Tárolók (OData-képességek)

EntitySets

Az entitások az adatmodellek alapvető identitástípusai. Az entitáskészletek entitások nevesített gyűjteményei. Például a WorkItems és WorkItemRevisions a névvel ellátott Containerfájlban EntityContainer találhatókEntitySets. Egy entitás legfeljebb egy entitáskészlet tagja lehet. Az entitáskészletek biztosítják az adatmodell elsődleges belépési pontjait, és entitások és kapcsolódó navigációs tulajdonságkötések és széljegyzetek gyűjteményét képviselik.

Az alábbi szintaxis az entitáskészlet adatmodellét Projects jelzi. Az egyes entitáskészletek leírását lásd: Adatmodell az Elemzéshez.

<EntitySet Name="Projects" EntityType="Microsoft.VisualStudio.Services.Analytics.Model.Project">
  <NavigationPropertyBinding Path="Areas" Target="Areas"/>
  <NavigationPropertyBinding Path="Iterations" Target="Iterations"/>
  <NavigationPropertyBinding Path="Teams" Target="Teams"/>
  <Annotation Term="Org.OData.Display.V1.DisplayName" String="Projects"/>
</EntitySet>

Képességek

A képességek határozzák meg az Analytics OData-végpont által értelmezett függvénykészletet .

<Annotation Term="Org.OData.Capabilities.V1.FilterFunctions">
   <Collection>
      <String>contains</String>
      <String>endswith</String>
      <String>startswith</String>
      <String>length</String>
      <String>indexof</String>
      <String>substring</String>
      <String>tolower</String>
      <String>toupper</String>
      <String>trim</String>
      <String>concat</String>
      <String>year</String>
      <String>month</String>
      <String>day</String>
      <String>hour</String>
      <String>minute</String>
      <String>second</String>
      <String>fractionalseconds</String>
      <String>round</String>
      <String>floor</String>
      <String>ceiling</String>
      <String>date</String>
      <String>time</String>
      <String>isof</String>
      <String>cast</String>
   </Collection>
</Annotation>

Összesítések

Az összesítési széljegyzetek határozzák meg az Analytics OData-végpont által értelmezett átalakítások halmazát.

<Annotation Term="Org.OData.Aggregation.V1.ApplySupported">
   <Record>
      <PropertyValue Property="Transformations">
         <Collection>
            <String>aggregate</String>
            <String>filter</String>
            <String>groupby</String>
            <String>compute</String>
            <String>expand</String>
         </Collection>
      </PropertyValue>
      <PropertyValue Property="CustomAggregationMethods ">
         <Collection>
           <String>ax.ApproxCountDistinct</String>
           <String>ax.StandardDeviation</String>
           <String>ax.StandardDeviationP</String>
           <String>ax.Variance</String>
           <String>ax.VarianceP</String>
         </Collection>
      </PropertyValue>
   </Record>
</Annotation>

<Annotation Term="Org.OData.Capabilities.V1.BatchSupportType" Bool="true"/>
<Annotation Term="Org.OData.Capabilities.V1.BatchSupportType">
   <Record>
      <PropertyValue Property="Supported" Bool="true"/>
      <PropertyValue Property="ContinueOnErrorSupported" Bool="false"/>
      <PropertyValue Property="ReferencesInRequestBodiesSupported" Bool="false"/>
      <PropertyValue Property="ReferencesAcrossChangeSetsSupported" Bool="false"/>
      <PropertyValue Property="EtagReferencesSupported" Bool="false"/>
   </Record>
</Annotation>

Következő lépések

Adatmodell elemzéshez

Kapcsolódó cikkek

• Adatmodell elemzéshez
• Szervezeti és projekthatókörű lekérdezések.
• Az Elemzésből elérhető adatok
• Munkakövetési adatok lekérdezése az Analytics használatával
• Entitások és tulajdonságok referenciája az Azure Boardshoz

Kapcsolódó források (lehet, hogy a cikkek angol nyelvűek)

• Wiql–OData Marketplace-bővítmény
• Az OData szervezet alapszintű oktatóanyaga
• OData 4.0-s verzió. 3. rész: Common Schema Definition Language (CSDL) Plus Errata 03, Entity Model Wrapper