Analiz OData meta verileri

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Analiz için varlık modeliyle ilişkili meta verileri anlamak, Analiz için Veri modelini program aracılığıyla sorgulamanın önkoşullarından biridir. OData meta verileri, istemci tüketimini etkinleştirmek için tasarlanmış varlık modelinin makine tarafından okunabilir bir açıklamasıdır.

Not

"Açık Veri Protokolü (OData), HTTP gibi çekirdek protokoller ve web için REST gibi yaygın olarak kabul edilen yöntemler üzerine oluşturulmuş bir veri erişim protokolüdür. OData hizmetlerini kullanmak için kullanılabilecek çeşitli kitaplıklar ve araçlar vardır." - OData Kuruluş Temel Rehberi.

Bu makalede şunları nasıl yapacağınızı öğreneceksiniz:

• Belirli bir projedeki meta verileri sorgulama
• Kuruluşta meta verileri sorgulama
• Bir Varlıkla ilişkili anahtarları, özellikleri ve gezinti özelliklerini tanımlama
• Analytics OData uç noktasının özelliklerini belirleme

Tüm OData öğelerinin ayrıntılı açıklamaları için bkz . OData modeli. Meta verileri sorgulama hakkında bilgi için Analiz için OData sorguları oluşturma bölümüne bakın.

Not

Analiz hizmeti, Azure DevOps Services içindeki tüm hizmetler için üretimde otomatik olarak etkinleştirilir ve desteklenir. Power BI tümleştirmesi ve Analiz hizmetinin OData akışına erişim genel olarak kullanılabilir. Analytics OData akışını kullanmanız ve geri bildirim sağlamanız teşvik edilir.

Kullanılabilir veriler sürüme bağlıdır. OData API'sinin desteklenen en son sürümü, v2.0en son önizleme sürümü ise şeklindedir v4.0-preview. Daha fazla bilgi için bkz . OData API sürümü oluşturma.

Önkoşullar

Kategori	Gereksinimler
Erişim Düzeyleri	- proje üyesi. - En az Temel erişimi.
İzinler	Varsayılan olarak, proje üyeleri Analytics'i sorgulama ve görünüm oluşturma iznine sahiptir. Hizmet ve özellik etkinleştirme ve genel veri izleme etkinlikleriyle ilgili diğer önkoşullar hakkında daha fazla bilgi için bkz. Analyticserişme izinleri ve önkoşulları.

Varlık kümeleri ve varlık türleri

Varlıklar, veri modelindeki temel kimlik türleridir. Varlık kümeleri varlık koleksiyonları olarak adlandırılır. Örneğin, Projects varlıkları içeren Project bir varlık kümesidir. Bir varlık en fazla bir varlık kümesinin üyesi olabilir.

EntitySets ve EntityTypes özellikler ve ilişkiler dahil olmak üzere Analiz modelindeki varlıkların her birini tanımlayın. Varlık türleri, bir varlığın adlandırılmış özelliklerini ve ilişkilerini tanımlar. Varlık türleri, diğer varlık türlerinden tek devralma yoluyla türetilebilir. Bir varlık türünün anahtarı, temel özelliklerinin bir alt kümesinden oluşturulur.

Aşağıdaki örnekte varlık türüyle ilişkilendirilmiş meta veriler gösterilmektedir Project .

<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>

Anahtarlar

Keys Gezinti Özelliği olarak kullanılabilecek Varlık özelliklerini tanımlayın.

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

Özellikler

Sorgu için kullanılabilen 'Varlık özellikleri' kümesi. Ek açıklamalar, belirli bir özellik hakkındaki diğer ayrıntıları temsil eder.

Analytics'in son kullanıcılara görünür olması gereken tüm özelliklerine bir DisplayNameile açıklama eklenir.

<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>

ReferenceName, belirli bir özelliğin sistem tanımlayıcısını tanımlamak için kullanılan bir diğer yaygın ek açıklamadır.

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

Gezinme özellikleri

Tek bir Varlığı sorgulamak yararlıdır. Sonunda, büyük olasılıkla başka bir Varlığın ayrıntılarını filtrelemek veya genişletmek isteyeceksiniz. Bunu yapmak için Varlık modelinin Gezinti Özelliklerini kullanmayı anlamanız gerekir.

Modelde çoktan çoğa ilişkiyi temsil eden NavigationProperty, bir koleksiyon türüne sahiptir.

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

ReferentialConstraints gezinti özelliklerini, modelde çoktan bire ilişkiyi temsil eden bir varlığın belirli bir anahtarına ilişkilendirin.

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

Kapsayıcılar (OData özellikleri)

VarlıkKümeleri

Varlıklar, veri modelindeki temel kimlik türleridir. Varlık kümeleri varlık koleksiyonları olarak adlandırılır. Örneğin, WorkItems ve WorkItemRevisions, EntitySets adı verilen EntityContainer içinde Container. Bir varlık en fazla bir varlık kümesinin üyesi olabilir. Varlık kümeleri veri modeline birincil giriş noktaları sağlar ve varlık koleksiyonunu ve ilişkili Gezinti özelliği bağlamalarını ve ek açıklamalarını temsil eder.

Aşağıdaki söz dizimi varlık kümesi veri modelini gösterir Projects . Her varlık kümesinin açıklaması için bkz . Analiz için veri modeli.

<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>

Özellikler

Özellikler, Analytics OData uç noktası tarafından anlaşılan işlev kümesini tanımlar.

<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>

Toplamalar

Toplama ek açıklamaları, Analytics OData uç noktası tarafından anlaşılan dönüştürme kümesini tanımlar.

<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>

Sonraki adımlar

Analiz için veri modeli

İlgili makaleler

• Analiz için veri modeli
• Kuruluş ve proje kapsamındaki sorgular.
• Analytics'ten edinilebilen veriler
• Analytics kullanarak iş izleme verilerini sorgulama
• Azure Boards için varlıklar ve özellikler referansı

İlgili kaynaklar

• Wiql'dan OData Pazar Yeri uzantısı
• OData Kuruluşunun Temel Eğitimi
• OData Sürüm 4.0. Bölüm 3: Ortak Şema Tanımlama Dili (Common Schema Definition Language - CSDL) Artı Errata 03, Varlık Modeli Sarıcı (Entity Model Wrapper)