Funzioni - Linguaggio di query in Cosmos DB (in Azure e Infrastruttura)

Il linguaggio di query include una serie di funzioni di sistema integrate nel linguaggio di query e progettate per gestire un'ampia gamma di attività comuni.

Functions

Ecco un elenco di funzioni attualmente supportate dal linguaggio di query:

Funzioni matematiche

	Description
ABS	La ABS funzione calcola il valore assoluto (positivo) dell'espressione numerica specificata.
ACOS	La ACOS funzione calcola l'arcocosine trigonometrico del valore numerico specificato. L'arcocosina è l'angolo, espresso in radianti, il cui coseno è l'espressione numerica specificata.
ASIN	La ASIN funzione calcola l'arcogonometrico dell'arcosine del valore numerico specificato. L'arcosine è l'angolo, espresso in radianti, il cui seno è l'espressione numerica specificata.
ATAN	La ATAN funzione calcola l'arcotangente trigonometrico del valore numerico specificato. L'arcotangente è l'angolo, espresso in radianti, la cui tangente è l'espressione numerica specificata.
ATN2	La ATN2 funzione calcola il valore principale dell'arcotangente di y/x, espresso in radianti.
CEILING	La CEILING funzione calcola il valore intero più piccolo maggiore o uguale all'espressione numerica specificata.
COS	La COS funzione calcola il coseno trigonometrico dell'angolo specificato in radianti.
COT	La COT funzione calcola la cotangente trigonometrica dell'angolo specificato in radianti.
DEGREES	La DEGREES funzione calcola l'angolo corrispondente in gradi per un angolo specificato in radianti.
EXP	La EXP funzione calcola il valore esponenziale dell'espressione numerica specificata.
FLOOR	La FLOOR funzione calcola il numero intero più grande minore o uguale all'espressione numerica specificata.
INTADD	La INTADD funzione restituisce la somma di due valori interi.
INTBITAND	La INTBITAND funzione restituisce un confronto dei bit di ogni operando usando un operatore AND inclusivo.
INTBITLEFTSHIFT	La INTBITLEFTSHIFT funzione restituisce il risultato di un'operazione di spostamento a sinistra bit per bit su un valore intero.
INTBITNOT	La INTBITNOT funzione restituisce il risultato di un'operazione NOT bit per bit su un valore intero.
INTBITOR	La INTBITOR funzione restituisce il risultato di un'operazione OR inclusiva bit per bit su due valori interi.
INTBITRIGHTSHIFT	La INTBITRIGHTSHIFT funzione restituisce il risultato di un'operazione di spostamento a destra bit per bit su un valore intero.
INTBITXOR	La INTBITXOR funzione restituisce il risultato di un'operazione OR esclusiva bit per bit su due valori interi.
INTDIV	La INTDIV funzione restituisce il risultato della divisione del primo valore intero per il secondo.
INTMOD	La INTMOD funzione restituisce il resto della divisione del primo valore intero per il secondo.
INTMUL	La INTMUL funzione restituisce il prodotto di due valori interi.
INTSUB	La INTSUB funzione restituisce il risultato della sottrazione del secondo valore intero dal primo.
LOG	La LOG funzione restituisce il logaritmo naturale dell'espressione numerica specificata.
LOG10	La LOG10 funzione restituisce il logaritmo in base 10 dell'espressione numerica specificata.
NUMBERBIN	La NUMBERBIN funzione calcola il valore di input arrotondato a un multiplo delle dimensioni specificate.
PI	La PI funzione restituisce il valore costante di Pi.
POWER	La POWER funzione restituisce il valore dell'espressione specificata moltiplicata per sé il numero di volte specificato.
RADIANS	La RADIANS funzione restituisce l'angolo corrispondente in radianti per un angolo specificato in gradi.
RAND	La RAND funzione restituisce un valore numerico generato in modo casuale da zero a uno.
ROUND	La ROUND funzione restituisce un valore numerico arrotondato al valore intero più vicino.
SIGN	La SIGN funzione restituisce il segno positivo (+1), zero (0) o negativo (-1) dell'espressione numerica specificata.
SIN	La SIN funzione restituisce il seno trigonometrico dell'angolo specificato in radianti.
SQRT	La SQRT funzione restituisce la radice quadrata del valore numerico specificato.
SQUARE	La SQUARE funzione restituisce il quadrato del valore numerico specificato.
TAN	La TAN funzione restituisce la tangente trigonometrica dell'angolo specificato in radianti.
TRUNC	La TRUNC funzione restituisce un valore numerico troncato al valore intero più vicino.

Funzioni di array

	Description
ARRAY_CONCAT	La ARRAY_CONCAT funzione restituisce una matrice che è il risultato della concatenazione di due o più valori di matrice.
ARRAY_CONTAINS_ALL	La ARRAY_CONTAINS_ALL funzione restituisce un valore booleano che indica se la matrice contiene tutti i valori specificati.
ARRAY_CONTAINS_ANY	La ARRAY_CONTAINS_ANY funzione restituisce un valore booleano che indica se la matrice contiene uno dei valori specificati.
ARRAY_CONTAINS	La ARRAY_CONTAINS funzione restituisce un valore booleano che indica se la matrice contiene il valore specificato. È possibile verificare la presenza di una corrispondenza parziale o completa di un oggetto usando un'espressione booleana all'interno della funzione.
ARRAY_LENGTH	La ARRAY_LENGTH funzione restituisce il numero di elementi nell'espressione di matrice specificata.
ARRAY_SLICE	La ARRAY_SLICE funzione restituisce un subset di un'espressione di matrice utilizzando l'indice e la lunghezza specificati.
CHOOSE	La CHOOSE funzione restituisce l'espressione in corrispondenza dell'indice specificato di un elenco o Undefined se l'indice supera i limiti dell'elenco.
OBJECTTOARRAY	La OBJECTTOARRAY funzione converte coppie campo/valore in un oggetto JSON in una matrice JSON.
SETINTERSECT	La SETINTERSECT funzione restituisce il set di espressioni contenute in entrambe le matrici di input senza duplicati.
SETUNION	La SETUNION funzione restituisce un set di espressioni contenenti tutte le espressioni di due set raccolti senza duplicati.

Funzione di aggregazione

	Description
AVG	La AVG funzione calcola la media dei valori nell'espressione.
COUNT	La COUNT funzione restituisce il conteggio dei valori nell'espressione.
MAX	La MAX funzione restituisce il valore massimo dell'espressione specificata.
MIN	La MIN funzione restituisce il valore minimo dell'espressione specificata.
SUM	La SUM funzione calcola la somma dei valori nell'espressione.

Funzioni stringa

	Description
CONCAT	La CONCAT funzione restituisce una stringa che è il risultato della concatenazione di più campi da un documento.
CONTAINS	La CONTAINS funzione restituisce un valore booleano che indica se la prima espressione stringa contiene la seconda espressione stringa.
ENDSWITH	La ENDSWITH funzione restituisce un valore booleano che indica se una stringa termina con il suffisso specificato. Facoltativamente, il confronto può non essere distinzione tra maiuscole e minuscole.
INDEX-OF	La INDEX_OF funzione restituisce l'indice della prima occorrenza di una stringa.
LEFT	La LEFT funzione restituisce la parte sinistra di una stringa fino al numero specificato di caratteri.
LENGTH	La LENGTH funzione restituisce il numero di caratteri nell'espressione stringa specificata.
LOWER	La LOWER funzione restituisce un'espressione stringa dopo la conversione dei dati di caratteri maiuscoli in lettere minuscole.
LTRIM	La LTRIM funzione restituisce un'espressione stringa dopo la rimozione degli spazi vuoti iniziali o dei caratteri specificati.
REGEXMATCH	La REGEXMATCH funzione restituisce un valore booleano che indica se la stringa specificata corrisponde all'espressione regolare specificata. Le espressioni regolari sono una notazione concisa e flessibile per la ricerca di modelli di testo.
REPLACE	La REPLACE funzione restituisce una stringa con tutte le occorrenze di una stringa specificata sostituita.
REPLICATE	La REPLICATE funzione restituisce un valore stringa ripetuto un numero specifico di volte.
REVERSE	La REVERSE funzione restituisce l'ordine inverso di un valore stringa.
RIGHT	La RIGHT funzione restituisce la parte destra di una stringa fino al numero specificato di caratteri.
RTRIM	La RTRIM funzione restituisce un'espressione stringa dopo la rimozione degli spazi vuoti finali o dei caratteri specificati.
STARTSWITH	La STARTSWITH funzione restituisce un valore booleano che indica se la prima espressione stringa inizia con la seconda.
STRINGEQUALS	La STRINGEQUALS funzione restituisce un valore booleano che indica se la prima espressione stringa corrisponde al secondo.
STRINGJOIN	La STRINGJOIN funzione restituisce una stringa, che concatena gli elementi di una matrice specificata, usando il separatore specificato tra ogni elemento.
STRINGSPLIT	La STRINGSPLIT funzione restituisce una matrice di sottostringhe ottenute separando la stringa di origine dal delimitatore specificato.
STRINGTOARRAY	La STRINGTOARRAY funzione converte un'espressione stringa in una matrice.
STRINGTOBOOLEAN	La STRINGTOBOOLEAN funzione converte un'espressione stringa in un valore booleano.
SUBSTRING	La SUBSTRING funzione restituisce parte di un'espressione stringa a partire dalla posizione specificata e dalla lunghezza specificata oppure alla fine della stringa.
TOSTRING	La TOSTRING funzione restituisce una rappresentazione di stringa di un valore.
TRIM	La TRIM funzione restituisce un'espressione stringa dopo la rimozione di spazi vuoti iniziali e finali o caratteri personalizzati.
UPPER	La UPPER funzione restituisce un'espressione stringa dopo la conversione dei dati di caratteri minuscoli in lettere maiuscole.

Funzioni di data e ora

	Description
DATETIMEADD	La DATETIMEADD funzione restituisce un valore stringa di data e ora risultante dall'aggiunta di un valore numerico specificato alla stringa di data e ora specificata.
DATETIMEBIN	La DATETIMEBIN funzione restituisce un valore stringa di data e ora risultante dall'arrotondamento (o dall'arrotondamento) di una parte della stringa di data e ora specificata.
DATETIMEDIFF	La DATETIMEDIFF funzione restituisce la differenza, come intero con segno, della parte di data e ora specificata tra due valori di data e ora.
DATETIMEFROMPARTS	La DATETIMEFROMPARTS funzione restituisce un valore stringa di data e ora costruito dai valori numerici di input per varie parti di data e ora.
DATETIMEPART	La DATETIMEPART funzione restituisce il valore della parte di data e ora specificata per la data e l'ora specificate.
DATETIMETOTICKS	La DATETIMETOTICKS funzione converte l'oggetto DateTime specificato in tick. Un singolo segno di graduazione rappresenta 100 nanosecondi o 0,0000001 di secondo.
DATETIMETOTIMESTAMP	La DATETIMETOTIMESTAMP funzione converte la data e l'ora specificate in un timestamp numerico. Il timestamp è un numero intero numerico con segno che misura i millisecondi dall'epoca Unix.
GETCURRENTDATETIME	La GETCURRENTDATETIME funzione restituisce la data e l'ora UTC correnti (Coordinated Universal Time) come stringa ISO 8601 .
GETCURRENTDATETIMESTATIC	La GETCURRENTDATETIMESTATIC funzione restituisce lo stesso valore di data e ora UTC per tutti gli elementi della query, come stringa ISO 8601. Ciò è utile per i timestamp coerenti tra i risultati della query.
GETCURRENTTICKS	La GETCURRENTTICKS funzione restituisce l'ora UTC corrente come numero di intervalli di 100 nanosecondi (tick) trascorsi da 0001-01-01T00:00:00:00.000000Z.
GETCURRENTTICKSSTATIC	La GETCURRENTTICKSSTATIC funzione restituisce un valore di graduazione nanosecondo statico (intervalli di 100 nanosecondi dall'epoca Unix) per tutti gli elementi nella stessa partizione.
GETCURRENTTIMESTAMP	La GETCURRENTTIMESTAMP funzione restituisce il timestamp corrente in millisecondi dall'epoca Unix.
GETCURRENTTIMESTAMPSTATIC	La GETCURRENTTIMESTAMPSTATIC funzione restituisce un valore timestamp statico (millisecondi dall'epoca Unix) per tutti gli elementi nella stessa partizione.
TICKSTODATETIME	La TICKSTODATETIME funzione converte il numero specificato di tick in un valore di data e ora.
TIMESTAMPTODATETIME	La TIMESTAMPTODATETIME funzione converte il timestamp specificato in un valore di data e ora.

Funzioni dell'elemento

	Description
DOCUMENTID	La DOCUMENTID funzione restituisce l'ID documento univoco per un determinato elemento nel contenitore.

Funzioni di ricerca testo completo

	Description
FULLTEXTCONTAINS	La FULLTEXTCONTAINS funzione restituisce un valore booleano che indica se l'espressione stringa di parola chiave è contenuta in un percorso di proprietà specificato.
FULLTEXTCONTAINSALL	La FULLTEXTCONTAINSALL funzione restituisce un valore booleano che indica se tutte le espressioni stringa specificate sono contenute in un percorso di proprietà specificato.
FULLTEXTCONTAINSANY	La FULLTEXTCONTAINSANY funzione restituisce un valore booleano che indica se una delle espressioni stringa specificate è contenuta in un percorso di proprietà specificato.
FULLTEXTSCORE	La FULLTEXTSCORE funzione restituisce un valore di punteggio BM25 che può essere usato solo in una ORDER BY RANK clausola per ordinare i risultati dalla maggiore pertinenza alla maggiore pertinenza dei termini specificati.
RRF	La RRF funzione restituisce un punteggio fuso combinando due o più punteggi forniti da altre funzioni.

Funzioni condizionali

	Description
IIF	La IIF funzione restituisce uno dei due valori, a seconda che l'espressione booleana restituisca true o false.

Funzioni di controllo del tipo

	Description
IS_ARRAY	La IS_ARRAY funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è una matrice.
IS_BOOL	La IS_BOOL funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è un valore booleano.
IS_DEFINED	La IS_DEFINED funzione restituisce un valore booleano che indica se alla proprietà è stato assegnato un valore.
IS_FINITE_NUMBER	La IS_FINITE_NUMBER funzione restituisce un valore booleano che indica se un numero è un numero finito (non infinito).
IS_INTEGER	La IS_INTEGER funzione restituisce un valore booleano che indica se un numero è un intero con segno a 64 bit. Gli interi con segno a 64 bit vanno da -9,223,372,036,854,775,808 a 9,223,372,036,854,775,807. Per altre informazioni, vedere __int64.
IS_NULL	La IS_NULL funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è null.
IS_NUMBER	La IS_NUMBER funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è un numero.
IS_OBJECT	La IS_OBJECT funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è un oggetto JSON.
IS_PRIMITIVE	La IS_PRIMITIVE funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è una primitiva (stringa, booleana, numerica o null).
IS_STRING	La IS_STRING funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è una stringa.
STRINGTONULL	La STRINGTONULL funzione converte un'espressione stringa in null.
STRINGTONUMBER	La STRINGTONUMBER funzione converte un'espressione stringa in un numero.
STRINGTOOBJECT	La STRINGTOOBJECT funzione converte un'espressione stringa in un oggetto .

Funzioni spaziali

	Description
ST_AREA	La ST_AREA funzione restituisce l'area totale di un'espressione Polygon GeoJSON o MultiPolygon.
ST_DISTANCE	La ST_DISTANCE funzione restituisce la distanza tra due espressioni GeoJSON Point, Polygon, MultiPolygon o LineString.
ST_INTERSECTS	La ST_INTERSECTS funzione restituisce un valore booleano che indica se l'oggetto GeoJSON specificato nel primo argomento interseca l'oggetto GeoJSON nel secondo argomento.
ST_ISVALID	La ST_ISVALID funzione restituisce un valore booleano che indica se l'espressione GeoJSON Point, Polygon, MultiPolygon o LineString specificata è valida.
ST_ISVALIDDETAILED	La ST_ISVALIDDETAILED funzione restituisce un valore JSON contenente un valore booleano se l'espressione GeoJSON Point, Polygon o LineString specificata è valida e, se non è valida, il motivo.
ST_WITHIN	La ST_WITHIN funzione restituisce un'espressione booleana che indica se l'oggetto GeoJSON specificato nel primo argomento si trova all'interno dell'oggetto GeoJSON nel secondo argomento.
VECTORDISTANCE	La VECTORDISTANCE funzione restituisce il punteggio di somiglianza tra due vettori specificati.