Functies - Querytaal in Cosmos DB (in Azure en Fabric)

De querytaal bevat een reeks systeemfuncties die zijn ingebouwd in de querytaal en die zijn ontworpen voor het afhandelen van een grote verscheidenheid aan algemene taken.

Functions

Hier volgt een lijst met functies die momenteel door de querytaal worden ondersteund:

Wiskundige functies

	Description
ABS	De ABS functie berekent de absolute (positieve) waarde van de opgegeven numerieke expressie.
ACOS	De ACOS functie berekent de trigonometrische arccosinus van de opgegeven numerieke waarde. De boogcosinus is de hoek, in radialen, waarvan de cosinus de opgegeven numerieke expressie is.
ASIN	De ASIN functie berekent de trigonometrische arcsinus van de opgegeven numerieke waarde. De boogsinus is de hoek, in radialen, waarvan de sinus de opgegeven numerieke expressie is.
ATAN	De ATAN functie berekent de trigonometrische boogtangens van de opgegeven numerieke waarde. De boogtangens is de hoek, in radialen, waarvan de tangens de opgegeven numerieke expressie is.
ATN2	De ATN2 functie berekent de hoofdwaarde van de boogtangens van y/x, uitgedrukt in radialen.
CEILING	De CEILING functie berekent de kleinste gehele waarde die groter is dan of gelijk is aan de opgegeven numerieke expressie.
COS	De COS functie berekent de trigonometrische cosinus van de opgegeven hoek in radialen.
COT	De COT functie berekent de trigonometrische cotangens van de opgegeven hoek in radialen.
DEGREES	De DEGREES functie berekent de corresponderende hoek in graden voor een hoek die is opgegeven in radialen.
EXP	De EXP functie berekent de exponentiële waarde van de opgegeven numerieke expressie.
FLOOR	De FLOOR functie berekent het grootste gehele getal dat kleiner is dan of gelijk is aan de opgegeven numerieke expressie.
INTADD	De INTADD functie retourneert de som van twee gehele getallen.
INTBITAND	De INTBITAND functie retourneert een vergelijking van de bits van elke operand met behulp van een inclusieve AND-operator.
INTBITLEFTSHIFT	De INTBITLEFTSHIFT functie retourneert het resultaat van een bitwise shift-bewerking op een geheel getal.
INTBITNOT	De INTBITNOT functie retourneert het resultaat van een bitwise NOT-bewerking op een geheel getal.
INTBITOR	De INTBITOR functie retourneert het resultaat van een bitwise inclusieve OR-bewerking op twee gehele getallen.
INTBITRIGHTSHIFT	De INTBITRIGHTSHIFT functie retourneert het resultaat van een bitwise shift-bewerking op een geheel getal.
INTBITXOR	De INTBITXOR functie retourneert het resultaat van een bitwise exclusieve OR-bewerking op twee gehele getallen.
INTDIV	De INTDIV functie retourneert het resultaat van het delen van de eerste gehele waarde door de tweede.
INTMOD	De INTMOD functie retourneert de rest van het delen van de eerste gehele waarde door de tweede.
INTMUL	De INTMUL functie retourneert het product van twee gehele getallen.
INTSUB	De INTSUB functie retourneert het resultaat van het aftrekken van de tweede gehele waarde van de eerste.
LOG	De LOG functie retourneert de natuurlijke logaritme van de opgegeven numerieke expressie.
LOG10	De LOG10 functie retourneert de logaritme met grondtal 10 van de opgegeven numerieke expressie.
NUMBERBIN	De NUMBERBIN functie berekent de invoerwaarde die is afgerond op een veelvoud van de opgegeven grootte.
PI	De PI functie retourneert de constante waarde van Pi.
POWER	De POWER functie retourneert de waarde van de opgegeven expressie die het opgegeven aantal keren is vermenigvuldigd.
RADIANS	De RADIANS functie retourneert de corresponderende hoek in radialen voor een hoek die is opgegeven in graden.
RAND	De RAND functie retourneert een willekeurig gegenereerde numerieke waarde van nul naar één.
ROUND	De ROUND functie retourneert een numerieke waarde die is afgerond op de dichtstbijzijnde gehele waarde.
SIGN	De SIGN functie retourneert het positieve teken (+1), nul (0) of negatief (-1) van de opgegeven numerieke expressie.
SIN	De SIN functie retourneert de trigonometrische sinus van de opgegeven hoek in radialen.
SQRT	De SQRT functie retourneert de vierkantswortel van de opgegeven numerieke waarde.
SQUARE	De SQUARE functie retourneert het kwadraat van de opgegeven numerieke waarde.
TAN	De TAN functie retourneert de trigonometrische tangens van de opgegeven hoek in radialen.
TRUNC	De TRUNC functie retourneert een numerieke waarde die is afgekapt tot de dichtstbijzijnde gehele waarde.

Matrixfuncties

	Description
ARRAY_CONCAT	De ARRAY_CONCAT functie retourneert een matrix die het resultaat is van het samenvoegen van twee of meer matrixwaarden.
ARRAY_CONTAINS_ALL	De ARRAY_CONTAINS_ALL functie retourneert een Booleaanse waarde die aangeeft of de matrix alle opgegeven waarden bevat.
ARRAY_CONTAINS_ANY	De ARRAY_CONTAINS_ANY functie retourneert een Booleaanse waarde die aangeeft of de matrix een van de opgegeven waarden bevat.
ARRAY_CONTAINS	De ARRAY_CONTAINS functie retourneert een Booleaanse waarde die aangeeft of de matrix de opgegeven waarde bevat. U kunt controleren op een gedeeltelijke of volledige overeenkomst van een object met behulp van een Booleaanse expressie binnen de functie.
ARRAY_LENGTH	De ARRAY_LENGTH functie retourneert het aantal elementen in de opgegeven matrixexpressie.
ARRAY_SLICE	De ARRAY_SLICE functie retourneert een subset van een matrixexpressie met behulp van de opgegeven index en lengte.
CHOOSE	De CHOOSE functie retourneert de expressie in de opgegeven index van een lijst of Niet gedefinieerd als de index de grenzen van de lijst overschrijdt.
OBJECTTOARRAY	Met de OBJECTTOARRAY functie worden veld-/waardeparen in een JSON-object geconverteerd naar een JSON-matrix.
SETINTERSECT	De SETINTERSECT functie retourneert de set expressies die is opgenomen in beide invoermatrices zonder duplicaten.
SETUNION	De SETUNION functie retourneert een set expressies met alle expressies uit twee verzamelde sets zonder duplicaten.

Aggregatiefuncties

	Description
AVG	De AVG functie berekent het gemiddelde van de waarden in de expressie.
COUNT	De COUNT functie retourneert het aantal waarden in de expressie.
MAX	De MAX functie retourneert de maximumwaarde van de opgegeven expressie.
MIN	De MIN functie retourneert de minimumwaarde van de opgegeven expressie.
SUM	De SUM functie berekent de som van de waarden in de expressie.

Stringfuncties

	Description
CONCAT	De CONCAT functie retourneert een tekenreeks die het resultaat is van het samenvoegen van meerdere velden uit een document.
CONTAINS	De CONTAINS functie retourneert een Booleaanse waarde die aangeeft of de eerste tekenreeksexpressie de tweede tekenreeksexpressie bevat.
ENDSWITH	De ENDSWITH functie retourneert een Booleaanse waarde die aangeeft of een tekenreeks eindigt met het opgegeven achtervoegsel. De vergelijking kan eventueel niet hoofdlettergevoelig zijn.
INDEX-OF	De INDEX_OF functie retourneert de index van het eerste exemplaar van een tekenreeks.
LEFT	De LEFT functie retourneert het linkerdeel van een tekenreeks tot het opgegeven aantal tekens.
LENGTH	De LENGTH functie retourneert het aantal tekens in de opgegeven tekenreeksexpressie.
LOWER	De LOWER functie retourneert een tekenreeksexpressie na het converteren van hoofdlettergegevens naar kleine letters.
LTRIM	De LTRIM functie retourneert een tekenreeksexpressie nadat deze voorloopspaties of opgegeven tekens verwijdert.
REGEXMATCH	De REGEXMATCH functie retourneert een Booleaanse waarde die aangeeft of de opgegeven tekenreeks overeenkomt met de opgegeven reguliere expressie. Reguliere expressies zijn een beknopte en flexibele notatie voor het vinden van tekstpatronen.
REPLACE	De REPLACE functie retourneert een tekenreeks waarbij alle exemplaren van een opgegeven tekenreeks zijn vervangen.
REPLICATE	De REPLICATE functie retourneert een tekenreekswaarde die een bepaald aantal keren wordt herhaald.
REVERSE	De REVERSE functie retourneert de omgekeerde volgorde van een tekenreekswaarde.
RIGHT	De RIGHT functie retourneert het rechterdeel van een tekenreeks tot het opgegeven aantal tekens.
RTRIM	De RTRIM functie retourneert een tekenreeksexpressie nadat deze volgspaties of opgegeven tekens verwijdert.
STARTSWITH	De STARTSWITH functie retourneert een Booleaanse waarde die aangeeft of de eerste tekenreeksexpressie begint met de tweede.
STRINGEQUALS	De STRINGEQUALS functie retourneert een Booleaanse waarde die aangeeft of de eerste tekenreeksexpressie overeenkomt met de tweede.
STRINGJOIN	De STRINGJOIN functie retourneert een tekenreeks, die de elementen van een opgegeven matrix samenvoegt met behulp van het opgegeven scheidingsteken tussen elk element.
STRINGSPLIT	De STRINGSPLIT functie retourneert een matrix met subtekenreeksen die zijn verkregen van het scheiden van de brontekenreeks door het opgegeven scheidingsteken.
STRINGTOARRAY	De STRINGTOARRAY functie converteert een tekenreeksexpressie naar een matrix.
STRINGTOBOOLEAN	De STRINGTOBOOLEAN functie converteert een tekenreeksexpressie naar een Booleaanse waarde.
SUBSTRING	De SUBSTRING functie retourneert een deel van een tekenreeksexpressie vanaf de opgegeven positie en de opgegeven lengte, of aan het einde van de tekenreeks.
TOSTRING	De TOSTRING functie retourneert een tekenreeksweergave van een waarde.
TRIM	De TRIM functie retourneert een tekenreeksexpressie nadat deze voorloop- en volgspaties of aangepaste tekens verwijdert.
UPPER	De UPPER functie retourneert een tekenreeksexpressie na het converteren van gegevens uit kleine letters naar hoofdletters.

Datum- en tijdfuncties

	Description
DATETIMEADD	De DATETIMEADD functie retourneert een tekenreekswaarde voor datum en tijd die het resultaat is van het toevoegen van een opgegeven getalwaarde aan de opgegeven datum- en tijdtekenreeks.
DATETIMEBIN	De DATETIMEBIN functie retourneert een datum- en tijdtekenreekswaarde die het resultaat is van binning (of afronding) van een deel van de opgegeven datum- en tijdtekenreeks.
DATETIMEDIFF	De DATETIMEDIFF functie retourneert het verschil, als een ondertekend geheel getal, van de opgegeven datum- en tijdgedeelte tussen twee datum- en tijdwaarden.
DATETIMEFROMPARTS	De DATETIMEFROMPARTS functie retourneert een tekenreekswaarde voor datum en tijd die is samengesteld op basis van numerieke invoerwaarden voor verschillende datum- en tijdonderdelen.
DATETIMEPART	De DATETIMEPART functie retourneert de waarde van het opgegeven datum- en tijdgedeelte voor de opgegeven datum en tijd.
DATETIMETOTICKS	De DATETIMETOTICKS functie converteert de opgegeven datum/tijd naar tikken. Eén maatstreepje vertegenwoordigt 100 nanoseconden of 0,0000001 van een seconde.
DATETIMETOTIMESTAMP	De DATETIMETOTIMESTAMP functie converteert de opgegeven datum en tijd naar een numeriek tijdstempel. De tijdstempel is een ondertekend numeriek geheel getal dat de milliseconden meet sinds het Unix-tijdperk.
GETCURRENTDATETIME	De GETCURRENTDATETIME functie retourneert de huidige UTC-datum en -tijd (Coordinated Universal Time) als een ISO 8601-tekenreeks .
GETCURRENTDATETIMESTATIC	De GETCURRENTDATETIMESTATIC functie retourneert dezelfde UTC-datum- en tijdwaarde voor alle items in de query, als een ISO 8601-tekenreeks. Dit is handig voor consistente tijdstempels in queryresultaten.
GETCURRENTTICKS	De GETCURRENTTICKS functie retourneert de huidige UTC-tijd als het aantal intervallen van 100 nanoseconden (tikken) dat is verstreken sinds 0001-01-01T00:00:00.00000000Z.
GETCURRENTTICKSSTATIC	De GETCURRENTTICKSSTATIC functie retourneert een statische nanoseconde tekenwaarde (intervallen van 100 nanoseconden sinds het Unix-tijdperk) voor alle items in dezelfde partitie.
GETCURRENTTIMESTAMP	De GETCURRENTTIMESTAMP functie retourneert de huidige tijdstempel in milliseconden sinds de Unix-epoch.
GETCURRENTTIMESTAMPSTATIC	De GETCURRENTTIMESTAMPSTATIC functie retourneert een statische tijdstempelwaarde (milliseconden sinds het Unix-tijdperk) voor alle items in dezelfde partitie.
TICKSTODATETIME	De TICKSTODATETIME functie converteert het opgegeven aantal tikken naar een datum- en tijdwaarde.
TIMESTAMPTODATETIME	De TIMESTAMPTODATETIME functie converteert het opgegeven tijdstempel naar een datum- en tijdwaarde.

Item functies

	Description
DOCUMENTID	De DOCUMENTID functie retourneert de unieke document-id voor een bepaald item in de container.

Functies voor zoeken in volledige tekst

	Description
FULLTEXTCONTAINS	De FULLTEXTCONTAINS functie retourneert een Booleaanse waarde die aangeeft of de tekenreeksexpressie van het trefwoord is opgenomen in een opgegeven eigenschapspad.
FULLTEXTCONTAINSALL	De FULLTEXTCONTAINSALL functie retourneert een Booleaanse waarde die aangeeft of alle opgegeven tekenreeksexpressies zijn opgenomen in een opgegeven eigenschapspad.
FULLTEXTCONTAINSANY	De FULLTEXTCONTAINSANY functie retourneert een Booleaanse waarde die aangeeft of een van de opgegeven tekenreeksexpressies zich in een opgegeven eigenschapspad bevindt.
FULLTEXTSCORE	De FULLTEXTSCORE functie retourneert een BM25-scorewaarde die alleen in een ORDER BY RANK component kan worden gebruikt om resultaten te sorteren van hoogste relevantie tot laagste relevantie van de opgegeven termen.
RRF	De RRF functie retourneert een gefuseerde score door twee of meer scores van andere functies te combineren.

Voorwaardelijke functies

	Description
IIF	De IIF functie retourneert een van de twee waarden, afhankelijk van of de Boole-expressie waar of onwaar oplevert.

Functies voor typecontrole

	Description
IS_ARRAY	De IS_ARRAY functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie een matrix is.
IS_BOOL	De IS_BOOL functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie een Booleaanse waarde is.
IS_DEFINED	De IS_DEFINED functie retourneert een Booleaanse waarde die aangeeft of aan de eigenschap een waarde is toegewezen.
IS_FINITE_NUMBER	De IS_FINITE_NUMBER functie retourneert een Booleaanse waarde die aangeeft of een getal een eindig getal is (niet oneindig).
IS_INTEGER	De IS_INTEGER functie retourneert een Booleaanse waarde die aangeeft of een getal een 64-bits geheel getal is dat is ondertekend. 64-bits ondertekende gehele getallen variëren van -9,223,372,036,854,775,808 tot 9,223,372,036,854,775,807. Zie __int64 voor meer informatie.
IS_NULL	De IS_NULL functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie is null.
IS_NUMBER	De IS_NUMBER functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie een getal is.
IS_OBJECT	De IS_OBJECT functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie een JSON-object is.
IS_PRIMITIVE	De IS_PRIMITIVE functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie een primitieve waarde is (tekenreeks, booleaanse waarde, numeriek of null).
IS_STRING	De IS_STRING functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie een tekenreeks is.
STRINGTONULL	De STRINGTONULL functie converteert een tekenreeksexpressie naar null.
STRINGTONUMBER	De STRINGTONUMBER functie converteert een tekenreeksexpressie naar een getal.
STRINGTOOBJECT	De STRINGTOOBJECT functie converteert een tekenreeksexpressie naar een object.

Ruimtelijke functies

	Description
ST_AREA	De ST_AREA functie retourneert het totale gebied van een GeoJSON Polygon- of MultiPolygon-expressie.
ST_DISTANCE	De ST_DISTANCE functie retourneert de afstand tussen twee GeoJSON-punt-, Polygoon-, MultiPolygon- of LineString-expressies.
ST_INTERSECTS	De ST_INTERSECTS functie retourneert een Booleaanse waarde die aangeeft of het GeoJSON-object dat is opgegeven in het eerste argument het GeoJSON-object in het tweede argument doorkruist.
ST_ISVALID	De ST_ISVALID functie retourneert een Booleaanse waarde die aangeeft of de opgegeven GeoJSON-punt-, Veelhoek-, MultiPolygon- of LineString-expressie geldig is.
ST_ISVALIDDETAILED	De ST_ISVALIDDETAILED functie retourneert een JSON-waarde die een Booleaanse waarde bevat als de opgegeven GeoJSON-punt-, Veelhoek- of LineString-expressie geldig is en als deze ongeldig is, de reden.
ST_WITHIN	De ST_WITHIN functie retourneert een Booleaanse expressie die aangeeft of het GeoJSON-object dat is opgegeven in het eerste argument zich binnen het GeoJSON-object in het tweede argument bevindt.
VECTORDISTANCE	De VECTORDISTANCE functie retourneert de overeenkomstscore tussen twee opgegeven vectoren.