Desteklenen OData işlevleri ve yan tümceleri

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Bu makale, Analytics'in çeşitli OData işlevlerini nasıl desteklediğini kapsar. Desteklenmeyen işlevler de listelenir. OData (Açık Veri Protokolü), REST API'leri oluşturmaya ve kullanmaya yönelik en iyi yöntemleri tanımlayan ISO/IEC onaylı, OASIS standardıdır. Daha fazla bilgi edinmek için OData belgelerine bakın.

Not

Analiz hizmeti tüm Azure DevOps Services için otomatik olarak etkinleştirilir ve üretimde desteklenir. Power BI tümleştirmesi ve Analiz Hizmeti'nin OData akışına erişim genel olarak kullanılabilir. Bunu kullanmanızı ve bize geri bildirim göndermenizi öneririz. Kullanılabilir veriler sürüme bağlıdır. Desteklenen en son sürüm, v2.0en son önizleme sürümü ise sürümüdür v4.0-preview. Daha fazla bilgi için bkz. OData API sürümü oluşturma.

Desteklenen yan tümceler

• $apply
• $compute
• $count
• $expand
• $filter
• $orderby
• $select
• $skip
• $top

Sorguda birden çok yan tümce kullanıldığında, bunlar yukarıda belirtilen sırayla uygulanır. Sorgu dizesindeki yan tümcelerin sırası yoksayılır. Örneğin, aşağıdaki sorguda iş öğeleri önce gruplandırılır ve toplanır. Ardından gruplar filtrelenir. Bundan sonra, filtrelenen gruplar sıralanır. Son olarak, ilk beş kayıt döndürülür. Sorgu, en az 100 kez kullanılan ilk beş iş öğesi türünü döndürür.

WorkItems?$filter=Count ge 100&$apply=groupby((WorkItemType), aggregate($count as Count))&$orderby=Count&top=5

Toplama uzantıları desteği

Bunların art arda uygulandığını ifade etmek için eğik çizgilerle ayrılmış bir dizi küme dönüştürmesi alır. Her dönüşümün sonucu, bir sonraki dönüştürmenin girişidir. Örneğin, aşağıdaki sorguda iş öğeleri filtrelenir ve ardından iş öğesi türüne ve durumuna göre gruplandırılır. Ardından, gruplar yeniden filtrelenir ve gruplandırılır.

Not

OData toplama uzantıları nispeten yenidir ve bazı istemci araçları tarafından henüz tam olarak desteklenmemektedir.

Workitems?$apply=filter(State ne 'Closed')/groupby((WorkItemType, State), aggregate($count as Count))/filter(Count gt 100)/groupby((State),aggregate(Count with max as MaxCount))  

Aşağıdaki dönüştürmeler desteklenir:

Dönüşüm	Notlar
aggregate	Aşağıdaki yöntemlerden birini kullanarak toplamaya $countizin verir: , averagemax, , min,sum
compute	Hesaplanan özelliklerin eklenmesine izin verir
expand	Belirtilen özelliklere göre genişletmeye izin verir
filter	Giriş kümesini filtrelemeye izin verir. Ile aynı ifadeleri destekler $filter
groupby	Özelliklere göre gruplandırma sağlar

Daha fazla bilgi için bkz. İş izleme verilerini toplama.

Desteklenen işlevler

Kurallı işlev	Açıklama
cast	Belirtilen türe yapılan geçerli örneğin ifadesini döndürür.
contains	İkinci parametre dizesi değeri ilk parametre dizesi değerinin bir alt dizesiyse true döndürür, aksi takdirde false döndürür.
endswith	İlk parametre dizesi değeri ikinci parametre dizesi değeriyle biterse true döndürür, aksi takdirde false döndürür.
startswith	İlk parametre dizesi değeri ikinci parametre dizesi değeriyle başlarsa true döndürür, aksi takdirde false döndürür.
length	Parametre değerindeki karakter sayısını döndürür.
indexof	İlk parametre değerinde ikinci parametre değerinin ilk oluşumunun sıfır tabanlı karakter konumunu veya ilk parametre değerinde ikinci parametre değeri oluşmazsa -1 değerini döndürür.
substring	N. karakterden başlayıp son karakterde (burada N ikinci parametre tamsayı değeridir) bitirerek ilk parametre dizesi değerinin alt dizesini döndürür.
tolower	Tüm büyük harfler küçük harfe dönüştürülmüş giriş parametresi dize değerini döndürür.
toupper	Tüm küçük harfler büyük harfe dönüştürülmüş giriş parametresi dize değerini döndürür.
trim	Tüm baştaki ve sondaki boşluk karakterleriyle giriş parametresi dize değerini döndürür.
year	Date veya DateTimeOffset parametre değerinin year bileşenini döndürür.
month	Date veya DateTimeOffset parametre değerinin ay bileşenini döndürür.
day	Date veya DateTimeOffset parametre değerinin gün bileşenini döndürür.
date	DateTimeOffset parametre değerinin tarih bölümünü döndürür.
time	DateTimeOffset parametre değerinin saat bölümünü döndürür.
totaloffsetminutes	DateTimeOffset parametre değerinin saat dilimi uzaklığı bölümündeki imzalı dakika sayısını döndürür.
now	Saat içindeki geçerli noktayı (saat dilimine sahip tarih ve saat) DateTimeOffset değeri olarak döndürür.
maxdatetime	DateTimeOffset değeri olarak en son olası zaman noktasını döndürür.
mindatetime	Bir DateTimeOffset değeri olarak zaman içinde mümkün olan en erken noktayı döndürür.

OData işlevleri bir $filter yan tümcede kullanılır, ancak sql deyiminde kullanıldıkları şekilde yan $select tümcede kullanılmaz.

Örneğin şunları belirtebilirsiniz:

/WorkItems?$filter=toupper(Title) eq 'HELP' 

Ancak, aşağıdaki dizeyi giremezsiniz:

/WorkItems?$select=WorkItemId,State,toupper(Title)

Desteklenmeyen özellikler

• bottomcount
• bottomsum
• bottompercent
• $crossjoin
• concat
• countdistinct
• from
• isdefined
• $rollup
• $search
• topcount
• topsum
• toppercent

İlgili makaleler:

• İş izleme verilerinizi sorgulama
• Verileri toplama
• OData v4.0 belirtimi
• OData v4.0 Bölüm 2: URL Kuralları Artı Errata 02
• OData v4.0 Toplama Uzantısı