Megosztás a következőn keresztül:


Functions – Lekérdezési nyelv a Cosmos DB-ben (az Azure-ban és a Fabricben)

A lekérdezési nyelv számos olyan rendszerfüggvényt tartalmaz, amelyek a lekérdezési nyelvbe vannak beépítve, és számos gyakori feladat kezelésére lettek kialakítva.

Functions

Íme a lekérdezési nyelv által jelenleg támogatott függvények listája:

Matematikai függvények

Description
ABS A ABS függvény kiszámítja a megadott numerikus kifejezés abszolút (pozitív) értékét.
ACOS A ACOS függvény kiszámítja a megadott numerikus érték trigonometrikus arckozinját. Az arckozin a radiánban megadott szög, amelynek koszinusza a megadott numerikus kifejezés.
ASIN A ASIN függvény kiszámítja a megadott numerikus érték trigonometrikus arczinuszát. Az arczin az a radiánban megadott szög, amelynek szinusza a megadott numerikus kifejezés.
ATAN A ATAN függvény kiszámítja a megadott numerikus érték trigonometrikus arctangensét. Az arctangent az a szög radiánban, amelynek tangense a megadott numerikus kifejezés.
ATN2 A ATN2 függvény kiszámítja a radiánban kifejezett arkusztangens y/xfő értékét.
CEILING A CEILING függvény kiszámítja a megadott numerikus kifejezésnél nagyobb vagy egyenlő legkisebb egész számot.
COS A COS függvény kiszámítja a radiánban megadott szög trigonometriai koszinuszát.
COT A COT függvény kiszámítja a megadott szög trigonometrikus kotangensét radiánokban.
DEGREES A DEGREES függvény kiszámítja a radiánban megadott szög megfelelő szögét fokban.
EXP A EXP függvény kiszámítja a megadott numerikus kifejezés exponenciális értékét.
FLOOR A FLOOR függvény a megadott numerikus kifejezésnél kisebb vagy egyenlő legnagyobb egész számot számítja ki.
INTADD A INTADD függvény két egész érték összegét adja vissza.
INTBITAND A INTBITAND függvény az egyes operandusok bitjeinek összehasonlítását adja vissza egy befogadó AND operátor használatával.
INTBITLEFTSHIFT A INTBITLEFTSHIFT függvény egy bitenkénti baleltolásos művelet eredményét adja vissza egész számértéken.
INTBITNOT A INTBITNOT függvény egy bitenkénti NOT művelet eredményét adja vissza egész számértéken.
INTBITOR A INTBITOR függvény egy bitenkénti vagy két egész számértékre vonatkozó VAGY művelet eredményét adja vissza.
INTBITRIGHTSHIFT A INTBITRIGHTSHIFT függvény egy bitenkénti jobbra váltási művelet eredményét adja vissza egész számértéken.
INTBITXOR A INTBITXOR függvény egy bitenkénti kizárólagos OR művelet eredményét adja vissza két egész számértéken.
INTDIV A INTDIV függvény az első egész szám és a másodperc osztásának eredményét adja vissza.
INTMOD A INTMOD függvény az első egész szám és a második osztás fennmaradó részét adja vissza.
INTMUL A INTMUL függvény két egész érték szorzatát adja vissza.
INTSUB A INTSUB függvény a második egész szám első értékének kivonásának eredményét adja vissza.
LOG A LOG függvény a megadott numerikus kifejezés természetes logaritmusát adja vissza.
LOG10 A LOG10 függvény a megadott numerikus kifejezés 10-es alapú logaritmusát adja vissza.
NUMBERBIN A NUMBERBIN függvény kiszámítja a bemeneti értéket a megadott méret többszörösére kerekítve.
PI A PI függvény a Pi állandó értékét adja vissza.
POWER A POWER függvény a megadott kifejezés értékét adja vissza, amely önmagában többszöröse a megadott számú alkalommal.
RADIANS A RADIANS függvény radiánban adja vissza a megfelelő szöget egy fokban megadott szöghez.
RAND A RAND függvény egy véletlenszerűen generált numerikus értéket ad vissza nulláról egyre.
ROUND A ROUND függvény egy numerikus értéket ad vissza a legközelebbi egész számra kerekítve.
SIGN A SIGN függvény a megadott numerikus kifejezés pozitív (+1), nulla (0) vagy negatív (-1) előjelét adja vissza.
SIN A SIN függvény a megadott szög trigonometriai szinuszát adja vissza radiánokban.
SQRT A SQRT függvény a megadott numerikus érték négyzetgyökét adja vissza.
SQUARE A SQUARE függvény a megadott numerikus érték négyzetét adja vissza.
TAN A TAN függvény a megadott szög trigonometriai tangensét adja vissza radiánokban.
TRUNC A TRUNC függvény a legközelebbi egész számértékhez csonkolt numerikus értéket ad vissza.

Tömb függvények

Description
ARRAY_CONCAT A ARRAY_CONCAT függvény egy tömböt ad vissza, amely két vagy több tömbérték összefűzésének eredménye.
ARRAY_CONTAINS_ALL A ARRAY_CONTAINS_ALL függvény egy logikai értéket ad vissza, amely jelzi, hogy a tömb tartalmazza-e az összes megadott értéket.
ARRAY_CONTAINS_ANY A ARRAY_CONTAINS_ANY függvény egy logikai értéket ad vissza, amely jelzi, hogy a tömb tartalmazza-e a megadott értékek bármelyikét.
ARRAY_CONTAINS A ARRAY_CONTAINS függvény egy logikai értéket ad vissza, amely jelzi, hogy a tömb tartalmazza-e a megadott értéket. Egy objektum részleges vagy teljes egyezését a függvény logikai kifejezésével ellenőrizheti.
ARRAY_LENGTH A ARRAY_LENGTH függvény a megadott tömbkifejezés elemeinek számát adja vissza.
ARRAY_SLICE A ARRAY_SLICE függvény egy tömbkifejezés egy részhalmazát adja vissza a megadott index és hossz használatával.
CHOOSE A CHOOSE függvény egy lista megadott indexében adja vissza a kifejezést, vagy a nem definiált értéket, ha az index túllépi a lista határait.
OBJECTTOARRAY A OBJECTTOARRAY függvény JSON-objektum mező-érték párjait JSON-tömbökké alakítja.
SETINTERSECT A SETINTERSECT függvény a két bemeneti tömbben található kifejezéskészletet adja vissza duplikációk nélkül.
SETUNION A SETUNION függvény olyan kifejezéskészletet ad vissza, amely két összegyűjtött halmaz összes kifejezését tartalmazza duplikációk nélkül.

Összesítő függvények

Description
AVG A AVG függvény kiszámítja a kifejezés értékeinek átlagát.
COUNT A COUNT függvény a kifejezésben szereplő értékek számát adja vissza.
MAX A MAX függvény a megadott kifejezés maximális értékét adja vissza.
MIN A MIN függvény a megadott kifejezés minimális értékét adja vissza.
SUM A SUM függvény kiszámítja a kifejezés értékeinek összegét.

Karakterlánc függvények

Description
CONCAT A CONCAT függvény egy sztringet ad vissza, amely több mező összefűzésének eredménye egy dokumentumból.
CONTAINS A CONTAINS függvény egy logikai értéket ad vissza, amely azt jelzi, hogy az első sztringkifejezés tartalmazza-e a második sztringkifejezést.
ENDSWITH A ENDSWITH függvény egy logikai értéket ad vissza, amely jelzi, hogy egy sztring a megadott utótaggal végződik-e. Az összehasonlítás igény szerint kis- és nagybetűket is tartalmazhat.
INDEX-OF A INDEX_OF függvény egy sztring első előfordulásának indexét adja vissza.
LEFT A LEFT függvény egy sztring bal oldali részét adja vissza a megadott számú karakterig.
LENGTH A LENGTH függvény a megadott sztringkifejezésben szereplő karakterek számát adja vissza.
LOWER A LOWER függvény a nagybetűs karakteradatok kisbetűssé alakítása után visszaad egy sztringkifejezést.
LTRIM A LTRIM függvény sztringkifejezést ad vissza, miután eltávolítja a kezdő szóközt vagy a megadott karaktereket.
REGEXMATCH A REGEXMATCH függvény egy logikai értéket ad vissza, amely jelzi, hogy a megadott sztring megfelel-e a megadott reguláris kifejezésnek. A reguláris kifejezések tömör és rugalmas jelölést jelentenek a szövegminták megtalálásához.
REPLACE A REPLACE függvény egy sztringet ad vissza, amely egy adott sztring összes előfordulását lecseréli.
REPLICATE A REPLICATE függvény egy adott számú alkalommal ismétlődő sztringértéket ad vissza.
REVERSE A REVERSE függvény egy sztringérték fordított sorrendjét adja vissza.
RIGHT A RIGHT függvény a sztring megfelelő részét adja vissza a megadott számú karakterig.
RTRIM A RTRIM függvény egy sztringkifejezést ad vissza, miután eltávolítja a záró szóközt vagy a megadott karaktereket.
STARTSWITH A STARTSWITH függvény egy logikai értéket ad vissza, amely jelzi, hogy az első sztringkifejezés a másodikkal kezdődik-e.
STRINGEQUALS A STRINGEQUALS függvény egy logikai értéket ad vissza, amely jelzi, hogy az első sztringkifejezés megfelel-e a másodiknak.
STRINGJOIN A STRINGJOIN függvény egy sztringet ad vissza, amely összefűzi egy adott tömb elemeit az egyes elemek között megadott elválasztó használatával.
STRINGSPLIT A STRINGSPLIT függvény a forrássztringnek a megadott elválasztóval való elválasztása során kapott részsztringekből álló tömböt ad vissza.
STRINGTOARRAY A STRINGTOARRAY függvény tömbgé konvertál egy sztringkifejezést.
STRINGTOBOOLEAN A STRINGTOBOOLEAN függvény egy sztringkifejezést logikai értékké alakít át.
SUBSTRING A SUBSTRING függvény egy sztringkifejezés egy részét adja vissza a megadott pozíciótól és a megadott hossztól kezdve, vagy a sztring végéig.
TOSTRING A TOSTRING függvény egy érték sztring-ábrázolását adja vissza.
TRIM A TRIM függvény sztringkifejezést ad vissza, miután eltávolítja a kezdő és záró szóközt vagy egyéni karaktereket.
UPPER A UPPER függvény egy sztringkifejezést ad vissza a kisbetűs adatok nagybetűssé alakítása után.

Dátum- és időfüggvények

Description
DATETIMEADD A DATETIMEADD függvény egy dátum- és idősztring-értéket ad vissza, amely egy megadott számértéknek a megadott dátum- és idősztringhez való hozzáadásának eredménye.
DATETIMEBIN A DATETIMEBIN függvény egy dátum- és idősztring-értéket ad vissza, amely a megadott dátum- és idősztring egy részének binning (vagy kerekítése) eredménye.
DATETIMEDIFF A DATETIMEDIFF függvény aláírt egész számként adja vissza a megadott dátum- és időrész különbségét két dátum- és időérték között.
DATETIMEFROMPARTS A DATETIMEFROMPARTS függvény egy dátum- és idősztring-értéket ad vissza, amely a különböző dátum- és időrészek bemeneti numerikus értékeiből épül fel.
DATETIMEPART A DATETIMEPART függvény a megadott dátum- és időrész értékét adja vissza.
DATETIMETOTICKS A DATETIMETOTICKS függvény a megadott DateTime-értéket ketyegéssé alakítja. Egyetlen pipa 100 nanoszekundumot vagy 0,00000001 másodpercet jelöl.
DATETIMETOTIMESTAMP A DATETIMETOTIMESTAMP függvény a megadott dátumot és időt numerikus időbélyeggé alakítja. Az időbélyeg egy aláírt numerikus egész szám, amely a Unix-korszak óta eltelt ezredmásodperceket méri.
GETCURRENTDATETIME A GETCURRENTDATETIME függvény iso 8601 sztringként adja vissza az aktuális UTC (koordinált egyetemes idő) dátumot és időt.
GETCURRENTDATETIMESTATIC A GETCURRENTDATETIMESTATIC függvény ugyanazt az UTC dátum- és időértéket adja vissza a lekérdezés összes eleméhez, mint egy ISO 8601 sztring. Ez a lekérdezési eredmények konzisztens időbélyegeinek esetében hasznos.
GETCURRENTTICKS A GETCURRENTTICKS függvény az aktuális UTC-időt adja vissza a 0001-01-01T00:00:00.0000000Z óta eltelt 100 nanoszekundumos intervallumok (kullancsok) számaként.
GETCURRENTTICKSSTATIC A GETCURRENTTICKSSTATIC függvény egy statikus nanoszekundumos ticks értéket ad vissza (100 nanoszekundumos intervallumok a Unix-korszak óta) az ugyanazon partícióban lévő összes elemhez.
GETCURRENTTIMESTAMP A GETCURRENTTIMESTAMP függvény a Unix-korszak óta ezredmásodpercben adja vissza az aktuális időbélyeget.
GETCURRENTTIMESTAMPSTATIC A GETCURRENTTIMESTAMPSTATIC függvény egy statikus időbélyegértéket ad vissza (ezredmásodpercet a Unix-korszak óta) ugyanazon partíció összes eleméhez.
TICKSTODATETIME A TICKSTODATETIME függvény a megadott számú osztásjelet dátum- és időértékké alakítja.
TIMESTAMPTODATETIME A TIMESTAMPTODATETIME függvény a megadott időbélyeget dátum- és időértékké alakítja.

Elem funkciói

Description
DOCUMENTID A DOCUMENTID függvény a tároló egy adott eleméhez tartozó egyedi dokumentumazonosítót adja vissza.

Teljes szöveges keresési funkciók

Description
FULLTEXTCONTAINS A FULLTEXTCONTAINS függvény egy logikai értéket ad vissza, amely jelzi, hogy a kulcsszó sztringkifejezése szerepel-e egy megadott tulajdonságútvonalban.
FULLTEXTCONTAINSALL A FULLTEXTCONTAINSALL függvény egy logikai értéket ad vissza, amely jelzi, hogy az összes megadott sztringkifejezés szerepel-e egy megadott tulajdonságútvonalban.
FULLTEXTCONTAINSANY A FULLTEXTCONTAINSANY függvény egy logikai értéket ad vissza, amely jelzi, hogy a megadott sztringkifejezések bármelyike szerepel-e egy megadott tulajdonságútvonalban.
FULLTEXTSCORE A FULLTEXTSCORE függvény egy BM25 pontszámértéket ad vissza, amely csak záradékban ORDER BY RANK használható az eredmények rendezésére a legmagasabb relevanciától a megadott kifejezések legalacsonyabb relevanciájáig.
RRF A RRF függvény egy összeolvadt pontszámot ad vissza két vagy több más függvény által biztosított pontszám kombinálásával.

Feltételes függvények

Description
IIF A IIF függvény két érték egyikét adja vissza attól függően, hogy a logikai kifejezés értéke igaz vagy hamis.

Típusellenőrzési függvények

Description
IS_ARRAY A IS_ARRAY függvény logikai értéket ad vissza, amely jelzi, hogy a megadott kifejezés típusa tömb-e.
IS_BOOL A IS_BOOL függvény logikai értéket ad vissza, amely jelzi, hogy a megadott kifejezés típusa logikai-e.
IS_DEFINED A IS_DEFINED függvény egy logikai értéket ad vissza, amely jelzi, hogy a tulajdonsághoz érték van-e rendelve.
IS_FINITE_NUMBER A IS_FINITE_NUMBER függvény egy logikai értéket ad vissza, amely azt jelzi, hogy egy szám véges szám-e (nem végtelen).
IS_INTEGER A IS_INTEGER függvény egy logikai értéket ad vissza, amely jelzi, hogy egy szám 64 bites aláírt egész szám-e. A 64 bites aláírt egész számok tartománya a -9,223,372,036,854,775,808 következő 9,223,372,036,854,775,807: . További információ: __int64.
IS_NULL A IS_NULL függvény egy logikai értéket ad vissza, amely jelzi, hogy a megadott kifejezés típusa.null
IS_NUMBER A IS_NUMBER függvény egy logikai értéket ad vissza, amely azt jelzi, hogy a megadott kifejezés típusa szám-e.
IS_OBJECT A IS_OBJECT függvény logikai értéket ad vissza, amely jelzi, hogy a megadott kifejezés típusa JSON-objektum-e.
IS_PRIMITIVE A IS_PRIMITIVE függvény logikai értéket ad vissza, amely azt jelzi, hogy a megadott kifejezés típusa primitív (sztring, logikai, numerikus vagy null).
IS_STRING A IS_STRING függvény logikai értéket ad vissza, amely jelzi, hogy a megadott kifejezés típusa sztring-e.
STRINGTONULL A STRINGTONULL függvény sztringkifejezést nullkonvertál .
STRINGTONUMBER A STRINGTONUMBER függvény számmá konvertál egy sztringkifejezést.
STRINGTOOBJECT A STRINGTOOBJECT függvény egy sztringkifejezést objektummá alakít át.

Térbeli függvények

Description
ST_AREA A ST_AREA függvény egy GeoJSON-poligon vagy multipoligon kifejezés teljes területét adja vissza.
ST_DISTANCE A ST_DISTANCE függvény két GeoJSON-pont, Sokszög, MultiPolygon vagy LineString kifejezés közötti távolságot adja vissza.
ST_INTERSECTS A ST_INTERSECTS függvény egy logikai értéket ad vissza, amely jelzi, hogy az első argumentumban megadott GeoJSON-objektum metszi-e a GeoJSON objektumot a második argumentumban.
ST_ISVALID A ST_ISVALID függvény logikai értéket ad vissza, amely azt jelzi, hogy a megadott GeoJSON-pont, Sokszög, MultiPolygon vagy LineString kifejezés érvényes-e.
ST_ISVALIDDETAILED A ST_ISVALIDDETAILED függvény logikai értéket tartalmazó JSON-értéket ad vissza, ha a megadott GeoJSON-pont, sokszög vagy LineString kifejezés érvényes, és ha érvénytelen, az ok.
ST_WITHIN A ST_WITHIN függvény egy logikai kifejezést ad vissza, amely jelzi, hogy az első argumentumban megadott GeoJSON-objektum a második argumentum GeoJSON objektumán belül van-e.
VECTORDISTANCE A VECTORDISTANCE függvény két megadott vektor hasonlósági pontszámát adja vissza.