Támogatott OData-függvények és záradékok

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

Ez a cikk bemutatja, hogyan támogatja az Analytics számos OData-függvényt. A nem támogatott függvények is szerepelnek a listában. Az OData (Open Data Protocol) egy ISO/IEC által jóváhagyott, OASIS szabvány, amely a REST API-k létrehozásának és felhasználásának ajánlott eljárásait határozza meg. További információt az OData dokumentációjában talál.

Feljegyzés

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

Támogatott záradékok

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

Ha egy lekérdezés több záradékot is használ, a rendszer a fent megadott sorrendben alkalmazza őket. A lekérdezési sztring záradékainak sorrendje figyelmen kívül lesz hagyva. Az alábbi lekérdezésben például a munkaelemek először csoportosítva és összesítve jelennek meg. Ezután a csoportok szűrve lesznek. Ezután a szűrt csoportok rendezve lesznek. Végül az első öt rekord lesz visszaadva. A lekérdezés a legalább 100 alkalommal használt öt munkaelemtípust adja vissza.

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

Az aggregációs bővítmények támogatása

A halmaz-átalakítások sorozata, a perjelekkel elválasztva kifejezi, hogy egymást követő alkalmazásuk van. Az egyes átalakítások eredménye a következő átalakítás bemenete. A következő lekérdezésben például a munkaelemek szűrve lesznek, majd munkaelem típusa és állapota szerint vannak csoportosítva. Ezután a rendszer szűri és csoportosítja a csoportokat.

Feljegyzés

Az OData aggregációs bővítmények viszonylag újak, és egyes ügyféleszközök még nem támogatják teljes mértékben.

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 következő átalakítások támogatottak:

Átalakítás	Jegyzetek
aggregate	Lehetővé teszi az összesítést az alábbi módszerek $countegyikével: , average, max, minsum
compute	Számított tulajdonságok hozzáadásának engedélyezése
expand	A megadott tulajdonságok szerinti bővítés engedélyezése
filter	Lehetővé teszi a bemeneti adatkészlet szűrését. Ugyanazokat a kifejezéseket támogatja, mint $filter
groupby	Csoportosítás engedélyezése tulajdonságok szerint

További információ: A munkakövetési adatok összesítése.

Támogatott függvények

Canonical függvény	Leírás
cast	A megadott típusra leadott aktuális példány kifejezését adja vissza.
contains	Igaz értéket ad vissza, ha a második paraméter sztringértéke az első paraméter sztringértékének részsztringje, ellenkező esetben hamis értéket ad vissza.
endswith	Igaz értéket ad vissza, ha az első paraméter sztringértéke a második paraméter sztringértékével végződik, ellenkező esetben hamis értéket ad vissza.
startswith	Igaz értéket ad vissza, ha az első paraméter sztringértéke a második paraméter sztringértékével kezdődik, ellenkező esetben hamis értéket ad vissza.
length	A paraméterértékben szereplő karakterek számát adja vissza.
indexof	A második paraméterérték első előfordulásának nulla alapú karakterpozícióját adja vissza az első paraméterértékben, vagy -1 értéket, ha a második paraméter értéke nem az első paraméterértékben fordul elő.
substring	Az első paraméter sztringértékének egy részsztringét adja vissza, az Nth karaktertől kezdve az utolsó karakterig (ahol az N a második paraméter egész számértéke).
tolower	A bemeneti paraméter sztringértékét adja vissza, amelyben az összes nagybetű kisbetűssé alakul.
toupper	A bemeneti paraméter sztringértékét adja vissza, és az összes kisbetűt nagybetűssé konvertálja.
trim	A bemeneti paraméter sztringértékét adja vissza az összes kezdő és záró szóköz karakterrel.
year	A Date vagy DateTimeOffset paraméterérték év összetevőjét adja vissza.
month	A Date vagy DateTimeOffset paraméterérték hónap összetevőjét adja vissza.
day	A Date vagy DateTimeOffset paraméterérték nap összetevőjét adja vissza.
date	A DateTimeOffset paraméter értékének dátumrészét adja vissza.
time	A DateTimeOffset paraméterérték időrészét adja vissza.
totaloffsetminutes	A DateTimeOffset paraméterérték időzóna-eltolás részének aláírt percszámát adja vissza.
now	Az aktuális időpontot (dátum és idő időzóna) adja vissza DateTimeOffset értékként.
maxdatetime	A lehető legfrissebb időpontot adja vissza DateTimeOffset értékként.
mindatetime	A lehető legkorábbi időpontot adja vissza DateTimeOffset értékként.

Az OData-függvények egy $filter záradékban vannak használva, de egy $select záradékban nem úgy, ahogyan az SQL-utasításban használnák őket.

Megadhatja például a következőket:

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

A következő sztring azonban nem írható be:

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

Nem támogatott szolgáltatások

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

Kapcsolódó cikkek

• A munkakövetési adatok lekérdezése
• Adatok összesítése
• OData v4.0 specifikáció
• OData v4.0 2. rész: URL-konvenciók plusz Errata 02
• OData v4.0 összesítési bővítmény