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.0
en 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.
Not
Analytics hizmeti, Azure DevOps Server 2020 ve sonraki sürümleri için tüm yeni proje koleksiyonları için otomatik olarak yüklenir 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. Azure DevOps Server 2019'dan yükselttiyseniz yükseltme sırasında Analytics hizmetini yükleyebilirsiniz.
Kullanılabilir veriler sürüme bağlıdır. Desteklenen en son sürüm, v2.0
en 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.
Not
Analiz hizmeti, Azure DevOps Server 2019 için önizleme aşamasındadır. Bir proje koleksiyonu için etkinleştirebilir veya yükleyebilirsiniz . Power BI tümleştirmesi ve Analiz Hizmeti'nin OData akışına erişim Önizleme aşamasındadır. 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.0
en 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 $count birini kullanarak toplamaya izin verir, , average max , 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