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ı bir OASIS standardıdır. Daha fazla bilgi için OData belgelerine bakın.

Not

Analiz hizmeti, tüm Azure DevOps Services için üretimde otomatik olarak etkinleştirilir ve 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ürmeye giriştir. Örneğin, aşağıdaki sorguda iş öğeleri filtrelenir ve 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 $countbirini kullanarak toplamaya izin verir, , averagemax, min,sum
compute	Hesaplanmış ö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 izni verir

Daha fazla bilgi için bkz . Çalışma 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 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şlıyorsa 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 bitirerek (burada N, ikinci parametre tamsayı değeridir) ilk parametre dizesi değerinin alt dizesini döndürür.
tolower	Tüm büyük harf karakterlerinin küçük harfe dönüştürüldüğü 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 month bileşenini döndürür.
day	Date veya DateTimeOffset parametre değerinin day 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 olası en son noktayı 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 $select deyiminde kullanıldıkları şekilde yan 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ı