Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
Databricks SQL
Databricks Runtime
Questo articolo presenta collegamenti a e descrizioni di operatori e funzioni predefiniti per stringhe e tipi binari, scalari numerici, aggregazioni, finestre, matrici, mappe, date e timestamp, cast, dati CSV, dati JSON, manipolazione XPath e altre funzioni varie.
Per i casi d'uso non supportati dalle funzioni predefinite esistenti, è consigliabile definire una funzione personalizzata. Vedere Che cosa sono le funzioni definite dall'utente (UDF)?.
Vedere anche:
Operatori e predicati
Per informazioni sul modo in cui gli operatori vengono analizzati l'uno rispetto all'altro, vedere Precedenza dell'operatore.
| Operator | Syntax | Description |
|---|---|---|
| & | expr1 & expr2 |
Restituisce il risultato dell'operazione bit a bit AND tra expr1 e expr2. |
| and | expr1 and expr2 |
Restituisce il AND logico di expr1 e expr2. |
| * | multiplier * multiplicand |
Restituisce multiplier moltiplicato per multiplicand. |
| != | expr1 != expr2 |
Restituisce true se expr1 non è uguale expr2, o false in caso contrario. |
| ! | !expr |
Restituisce il NOT logico di un'espressione booleana. |
| between | expr1 [not] between expr2 and expr2 |
Verifica se expr1 è maggiore o uguale a expr2 e minore o uguale a expr3. |
| [] | arrayExpr [ indexExpr ] |
Restituisce l’elemento indexExpr di ARRAYarrayExpr. |
| [] | mapExpr [ keyExpr ] |
Restituisce il valore al keyExpr di MAPmapExpr. |
| ^ | expr1 ^ expr2 |
Restituisce l'oggetto bit esclusivo OR (XOR) di expr1 e expr2. |
| : | jsonStr : jsonPath |
Restituisce i campi estratti da jsonStr. |
| :: | expr :: type |
Esegue il cast del valore expr al tipo di dati di destinazione type. |
| ?:: | expr ?:: type |
Se possibile, esegue il cast del valore expr al tipo di dati di destinazione type, altrimenti restituisce NULL. |
| div | dividend div divisor |
Restituisce la parte integrante della divisione di dividend per divisor. |
| . | mapExpr . keyIdentifier |
Restituisce un valore MAP per keyIdentifier. |
| . | structExpr . fieldIdentifier |
Restituisce un campo STRUCT per fieldIdentifier. |
| == | expr1 == expr2 |
Restituisce true se expr1 è uguale a expr2 o false in caso contrario. |
| = | expr1 = expr2 |
Restituisce true se expr1 è uguale a expr2 o false in caso contrario. |
| >= | expr1 >= expr2 |
Restituisce true se expr1 è maggiore o uguale a expr2, o false in caso contrario. |
| > | expr1 > expr2 |
Restituisce true se expr1 è maggiore di expr2, o false in caso contrario. |
| exists | exists(query) |
Restituisce true se query restituisce almeno una riga o false in caso contrario. |
| ilike | str [not] ilike (pattern[ESCAPE escape]) |
Restituisce true se str (non) corrisponde a pattern senza distinzione tra maiuscole e minuscole escape. |
| ilike | str [not] ilike {ANY\|SOME\|ALL}([pattern[, ...]]) |
Restituisce true se str (non) corrisponde a qualsiasi o a tutti gli schemi senza distinzione tra maiuscole o minuscole. |
| in | elem [not] in (expr1[, ...]) |
Restituisce true se elem (non) è uguale a qualsiasi exprN. |
| in | elem [not] in (query) |
Restituisce true se elem (non) è uguale a qualsiasi riga in query. |
| è distinto | expr1 is [not] distinct from expr2 |
Verifica se gli argomenti non hanno valori diversi in cui NULLs vengono considerati come valori confrontabili. |
| è falso | expr is [not] false |
Verifica se expr (non) è false. |
| è null | expr is [not] null |
Restituisce true se expr (non) è NULL. |
| è vero | expr is [not] true |
Verifica se expr (non) è true. |
| like | str [not] like (pattern[ESCAPE escape]) |
Restituisce true se str (non) corrisponde a pattern con escape. |
| like | str [not] like {ANY\|SOME\|ALL}([pattern[, ...]]) |
Restituisce true se str (non) corrisponde ad alcun criterio o a tutti i criteri. |
| <=> | expr1 <=> expr2 |
Restituisce lo stesso risultato di EQUAL(=) per gli operandi non Null, ma restituisce true se entrambi sono NULL, false se uno di essi è NULL. |
| <= | expr1 <= expr2 |
Restituisce true se expr1 è minore o uguale a expr2; in caso contrario, false. |
| <> | expr1 <> expr2 |
Restituisce true se expr1 non è uguale a expr2, in caso contrario, false. |
| < | expr1 < expr2 |
Restituisce true se expr1 è minore di expr2, in caso contrario false. |
| - | expr1 - expr2 |
Restituisce la sottrazione di expr2 da expr1. |
| not | not expr |
Restituisce il NOT logico di un'espressione booleana. |
| or | expr1 or expr2 |
Restituisce il OR logico di expr1 e expr2. |
| % | dividend % divisor |
Restituisce il resto dopo dividend / divisor. |
| || | expr1 \|\| expr2 |
Restituisce la concatenazione dei parametri expr1 e expr2. |
| | | expr1 \| expr2 |
Restituisce il risultato dell'operazione bit a bit OR tra expr1 e expr2. |
| + | expr1 + expr2 |
Restituisce la somma di expr1 e expr2. |
| regexp | str [not] regexp regex |
Restituisce true se str (non) corrisponde a regex. |
| regexp_like | str [not] regexp_like regex |
Restituisce true se str (non) corrisponde a regex. |
| rlike | str [not] rlike regex |
Restituisce true se str (non) corrisponde a regex. |
| / | dividend / divisor |
Restituisce dividend diviso per divisor. |
| ~ | ~ expr |
Restituisce l’oggetto bit NOT di expr. |
Precedenza dell'operatore
| Precedence | Operator |
|---|---|
| 1 |
:, ::, ?::[ ] |
| 2 |
-(unario), +(unario), ~ |
| 3 |
*, /, %div |
| 4 |
+, -, \|\| |
| 5 | & |
| 6 | ^ |
| 7 | \| |
| 8 |
=, ==, <=>, <>, !=<, <=, , >>= |
| 9 |
not, exists |
| 10 |
between, in, rlike, regexpilike, like, , is [not] [NULL, true, false]is [not] distinct from |
| 11 | and |
| 12 | or |
Funzioni stringa e binarie
| Function | Description |
|---|---|
| expr1 || expr2 | Restituisce la concatenazione dei parametri expr1 e expr2. |
| aes_decrypt(expr, key[, mode[, padding[, aad]]]) | Decrittografa un expr binario usando la crittografia AES. |
| aes_encrypt(expr, key[, mode[, padding[, iv[, aad]]]) | Crittografa un file binario expr usando la crittografia AES. |
| ascii(str) | Restituisce il punto di codice ASCII del primo carattere di str. |
| base64(expr) | Converte un oggetto expr in una stringa base 64. |
| bin(expr) | Restituisce la rappresentazione binaria di expr. |
| binary(expr) | Converte il valore di expr in BINARY. |
| bit_length(expr) | Restituisce la lunghezza di bit dei dati stringa o il numero di bit di dati binari. |
| bitmap_count(expr) | Restituisce il numero di bit impostati in una stringa BINARY che rappresenta una bitmap. |
| btrim(str [, trimStr]) | Restituisce str con caratteri iniziali e finali rimossi. |
| char(expr) | Restituisce il carattere in corrispondenza del punto di codice UTF-16 fornito. |
| char_length(expr) | Restituisce la lunghezza del carattere dei dati stringa o il numero di byte di dati binari. |
| character_length(expr) | Restituisce la lunghezza del carattere dei dati stringa o il numero di byte di dati binari. |
| charindex(substr, str[, pos]) | Restituisce la posizione della prima occorrenza di substr in str dopo la posizione pos. |
| chr(expr) | Restituisce il carattere in corrispondenza del punto di codice UTF-16 fornito. |
| strExpr collate collationName | Associa una collazione esplicita collationName a strExpr. |
| regole di confronto per (strExpr) | Restituisce la collazione associata a strExpr. |
| concat(expr1, expr2[, ...]) | Restituisce la concatenazione degli argomenti. |
| concat_ws(sep[, expr1[, ...]]) | Restituisce le stringhe di concatenazione separate da sep. |
| contains(expr, subExpr) | Restituisce true se exprSTRING o BINARY contiene subExpr. |
| crc32(expr) | Restituisce un valore di controllo della ridondanza ciclico pari a expr. |
| decode(expr, charSet) | Converte il valore binario expr in una stringa usando la codifica del set di caratteri charSet. |
| encode(expr, charSet) | Restituisce la rappresentazione binaria di una stringa utilizzando la codifica dei caratteri charSet. |
| endswith(expr, endExpr) | Restituisce true se exprSTRING o BINARY termina con endExpr. |
| find_in_set(searchExpr, sourceExpr) | Restituisce la posizione di una stringa all'interno di un elenco delimitato da virgole di stringhe. |
| format_number(expr, scale) | Formati expr come #,###,###.##, arrotondati a scale posizioni decimali. |
| format_number(expr, fmt) | Formati expr come fmt. |
| format_string(strfmt[, obj1 [, ...]]) | Restituisce una stringa formattata dalle stringhe di formato di tipo printf. |
| hex(expr) | Converte expr in esadecimale. |
| str ilike (pattern[ESCAPE escape]) | Restituisce true se str corrisponde a pattern senza distinzione tra maiuscole e minuscole escape. |
| initcap(expr) | Restituisce expr con la prima lettera di ogni parola in maiuscolo. |
| instr(str, substr) | Restituisce l'indice (basato su 1) della prima occorrenza di substr all'interno di str. |
| lcase(expr) | Restituisce expr con tutti i caratteri modificati in minuscolo. |
| left(str, len) | Restituisce i caratteri len più a sinistra da str. |
| len(expr) | Restituisce la lunghezza del carattere dei dati stringa o il numero di byte di dati binari. |
| length(expr) | Restituisce la lunghezza del carattere dei dati stringa o il numero di byte di dati binari. |
| levenshtein(str1, str2) | Restituisce la distanza Levenshtein tra le stringhe str1 e str2. |
| str like (pattern[ESCAPE escape]) | Restituisce true se str corrisponde a pattern con escape. |
| locate(substr, str[, pos]) | Restituisce la posizione della prima occorrenza di substr in str dopo la posizione pos. |
| lower(expr) | Restituisce expr con tutti i caratteri modificati in minuscolo. |
| lpad(expr, len[, pad]) | Restituisce expr, riempito a sinistra con pad fino a una lunghezza di len. |
| ltrim([trimstr,] str) | Restituisce str con i caratteri iniziali da trimStr rimossi. |
| mask(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]]) | Restituisce una versione mascherata dell'input str. |
| md5(expr) | Restituisce un checksum MD5 a 128 bit di expr in formato esadecimale. |
| octet_length(expr) | Restituisce la lunghezza in byte dei dati stringa o il numero di byte di dati binari. |
| overlay(input INSERIMENTO sostituzione DA pos [PER len]) | Sostituisce input con replace che inizia da pos e è di lunghezza len. |
| overlay(input INSERIMENTO sostituzione DA pos [PER len]) | Sostituisce input con replace che inizia da pos e è di lunghezza len. |
| parse_url(url, partToExtract[, key]) | Estrae una parte da url. |
| position(substr, str[, pos]) | Restituisce la posizione della prima occorrenza di substr in str dopo la posizione pos. |
| position(subtr IN str) | Restituisce la posizione della prima occorrenza di substr in str dopo la posizione pos. |
| printf(strfmt[, obj1 [, ...]]) | Restituisce una stringa formattata dalle stringhe di formato di tipo printf. |
| randstr(length) | Restituisce una stringa casuale di length caratteri alfanumerici. |
| str regexp regex | Restituisce true se str corrisponde a regex. |
| str regexp_like regex | Restituisce true se str corrisponde a regex. |
| regexp_count(str, regexp) | Restituisce il numero di volte in cui str corrisponde al modello regexp. |
| regexp_extract(str, regexp[, idx]) | Estrae la prima stringa in str che corrisponde all'espressione regexp e corrisponde all'indice del gruppo regex. |
| regexp_extract_all(str, regexp[, idx]) | Estrae tutte le stringhe in str che corrispondono all'espressione regexp e corrisponde all'indice del gruppo regex. |
| regexp_instr(str, regexp) | Restituisce la posizione della prima sottostringa in str che corrisponde a regexp. |
| regexp_replace(str, regexp, rep[, position]) | Sostituisce tutte le sottostringhe di str che corrispondono a regexp con rep. |
| regexp_substr(str, regexp) | Restituisce la prima sottostringa in str che corrisponde a regexp. |
| repeat(expr, n) | Restituisce la stringa ripetuta expr volte n. |
| sostituisci(str, ricerca [, sostituzione]) | Sostituire tutte le occorrenze di search con replace. |
| reverse(expr) | Restituisce una stringa invertita o una matrice con ordine inverso di elementi. |
| right(str, len) | Restituisce i caratteri più a destra len della stringa str. |
| str rlike regex | Restituisce true se str corrisponde a regex. |
| rpad(expr, len[, pad]) | Restituisce expr, aggiungendo a destra pad fino a raggiungere una lunghezza di len. |
| rtrim([trimStr,] str) | Restituisce str con caratteri finali rimossi. |
| sentences(str[, lang, country]) | Suddivide str in una matrice di matrici di parole. |
| sha(expr) | Restituisce un valore hash sha1 come stringa esadecimale di expr. |
| sha1(expr) | Restituisce un valore hash sha1 come stringa esadecimale di expr. |
| sha2(expr, bitLength) | Restituisce un checksum della famiglia SHA-2 come stringa esadecimale di expr. |
| soundex(expr) | Restituisce il codice soundex della stringa. |
| space(n) | Restituisce una stringa costituita da spazi n. |
| split(str, regex[, limit]) | Suddivide str intorno alle occorrenze che corrispondono a regex e restituisce una matrice con una lunghezza massima di limit. |
| split_part(str, delim, partNum) | Divide str intorno alle occorrenze di delim e restituisce la parte partNum. |
| startswith(expr, startExpr) | Restituisce true se exprSTRING o BINARY inizia con startExpr. |
| string(expr) | Converte il valore expr in STRING. |
| substr(expr, pos[, len]) | Restituisce la sottostringa di expr che inizia da pos e è di lunghezza len. |
| substr(expr FROM pos[ FOR len]) | Restituisce la sottostringa di expr che inizia da pos e è di lunghezza len. |
| substring(expr, pos[, len]) | Restituisce la sottostringa di expr che inizia da pos e è di lunghezza len. |
| substring(expr FROM pos[ FOR len]) | Restituisce la sottostringa di expr che inizia da pos e è di lunghezza len. |
| substring_index(expr, delim, count) | Restituisce la sottostringa di expr prima delle occorrenze count del delimitatore delim. |
| to_binary(expr[, fmt]) | Restituisce expr, trasformato in un binario in base a fmt. |
| to_char(numExpr, fmt) | Restituisce numExpr convertito in STRING usando la formattazione fmt. |
| to_varchar(numExpr, fmt) | Restituisce numExpr convertito in STRING usando la formattazione fmt. |
| translate(expr, from, to) | Restituisce un expr in cui tutti i caratteri in from sono stati sostituiti con quelli in to. |
| trim([[BOTH | LEADING | TRAILING] [trimStr] FROM] str) | Rimuovi i caratteri da una stringa. |
| try_aes_decrypt(expr, key[, mode[, padding[, aad]]]) | Decrittografa un file binario expr usando la crittografia AES e restituisce NULL in caso di errore. |
| try_to_binary(expr [, fmt]) | Restituisce expr trasformato in BINARY basato su fmt o NULL se l'input non è valido. |
| try_url_decode(str) | Converte una stringa dal formato application/x-www-form-urlencoded e restituisce NULL in caso di errore. |
| try_zstd_decompress(value) | Restituisce un valore decompresso con compressione Zstandard o NULL se l'input non è valido. |
| ucase(expr) | Restituisce expr con tutti i caratteri modificati in maiuscolo. |
| unbase64(expr) | Restituisce una stringa base64 decodificata come binaria. |
| unhex(expr) | Converte l'esadecimale expr in BINARY. |
| upper(expr) | Restituisce expr con tutti i caratteri modificati in maiuscolo. |
| url_decode(str) | Riconverte una stringa dal formato application/x-www-form-urlencoded. |
| url_encode(str) | Converte una stringa in formato application/x-www-form-urlencoded . |
| zstd_compress (valore[,livello[,modalità_streaming]]) | Restituisce il valore compresso con la compressione Zstandard. |
| zstd_decompress(value) | Restituisce un valore decompresso con compressione Zstandard. |
Funzioni scalari numeriche
| Function | Description |
|---|---|
| ~ expr | Restituisce l’oggetto bit NOT di expr. |
| dividendo / divisore | Restituisce dividend diviso per divisor. |
| expr1 | expr2 | Restituisce il risultato dell'operazione bit a bit OR tra expr1 e expr2. |
| - espr | Restituisce il valore negato di expr. |
| expr1 - expr2 | Restituisce la sottrazione di expr2 da expr1. |
| + espr | Restituisce il valore di expr. |
| expr1 + expr2 | Restituisce la somma di expr1 e expr2. |
| dividendo % divisore | Restituisce il resto dopo dividend / divisor. |
| expr1 ^ expr2 | Restituisce l'oggetto bit esclusivo OR (XOR) di expr1 e expr2. |
| expr1 & expr2 | Restituisce il risultato dell'operazione bit a bit AND tra expr1 e expr2. |
| moltiplicatore * moltiplicando | Restituisce multiplier moltiplicato per multiplicand. |
| abs(expr) | Restituisce il valore assoluto del valore numero in expr. |
| acos(expr) | Restituisce il coseno inverso (arcocoseno) di expr. |
| acosh(expr) | Restituisce il coseno iperbolico inverso di expr. |
| asin(expr) | Restituisce l'arcoseno di expr. |
| asinh(expr) | Restituisce il seno iperbolico inverso di expr. |
| atan(expr) | Restituisce la tangente inversa (arcotangente) di expr. |
| atan2(exprY, exprX) | Restituisce l'angolo in radianti, tra l'asse x positivo di un piano e il punto specificato dalle coordinate (exprX, exprY). |
| atanh(expr) | Restituisce la tangente iperbolica inversa di expr. |
| bigint(expr) | Converte il valore expr in BIGINT. |
| bit_count(expr) | Restituisce il numero di bit impostati nell'argomento . |
| bit_get(expr, pos) | Restituisce il valore di un bit in una rappresentazione binaria di un valore numerico integrale. |
| bit_reverse(expr) | Restituisce il valore ottenuto invertendo l'ordine dei bit nell'argomento. |
| bitmap_bit_position(expr) | Restituisce la posizione in bit a 0 di un determinato numero BIGINT all'interno di un bucket. |
| bitmap_bucket_number(expr) | Restituisce il numero di bucket bitmap per un determinato numero BIGINT. |
| bround(expr[,targetScale]) | Restituisce expr arrotondato utilizzando la modalità di arrotondamento HALF_EVEN. |
| cbrt(expr) | Restituisce la radice cubica di expr. |
| ceil(expr[,targetScale]) | Restituisce il numero più piccolo non inferiore a expr arrotondato a targetScale cifre rispetto al separatore decimale. |
| ceiling(expr[,targetScale]) | Restituisce il numero più piccolo non inferiore a expr arrotondato a targetScale cifre rispetto al separatore decimale. |
| conv(num, fromBase, toBase) | Converte num da fromBase a toBase. |
| convert_timezone([sourceTz, ]targetTz, sourceTs) | Converte TIMESTAMP_NTZsourceTs dal fuso orario sourceTz a targetTz. |
| cos(expr) | Restituisce il coseno di expr. |
| cosh(expr) | Restituisce il coseno iperbolico di expr. |
| cot(expr) | Restituisce la cotangente di expr. |
| csc(expr) | Restituisce il cosecante di expr. |
| decimal(expr) | Converte il valore expr in DECIMAL. |
| degrees(expr) | Converte i radianti in gradi. |
| divisore div dividendo | Restituisce la parte integrante della divisione di divisor per dividend. |
| double(expr) | Converte il valore expr in DOUBLE. |
| e() | Restituisce la costante e. |
| exp(expr) | Restituisce e alla potenza di expr. |
| expm1(expr) | Restituisce exp(expr) - 1. |
| factorial(expr) | Restituisce il fattoriale di expr. |
| float(expr) | Converte il valore expr in FLOAT. |
| floor(expr[,targetScale]) | Restituisce il numero più grande non inferiore a expr arrotondato a targetScale cifre rispetto al separatore decimale. |
| getbit(expr, pos) | Restituisce il valore di un bit in una rappresentazione binaria di un valore numerico integrale. |
| hypot(expr1, expr2) | Restituisce sqrt(expr1 * expr1 + expr2 * expr2). |
| int(expr) | Converte il valore expr in INTEGER. |
| isnan(expr) | Restituisce true se expr è NaN. |
| ln(expr) | Restituisce il logaritmo naturale (base e) di expr. |
| log([base,] expr) | Restituisce il logaritmo di expr con base. |
| log1p(expr) | Restituisce log(1 + expr). |
| log2(expr) | Restituisce il logaritmo di expr con base 2. |
| log10(expr) | Restituisce il logaritmo di expr con base 10. |
| mod(dividend, divisor) | Restituisce il resto dopo dividend / divisor. |
| nanvl(expr1, expr2) | Restituisce expr1 se non è NaN, o expr2 in caso contrario. |
| negative(expr) | Restituisce il valore negato di expr. |
| 'nullifzero(expr)' | Restituisce expr se non è zero o NULL in caso contrario. |
| pi() | Restituisce pi. |
| pmod(dividendo, divisore) | Restituisce il resto positivo dopo dividend / divisor. |
| positive(expr) | Restituisce il valore di expr. |
| pow(expr1, expr2) | Aumenta expr1 alla potenza di expr2. |
| power(expr1, expr2) | Aumenta expr1 alla potenza di expr2. |
| radians(expr) | Converte expr da gradi a radianti. |
| rand([seed]) | Restituisce un valore casuale compreso tra 0 e 1. |
| randn([seed]) | Restituisce un valore casuale da una distribuzione normale standard. |
| random([seed]) | Restituisce un valore casuale compreso tra 0 e 1. |
| rint(expr) | Restituisce expr arrotondato a un numero intero come DOUBLE. |
| round(expr[,targetScale]) | Restituisce expr arrotondato utilizzando la modalità di arrotondamento HALF_UP. |
| sec(expr) | Restituisce la secante di expr. |
| shiftleft(expr, n) | Restituisce il valore ottenuto con uno spostamento bit a bit a sinistra di n posizioni. |
| shiftright(expr, n) | Restituisce un numero integrale con segno bit per bit spostato a destra per n bit. |
| shiftrightunsigned(expr, n) | Restituisce un numero integrale senza segno bit per bit spostato a destra per n bit. |
| sign(expr) | Restituisce -1.0, 0.0 o 1.0 perché expr è negativo, 0 o positivo. |
| signum(expr) | Restituisce -1.0, 0.0 o 1.0 perché expr è negativo, 0 o positivo. |
| sin(expr) | Restituisce il seno di expr. |
| sinh(expr) | Restituisce il seno iperbolico di expr. |
| smallint(expr) | Converte il valore expr in SMALLINT. |
| sqrt(expr) | Restituisce la radice quadrata di expr. |
| tan(expr) | Restituisce la tangente di expr. |
| tanh(expr) | Restituisce la tangente iperbolica di expr. |
| tinyint(expr) | Converte expr in TINYINT. |
| to_number(expr, fmt ) | Restituisce expr convertito in DECIMAL usando la formattazione fmt. |
| try_add(expr1, expr2) | Restituisce la somma di expr1 e expr2 o NULL in caso di errore. |
| try_divide(dividend, divisore) | Restituisce dividend diviso per divisor o NULL se divisor è 0. |
| try_mod(dividendo, divisore) | Restituisce il resto dopo dividend / divisor o NULL se divisor è 0.. |
| try_multiply(moltiplicatore, moltiplicatore) | Restituisce multiplier moltiplicato per multiplicand o NULL in caso di overflow. |
| try_subtract(expr1, expr2) | Restituisce la sottrazione di expr2 da expr1 o NULL in caso di overflow. |
| try_to_number(expr, fmt ) | Restituisce expr trasformando in DECIMAL utilizzando la formattazione fmt o NULL se expr non corrisponde al formato. |
| funzione "uniform" (expr1, expr2 [,seed]) | Restituisce un valore casuale con valori indipendenti e distribuiti in modo identico all'interno dell'intervallo di numeri specificato. |
| width_bucket(expr, minExpr, maxExpr, numBuckets) | Restituisce il numero del bucket per un valore in un istogramma di larghezza uniforme. |
| 'zeroifnull(expr)' | Restituisce expr se non è NULL, o 0 in caso contrario. |
Funzioni di aggregazione
| Function | Description |
|---|---|
| any(expr) | Restituisce true se almeno un valore di expr nel gruppo è true. |
| any_value(expr[,ignoreNull]) | Restituisce un valore di expr per un gruppo di righe. |
| approx_count_distinct(expr[,relativeSD]) | Restituisce il numero stimato di valori distinti in expr all'interno del gruppo. |
| approx_percentile(expr,percentage[,accuracy]) | Restituisce il percentile approssimativo di expr nel gruppo. |
| approx_top_k(expr[,k[,maxItemsTracked]]) | Restituisce i primi k valori degli elementi che si verificano più frequentemente in un expr insieme ai conteggi approssimativi. |
| array_agg(expr) | Restituisce una matrice costituita da tutti i valori in expr all'interno del gruppo. |
| avg(expr) | Restituisce la media calcolata dai valori di un gruppo. |
| bit_and(expr) | Restituisce l'AND bit per bit di tutti i valori di input nel gruppo. |
| bit_or(expr) | Restituisce l'OR bit per bit di tutti i valori di input nel gruppo. |
| bit_xor(expr) | Restituisce l'XOR bit per bit di tutti i valori di input nel gruppo. |
| bitmap_construct_agg(expr) | Restituisce la OR bit per bit di tutti i valori di posizione del bit nel gruppo. compreso tra 0 e 32767 in un gruppo come BINARY. |
| bitmap_or_agg(expr) | Restituisce la OR bit per bit di tutti i valori di input BINARY nel gruppo. |
| bool_and(expr) | Restituisce vero se tutti i valori in expr sono veri all'interno del gruppo. |
| bool_or(expr) | Restituisce true se almeno un valore in expr è true all'interno del gruppo. |
| collect_list(expr) | Restituisce una matrice costituita da tutti i valori in expr all'interno del gruppo. |
| collect_set(expr) | Restituisce una matrice costituita da tutti i valori univoci in expr all'interno del gruppo. |
| corr(expr1,expr2) | Restituisce il coefficiente di Pearson della correlazione tra un gruppo di coppie numeri. |
| count(*) | Restituisce il numero totale di righe recuperate in un gruppo, incluse le righe contenenti null. |
| count(expr[, ...]) | Restituisce il numero di righe di un gruppo per cui le espressioni fornite sono tutte non Null. |
| count_if(expr) | Restituisce il numero di valori true per il gruppo in expr. |
| count_min_sketch(column,epsilon,confidence,seed) | Genera uno schizzo count-min di tutti i valori del gruppo in column con epsilon, confidence e seed. |
| covar_pop(expr1,expr2) | Restituisce la covarianza della popolazione di coppie di numeri in un gruppo. |
| covar_samp(expr1,expr2) | Restituisce la covarianza di esempio di coppie numeriche in un gruppo. |
| every(expr) | Restituisce vero se tutti i valori di expr nel gruppo sono veri. |
| first(expr[,ignoreNull]) | Restituisce il primo valore di expr per un gruppo di righe. |
| first_value(expr[,ignoreNull]) | Restituisce il primo valore di expr per un gruppo di righe. |
| histogram_numeric(expr,numBins) | Calcola un istogramma su expr con i bin numBins, restituendo una matrice di coppie che rappresentano i centri dei bin. |
| hll_sketch_agg(expr[,lgConfigK]) | Restituisce uno schizzo HyperLogLog utilizzato per approssimare un conteggio dei valori distinti. |
| hll_union_agg(expr[,allowDifferentLgConfigK]) | Aggrega gli schizzi di HyperLogLog per un gruppo di righe. |
| kurtosis(expr) | Restituisce il valore della kurtosi calcolato dai valori di un gruppo. |
| last(expr[,ignoreNull]) | Restituisce l'ultimo valore di expr per il gruppo di righe. |
| last_value(expr[,ignoreNull]) | Restituisce l'ultimo valore di expr per il gruppo di righe. |
| listagg(expr[,delim]) [ALL'INTERNO DEL GRUPPO (ORDER BY chiave [,...])] | Restituisce un concatenato STRING o BINARY di tutti i valori nel gruppo expr, separati da delim. |
| max(expr) | Restituisce il valore massimo di expr in un gruppo. |
| max_by(expr1,expr2) | Restituisce il valore di un expr1 associato al valore massimo di expr2 in un gruppo. |
| mean(expr) | Restituisce la media calcolata dai valori di un gruppo. |
| measure(measure_column) | Restituisce la misura di una visualizzazione metrica calcolata dai valori di un gruppo. |
| median(expr) | Restituisce la mediano calcolata dai valori di un gruppo. |
| min(expr) | Restituisce il valore minimo di expr in un gruppo. |
| min_by(expr1, expr2) | Restituisce il valore di un expr1 associato al valore minimo di expr2 in un gruppo. |
| mode(expr [,deterministic]) | Restituisce il valore di NULL più frequente, non expr, in un gruppo. |
| percentile(esp, percentuale [,frequenza]) | Restituisce il valore esatto del percentile di expr all'percentage specificato. |
| percentile_approx(expr,percentage[,accuracy]) | Restituisce il percentile approssimativo di expr nel gruppo. |
| percentile_cont(pct) WITHIN GROUP (ORDER BY chiave) | Restituisce il percentile interpolato di key nel gruppo. |
| percentile_disc(pct) NEL GRUPPO (ORDER BY chiave) | Restituisce il percentile discreto di key nel gruppo. |
| regr_avgx(yExpr, xExpr) | Restituisce la media di xExpr calcolata dai valori di un gruppo in cui xExpr e yExpr sono NOT NULL. |
| regr_avgy(yExpr, xExpr) | Restituisce la media di yExpr calcolata dai valori di un gruppo in cui xExpr e yExpr sono NOT NULL. |
| regr_count(yExpr, xExpr) | Restituisce il numero di coppie di valori non nulli yExpr, xExpr nel gruppo. |
| regr_intercept(yExpr, xExpr) | Restituisce l'intercetta della retta di regressione lineare univariata in un gruppo in cui xExpr e yExpr non sono NULL. |
| regr_r2(yExpr, xExpr) | Restituisce il coefficiente di determinazione dai valori appartenenti a un gruppo in cui xExpr e yExpr sono NOT NULL. |
| regr_slope(yExpr, xExpr) | Restituisce la pendenza della linea di regressione lineare di coppie yExpr di valori non Null, xExpr nel gruppo. |
| regr_sxx(yExpr, xExpr) | Restituisce la somma dei quadrati dei valori xExpr di un gruppo in cui xExpr e yExpr non sono NULL. |
| regr_sxy(yExpr, xExpr) | Restituisce la somma dei prodotti di yExpr e xExpr calcolati dai valori di un gruppo in cui xExpr e yExpr sono NOT NULL. |
| regr_syy(yExpr, xExpr) | Restituisce la somma dei quadrati dei valori yExpr di un gruppo in cui xExpr e yExpr non sono NULL. |
| schema_of_json_agg(json[, options]) | Restituisce lo schema combinato delle stringhe JSON in un gruppo nel formato DDL. |
| schema_of_variant_agg(variantExpr) | Restituisce lo schema combinato di tutti i valori VARIANT in un gruppo in formato DDL. |
| skewness(expr) | Restituisce il valore di asimmetria calcolato dai valori di un gruppo. |
| some(expr) | Restituisce true se almeno un valore di expr in un gruppo è true. |
| std(expr) | Restituisce la deviazione standard del campione calcolata dai valori all'interno del gruppo. |
| stddev(expr) | Restituisce la deviazione standard del campione calcolata dai valori all'interno del gruppo. |
| stddev_pop(expr) | Restituisce la deviazione standard della popolazione calcolata dai valori di un gruppo. |
| stddev_samp(expr) | Restituisce la deviazione standard del campione calcolata dai valori di un gruppo. |
| string_agg(expr[,delim]) [NEL GRUPPO (ORDER BY key [,...])] | Restituisce un concatenato STRING o BINARY di tutti i valori nel gruppo expr, separati da delim. |
| sum(expr) | Restituisce la somma calcolata dai valori di un gruppo. |
| try_avg(expr) | Restituisce la media calcolata dai valori di un gruppo, NULL se è presente un overflow. |
| try_sum(expr) | Restituisce la somma calcolata dai valori di un gruppo, NULL se è presente un overflow. |
| var_pop(expr) | Restituisce la varianza della popolazione calcolata dai valori di un gruppo. |
| var_samp(expr) | Restituisce la varianza del campione calcolata dai valori di un gruppo. |
| variance(expr) | Restituisce la varianza del campione calcolata dai valori di un gruppo. |
Funzioni della finestra di classificazione
| Function | Description |
|---|---|
| dense_rank() | Restituisce il rango di un valore rispetto a tutti i valori nella partizione. |
| ntile(n) | Suddivide le righe per ogni window partition in n bucket che spaziano da 1 fino a un massimo di n. |
| percent_rank() | Calcola la classificazione percentuale di un valore all'interno della partizione. |
| rank() | Restituisce il rango di un valore rispetto a tutti i valori nella partizione. |
| row_number() | Assegna un numero univoco e sequenziale a ogni riga, a partire da uno, in base all'ordinamento delle righe all'interno della partizione della finestra. |
Funzioni della finestra analitica
| Function | Description |
|---|---|
| cume_dist() | Restituisce la posizione di un valore relativo a tutti i valori nella partizione. |
| lag(expr[,offset[,default]]) | Restituisce il valore di expr da una riga precedente all'interno della partizione. |
| lead(expr[,offset[,default]]) | Restituisce il valore di expr da una riga successiva all'interno della partizione. |
| nth_value(expr, offset[, ignoreNulls]) | Restituisce il valore di expr in corrispondenza di un offset specifico nella finestra. |
Funzioni di array
| Function | Description |
|---|---|
| arrayExpr[indexExpr] | Restituisce l'elemento nella posizione indexExpr di ARRAY arrayExpr. |
| aggregate(expr,start,merge[,finish]) | Aggrega gli elementi in una matrice usando un aggregatore personalizzato. |
| array([expr [, ...]]) | Restituisce una matrice con gli elementi in expr. |
| array_append(array, elem) | Restituisce array seguito da elem. |
| array_compact(array) | Rimuove i valori NULL da array. |
| array_contains(array,value) | Restituisce true se array contiene value. |
| array_distinct(array) | Rimuove i valori duplicati da array. |
| array_except(array1,array2) | Restituisce una matrice degli elementi in array1 ma non in array2. |
| array_insert(array, index, elem) | Restituisce un array espanso in cui elem viene inserito nella posizione index. |
| array_intersect(array1,array2) | Restituisce una matrice degli elementi nell'intersezione di array1 e array2. |
| array_join(array,delimiter[,nullReplacement]) | Concatena gli elementi di array. |
| array_max(array) | Restituisce il valore massimo in array. |
| array_min(array) | Restituisce il valore minimo in array. |
| array_position(array,element) | Restituisce la posizione della prima occorrenza di element in array. |
| array_prepend(array, elem) | Restituisce array preceduto da elem. |
| array_remove(array,element) | Rimuove tutte le occorrenze di element da array. |
| array_repeat(element,count) | Restituisce una matrice contenente le volte di elementcount. |
| array_size(array) | Restituisce il numero di elementi di array. |
| array_sort(array,func) | Restituisce array ordinato in base a func. |
| array_union(array1,array2) | Restituisce una matrice degli elementi nell'unione di array1 e array2 senza duplicati. |
| arrays_overlap(array1, array2) | Restituisce true se l'intersezione di array1 e array2 non è vuota. |
| arrays_zip(array1 [, ...]) | Restituisce una matrice unita di strutture in cui l'n-esimo struct contiene tutti i n-esimi valori delle matrici di input. |
| cardinality(expr) | Restituisce la dimensione di expr. |
| concat(expr1, expr2 [, ...]) | Restituisce la concatenazione degli argomenti. |
| element_at(arrayExpr, index) | Restituisce l’elemento di un arrayExpr a index. |
| exists(expr, pred) | Restituisce true se pred è true per qualsiasi elemento in expr. |
| explode(collection) | Restituisce le righe de-nidificando collection. |
| explode_outer(collection) | Restituisce le righe annullando l'annidamento di collection utilizzando la semantica esterna. |
| filter(expr,func) | Filtra la matrice in expr usando la funzione func. |
| flatten(arrayOfArrays) | Trasforma una matrice di matrici in una singola matrice. |
| forall(expr, predFunc) | Verifica se predFunc contiene tutti gli elementi nella matrice. |
| get(arrayExpr, index) | Restituisce l'elemento di un oggetto arrayExpr in index a partire da 0. |
| inline(input) | Esplode un array di strutture in una tabella. |
| inline_outer(input) | Esplode un array di strutture in una tabella con semantica esterna. |
| posexplode(collection) | Restituisce le righe espandendo l'array con numerazione delle posizioni. |
| posexplode_outer(collection) | Restituisce le righe desembricando l'array con la numerazione delle posizioni utilizzando la semantica di OUTER. |
| reduce(expr,start,merge[,finish]) | Aggrega gli elementi in una matrice usando un aggregatore personalizzato. |
| reverse(array) | Restituisce una stringa invertita o una matrice con ordine inverso di elementi. |
| sequence(start,stop,step) | Genera una matrice di elementi da start a stop (inclusivo), incrementando di step. |
| shuffle(array) | Restituisce una permutazione casuale della matrice in expr. |
| size(expr) | Restituisce la cardinalità di expr. |
| slice(expr,start,length) | Restituisce un subset di una matrice. |
| sort_array(expr[,ascendingOrder]) | Restituisce l'array in expr in modo ordinato. |
| transform(expr, func) | Trasforma gli elementi in una matrice in expr usando la funzione func. |
| try_element_at(arrayExpr, index) | Restituisce l'elemento di un arrayExpr in index, o NULL se index è fuori dai limiti. |
| zip_with(expr1, expr2, func) | Unisce le matrici in expr1 e expr2, a livello di elemento, in una singola matrice usando func. |
Funzioni di mappatura
| Function | Description |
|---|---|
| mapExpr[keyExpr] | Restituisce il valore alla posizione keyExpr di MAP mapExpr. |
| cardinality(expr) | Restituisce la dimensione di expr. |
| element_at(mapExpr, key) | Restituisce il valore di mapExpr per key. |
| explode(collection) | Restituisce le righe de-nidificando expr. |
| explode_outer(collection) | Restituisce le righe annullando l'annidamento di expr utilizzando la semantica esterna. |
| map([{key1, value1}[, ...]]) | Crea una mappa con le coppie chiave-valore specificate. |
| map_concat([expr1 [, ...]]) | Restituisce l'unione di tutte le espressioni della mappa expr. |
| map_contains_key(mappa, chiave) | Restituisce true se map contiene key, false in caso contrario. |
| map_entries(map) | Restituisce un array non ordinato di tutte le voci in map. |
| map_filter(expr, func) | Filtra le voci nella mappa in expr usando la funzione func. |
| map_from_arrays(chiavi, valori) | Crea una mappa con una coppia di array keys e values. |
| map_from_entries(expr) | Crea una mappa creata dalla matrice di voci specificata. |
| map_keys(map) | Restituisce una matrice non ordinata contenente le chiavi di map. |
| map_values(map) | Restituisce una matrice non ordinata contenente i valori di map. |
| map_zip_with(map1, map2, func) | Unisce map1 e map2 in una singola mappa. |
| size(expr) | Restituisce la cardinalità di expr. |
| str_to_map(expr[,pairDelim[,keyValueDelim]]) | Restituisce una mappa dopo la suddivisione expr in coppie chiave-valore usando delimitatori. |
| transform_keys(expr, func) | Trasforma le chiavi in una mappa in expr usando la funzione func. |
| transform_values(expr, func) | Trasforma i valori in una mappa in expr usando la funzione func. |
| try_element_at(mapExpr, key) | Restituisce il valore di mapExpr per key o NULL se key non esiste. |
Funzioni di data, marca temporale e intervallo
Per informazioni sui formati di data e ora, vedere Modelli Datetime.
| Function | Description |
|---|---|
| intervalExpr/divisore | Restituisce l'intervallo diviso per divisor. |
| - intervalExpr | Restituisce il valore negato di intervalExpr. |
| intervalExpr1 - intervalExpr2 | Restituisce la sottrazione di intervalExpr2 da intervalExpr1. |
| datetimeExpr1 - datetimeExpr2 | Restituisce la sottrazione di datetimeExpr2 da datetimeExpr1. |
| + intervalExpr | Restituisce il valore di intervalExpr. |
| intervalExpr1 + intervalExpr2 | Restituisce la somma di intervalExpr1 e intervalExpr2. |
| intervalExpr * multiplicand | Restituisce intervalExpr moltiplicato per multiplicand. |
| abs(expr) | Restituisce il valore assoluto del valore di intervallo in expr. |
| add_months(startDate,numMonths) | Restituisce la data che è numMonths successiva a startDate. |
| curdate() | Restituisce la data corrente al momento dell'inizio della valutazione della query. |
| current_date() | Restituisce la data corrente al momento dell'inizio della valutazione della query. |
| current_timestamp() | Restituisce il timestamp corrente all'inizio dell'elaborazione della query. |
| current_timezone() | Restituisce il fuso orario locale della sessione corrente. |
| date(expr) | Esegue il cast del valore expr a DATA. |
| date_add(startDate,numDays) | Restituisce la data numDays successiva a startDate. |
| date_add(unita, valore, espressione) | Aggiunge valueunits a una marca temporale expr. |
| date_diff(unità, inizio, fine) | Restituisce la differenza tra due timestamp misurati in units. |
| date_format(expr,fmt) | Converte un timestamp in una stringa nel formato fmt. |
| date_from_unix_date(days) | Crea una data dal numero di giorni trascorsi da 1970-01-01. |
| date_part(field,expr) | Estrae una parte di una data, marca temporale o intervallo. |
| date_sub(startDate,numDays) | Restituisce la data numDays precedente a startDate. |
| date_trunc(unit,expr) | Restituisce il timestamp troncato all'unità specificata in unit. |
| dateadd(startDate,numDays) | Restituisce la data numDays successiva a startDate. |
| dateadd(unità, valore, espressione) | Aggiunge valueunits a una marca temporale expr. |
| datediff(endDate,startDate) | Restituisce il numero di giorni da startDate a endDate. |
| datediff(unità, inizio, fine) | Restituisce la differenza tra due timestamp misurati in units. |
| day(expr) | Restituisce il giorno del mese della data o del timestamp. |
| dayname(expr) | Restituisce l'acronimo inglese di tre lettere per il giorno della settimana per la data specificata. |
| dayofmonth(expr) | Restituisce il giorno del mese della data o del timestamp. |
| dayofweek(expr) | Restituisce il giorno della settimana della data o della marca temporale. |
| dayofyear(expr) | Restituisce il giorno dell'anno della data o del timestamp. |
| divisore div dividendo | Restituisce la parte integrante della divisione dell'intervallo divisor in base all'intervallo dividend. |
| extract(field FROM source) | Restituisce field di source. |
| from_unixtime(unixTime,fmt) | Restituisce unixTime in fmt. |
| from_utc_timestamp(expr,timezone) | Restituisce il timestamp a UTC per un timestamp expr a timeZone. |
| getdate() | Restituisce il timestamp corrente all'inizio dell'elaborazione della query. |
| hour(expr) | Restituisce il componente ora di un timestamp. |
| last_day(expr) | Restituisce l'ultimo giorno del mese a cui appartiene la data. |
| make_date(year,month,day) | Crea una data dai campi year, month, e day. |
| make_dt_interval([giorni[, ore[, min[, sec]]]]) | Crea un intervallo di tempo di giorno da days, hours, mins e secs. |
| make_interval(anni, mesi, settimane, giorni, ore, minuti, secondi) | Obsoleto: crea un intervallo da years, months, weeks, days, hours, mins e secs. |
| make_timestamp(year,month,day,hour,min,sec[,timezone]) | Crea un timestamp dai campi year, month, day, hour, min, sec, e timezone. |
| make_ym_interval([years[, months]]) | Crea un intervallo di anno-mese da years e months. |
| minute(expr) | Restituisce il componente dei minuti del timestamp in expr. |
| month(expr) | Restituisce il componente mese di data e ora in expr. |
| months_between(expr1,expr2[,roundOff]) | Restituisce il numero di mesi trascorsi tra date o date e ora in expr1 e expr2. |
| next_day(expr,dayOfWeek) | Restituisce la prima data successiva a expr e denominata come indicato in dayOfWeek. |
| now() | Restituisce il timestamp corrente all'inizio dell'elaborazione della query. |
| quarter(expr) | Restituisce il trimestre dell'anno per expr nell'intervallo compreso tra 1 e 4. |
| second(expr) | Restituisce il secondo componente del timestamp in expr. |
| session_window(expr, gpDuration) | Crea una finestra di sessione su un'espressione timestamp. |
| sign(expr) | Restituisce -1,0, 0,0 o 1,0 perché l’intervallo expr è negativo, 0 o positivo. |
| signum(expr) | Restituisce -1,0, 0,0 o 1,0 perché l’intervallo expr è negativo, 0 o positivo. |
| `timediff(unità, inizio, fine)` | Restituisce la differenza tra due timestamp misurati in units. |
| timestamp(expr) | Converte expr in TIMESTAMP. |
| timestamp_micros(expr) | Crea un timestamp di expr microsecondi dall'epoca UTC. |
| timestamp_millis(expr) | Crea un timestamp di expr millisecondi a partire dall'epoca UTC. |
| timestamp_seconds(expr) | Crea il timestamp expr secondi dall'epoca di riferimento UTC. |
| timestampadd(unit, value, expr) | Aggiunge valueunits a una marca temporale expr. |
| timestampdiff(unita, inizio, fine) | Restituisce la differenza tra due timestamp misurati in units. |
| to_date(expr[,fmt]) | Restituisce expr impostato si una data usando una formattazione opzionale. |
| to_timestamp(expr[,fmt]) | Restituisce expr impostato su un timestamp usando una formattazione opzionale. |
| to_unix_timestamp(expr[,fmt]) | Restituisce il timestamp in expr in formato UNIX. |
| to_utc_timestamp(expr,timezone) | Restituisce il timestamp a UTC per un timestamp expr a timezone. |
| trunc(expr, fmt) | Restituisce una data con una porzione della data troncata all'unità specificata dal modello di formato fmt. |
| try_add(expr1, expr2) | Restituisce la somma di expr1 e expr2 o NULL in caso di errore. |
| try_divide(dividend, divisore) | Restituisce dividend diviso per divisor o NULL se divisor è 0. |
| try_multiply(moltiplicatore, moltiplicatore) | Restituisce multiplier moltiplicato per multiplicand o NULL in caso di overflow. |
| try_subtract(expr1, expr2) | Restituisce la sottrazione di expr2 da expr1 o NULL in caso di overflow. |
| try_to_timestamp(expr[,fmt]) | Restituisce expr convertito in un timestamp usando una formattazione opzionale, o NULL se la conversione fallisce. |
| unix_date(expr) | Restituisce il numero di giorni trascorsi da 1970-01-01. |
| unix_micros(expr) | Restituisce il numero di microsecondi trascorsi da 1970-01-01 00:00:00 UTC. |
| unix_millis(expr) | Restituisce il numero di millisecondi trascorsi da 1970-01-01 00:00:00 UTC. |
| unix_seconds(expr) | Restituisce il numero di secondi trascorsi da 1970-01-01 00:00:00 UTC. |
| unix_timestamp([expr[, fmt]]) | Restituisce il timestamp UNIX dell'ora corrente o specificata. |
| weekday(expr) | Restituisce il giorno della settimana di expr. |
| weekofyear(expr) | Restituisce la settimana dell’anno di expr. |
| year(expr) | Restituisce il componente anno di expr. |
| finestra(expr, larghezza[, passo[, inizio]]) | Crea una finestra temporale scorrevole basata su intervalli di salto su un'espressione di timestamp. |
| window_time(window) | Restituisce l'ora di fine inclusiva di una finestra scorrevole prodotta dalle funzioni finestra o session_window . |
Funzioni geospaziali H3
Per informazioni sulle funzioni geospaziali H3, vedere Funzioni geospaziali H3.
Funzioni geospaziali ST
Per informazioni sulle funzioni geospaziali ST, vedere Funzioni geospaziali ST.
Funzioni e costruttori di cast
Per informazioni sulla conversione di tipo, vedere cast funzione e try_cast funzione.
| Function | Description |
|---|---|
| array([expr [, ...]]) | Restituisce una matrice con gli elementi in expr. |
| bigint(expr) | Converte il valore expr in BIGINT. |
| binary(expr) | Converte il valore di expr in BINARY. |
| boolean(expr) | Converte expr in BOOLEAN. |
| cast(expr AS tipo) | Esegue il cast del valore expr al tipo di dati di destinazione type. |
| expr :: type | Esegue il cast del valore expr al tipo di dati di destinazione type. |
| date(expr) | Converte il valore expr in DATE. |
| decimal(expr) | Converte il valore expr in DECIMAL. |
| double(expr) | Converte il valore expr in DOUBLE. |
| float(expr) | Converte il valore expr in FLOAT. |
| int(expr) | Converte il valore expr in INTEGER. |
| make_date(year,month,day) | Crea una data dai campi year, month, e day. |
| make_dt_interval([giorni[, ore[, min[, sec]]]]) | Crea un intervallo di tempo di giorno da days, hours, mins e secs. |
| make_interval(anni, mesi, settimane, giorni, ore, minuti, secondi) | Crea un intervallo da years, months, weeks, days, hours, mins e secs. |
| make_timestamp(year,month,day,hour,min,sec[,timezone]) | Crea un timestamp dai campi year, month, day, hour, min, sec, e timezone. |
| make_ym_interval([years[, months]]) | Crea un intervallo di anno-mese da years e months. |
| map([{key1, value1} [, ...]]) | Crea una mappa con le coppie chiave-valore specificate. |
| named_struct({name1, val1} [, ...]) | Crea uno struct con i nomi e i valori di campo specificati. |
| smallint(expr) | Converte il valore expr in SMALLINT. |
| string(expr) | Converte il valore expr in STRING. |
| struct(expr1 [, ...]) | Crea un STRUCT con i valori di campo specificati. |
| tinyint(expr) | Converte expr in TINYINT. |
| timestamp(expr) | Converte expr in TIMESTAMP. |
| to_char(expr, fmt) | Restituisce expr convertito in STRING usando la formattazione fmt. |
| to_date(expr[,fmt]) | Restituisce expr impostato si una data usando una formattazione opzionale. |
| to_number(expr, fmt) | Restituisce expr convertito a DECIMAL usando la formattazione fmt. |
| to_timestamp(expr[,fmt]) | Restituisce expr impostato su un timestamp usando una formattazione opzionale. |
| to_varchar(expr, fmt) | Restituisce expr convertito in STRING usando la formattazione fmt. |
| try_cast(expr AS tipo) | Converte il valore expr al tipo di dati di destinazione type in modo sicuro. |
| try_to_number(expr, fmt) | Restituisce expr convertito in DECIMAL usando la formattazione fmt, o NULL se expr non è valido. |
Funzioni CSV e Avro
| Function | Description |
|---|---|
| from_avro(avroBin, jsonSchema[, options]) | Restituisce un valore di struct basato su avroBin e jsonSchema. |
| from_csv(csvStr, schema[, opzioni]) | Restituisce un valore struct con csvStr e schema. |
| schema_of_csv(csv[, opzioni]) | Restituisce lo schema di una stringa CSV in formato DDL. |
| to_avro(expr[, options]) | Restituisce un valore binario Avro con il valore della struttura specificata. |
| to_csv(expr[, options]) | Restituisce una stringa CSV con il valore struct specificato. |
Funzioni JSON
| Function | Description |
|---|---|
| jsonStr: jsonPath | Restituisce i campi estratti da jsonStr. |
| from_json(jsonStr, schema[, options]) | Restituisce un valore struct con jsonStr e schema. |
| get_json_object(expr, path) | Estrae un oggetto JSON da path. |
| json_array_length(jsonArray) | Restituisce il numero di elementi nella matrice JSON più esterna. |
| json_object_keys(jsonObject) | Restituisce tutte le chiavi dell'oggetto più esterno JSON come matrice. |
| json_tuple(jsonStr, path1 [, ...]) | Restituisce più oggetti JSON come tupla. |
| parse_json(jsonStr) | Restituisce un valore VARIANT da jsonStr. |
| schema_of_json(jsonStr[, options]) | Restituisce lo schema di una stringa JSON in formato DDL. |
| schema_of_json_agg(jsonStr[, opzioni]) | Restituisce lo schema combinato delle stringhe JSON in un gruppo nel formato DDL. |
| to_json(expr[, options]) | Restituisce una stringa JSON con STRUCT o VARIANT specificata in expr. |
Funzioni VARIANT
| Function | Description |
|---|---|
| variantExpr : jsonPath | Restituisce i campi estratti da variantExpr usando il percorso JSON. |
| is_variant_null(variantExpr) | Verifica se variantExpr è un VARIANT con codifica NULL. |
| parse_json(jsonStr) | Restituisce un valore VARIANT da jsonStr. |
| schema_of_variant(variantExpr) | Restituisce lo schema di un'espressione VARIANT in formato DDL. |
| schema_of_variant_agg(variantExpr) | Restituisce lo schema combinato di tutti i valori VARIANT in un gruppo in formato DDL. |
| to_json(expr[, options]) | Restituisce una stringa JSON con STRUCT o VARIANT specificata in expr. |
| try_parse_json(jsonStr) | Restituisce un valore VARIANT da jsonStr, se possibile. Se non è possibile, NULL viene restituito . |
| try_variant_get(variantExpr,path,type) | Estrae un valore di tipo type da variantExpr, specificato da path o NULL se non è possibile eseguire il cast al tipo di destinazione. |
| variant_explode(input) | Restituisce un set di righe disannidando input. |
| variant_explode_outer(input) | Restituisce un set di righe eliminando l'annidamento di input utilizzando semantiche esterne. |
| variant_get(variantExpr,path,type) | Estrae un valore di tipo type da variantExpr, specificato da path. |
Funzioni XPath e XML
| Function | Description |
|---|---|
| from_xml(xmlStr, schema[, opzioni]) | Restituisce un valore struct analizzato da xmlStr utilizzando schema. |
| schema_of_xml(xmlStr[, options]) | Restituisce lo schema di una stringa XML in formato DDL. |
| xpath(xml, xpath) | Restituisce valori all'interno dei nodi di xml che corrispondono xpath. |
| xpath_boolean(xml, xpath) | Restituisce true se l'espressione xpath restituisce true o se viene trovato un nodo corrispondente in xml . |
| xpath_double(xml, xpath) | Restituisce un valore DOUBLE da un documento XML. |
| xpath_float(xml, xpath) | Restituisce un valore FLOAT da un documento XML. |
| xpath_int(xml, xpath) | Restituisce un valore INTEGER da un documento XML. |
| xpath_long(xml, xpath) | Restituisce un valore BIGINT da un documento XML. |
| xpath_number(xml, xpath) | Restituisce un valore DOUBLE da un documento XML. |
| xpath_short(xml, xpath) | Restituisce un valore SHORT da un documento XML. |
| xpath_string(xml, xpath) | Restituisce il contenuto del primo nodo XML corrispondente all'espressione XPath. |
Funzioni di intelligenza artificiale
| Function | Description |
|---|---|
| ai_analyze_sentiment(content) | Restituisce il sentiment di un testo. |
| ai_classify(contenuto, etichette) | Classifica il contenuto fornito in una delle etichette fornite. |
| ai_extract(content, labels) | Estrae le entità specificate dalle etichette da un determinato testo. |
| ai_fix_grammar(content) | Corregge gli errori grammaticali in un determinato testo. |
| ai_forecast(osservato, colonna_tempo) | Estrapola i dati delle serie temporali nel futuro. |
| ai_gen(content) | Richiama un modello di intelligenza artificiale generativa all'avanguardia dalle API del modello di Databricks Foundation per rispondere alla richiesta fornita dall'utente. |
| ai_generate_text(prompt, modelName[, param1, value1] [...]) | Deprecato: restituisce il testo generato da un modello LLM (Large Language Model) selezionato in base al prompt. |
| ai_mask(content, labels) | Maschera le entità specificate all'interno di un determinato testo. |
| ai_query(endpointName, request, returnType) | Richiama un endpoint di gestione del modello di intelligenza artificiale mosaico esistente e analizza e restituisce la risposta. |
| ai_similarity(strExpr1, strExpr2) | Confronta due stringhe e calcola il punteggio di somiglianza semantica. |
| ai_summarize(content[, max_words]) | Genera un riepilogo di un determinato testo. |
| ai_translate(content, to_lang) | Converte il testo in una lingua di destinazione specificata. |
| vector_search(index, query, num_results) | Eseguire una query su un indice di Ricerca vettoriale di Mosaic AI usando SQL. |
Leggere le funzioni
| Function | Description |
|---|---|
| read_files(path, [optionKey => optionValue] [, ...]) | Legge i file di dati nell'archiviazione cloud e lo restituisce in formato tabulare. |
| read_kafka([optionKey => optionValue] [, ...]) | Legge i record da un cluster Apache Kafka e lo restituisce in formato tabulare. |
| read_kinesis({parameter => value} [, ...]) | Restituisce una tabella con i record letti da Kinesis da uno o più flussi. |
| read_pubsub([parameter => value] [, ...]) | Funzione con valori di tabella per la lettura di record da Pub/Sub da un argomento. |
| read_pulsar({optionKey => optionValue} [, ...]) | Restituisce una tabella con i record registrati letti da Pulsar. |
| read_state_metadata(path) | Restituisce una tabella con righe che rappresentano i metadati di uno stato di query di streaming. |
| read_statestore(path [, option_key => option_value] [...]) | Restituisce i record dalla memoria di stato delle query di streaming. |
| remote_query(connectionName [, connectorOptionKey => connectorOptionValue] [...]) | Restituisce il risultato tabulare della query eseguita nel motore di database remoto. |
Funzioni varie
| Function | Description |
|---|---|
| assert_true(expr) | Restituisce un errore se expr non è true. |
| CASE expr { WHEN opt1 THEN res1 } [...] [ELSE def] FINE | Restituisce resN per il primo optN uguale a expr o def se nessuno corrisponde. |
| CASE { WHEN cond1 THEN res1 } [...] [ELSE def] FINE | Restituisce resN per il primo condN che restituisce true o def se non viene trovato alcun valore. |
| cloud_files_state( { TABLE(tabella) | checkpoint } ) | Restituisce lo stato del file di una sorgente di un autoloader cloud_files. |
| coalesce(expr1, expr2 [, ...]) | Restituisce il primo argomento non Null. |
| collations() | Restituisce l'elenco delle regole di confronto disponibili. |
| cubo (expr1 [, ...]) | Crea un cubo multidimensionale utilizzando le colonne di espressione specificate. |
| current_catalog() | Restituisce il catalogo corrente. |
| current_database() | Restituisce lo schema corrente. |
| current_metastore() | Restituisce l'ID metastore del catalogo Unity corrente. |
| current_recipient(key) | Restituisce una proprietà per il destinatario corrente in una visualizzazione condivisa con condivisione Delta. |
| current_schema() | Restituisce lo schema corrente. |
| current_user() | Restituisce l'utente che esegue l'istruzione. |
| current_version() | Restituisce la versione corrente di Azure Databricks. |
| decode(expr, { key, value } [, ...] [,defValue]) | Restituisce il valore corrispondente alla chiave. |
| elt(index, expr1 [, ...] ) | Restituisce l'en-nesima espressione. |
| equal_null(expr1, expr2) | Restituisce true se expr1 è uguale a expr2 o entrambe le espressioni sono NULL, o false in caso contrario. |
| event_log( { TABLE(tabella) | pipeline_id } ) | Restituisce una tabella della cronologia degli aggiornamenti per una vista materializzata, una tabella di streaming o una pipeline. |
| greatest(expr1, expr2 [, ...]) | Restituisce il valore più grande di tutti gli argomenti, ignorando i valori Null. |
| grouping(col) | Indica se una colonna specificata in un GROUPING SET, ROLLUPo CUBE rappresenta un subtotale. |
| grouping_id([col1 [, ...]]) | Restituisce il livello di raggruppamento per un set di colonne. |
| hash(expr1 [, ...]) | Restituisce un valore elaborato tramite hash degli argomenti. |
| hll_sketch_estimate(expr) | Stima il numero di valori distinti raccolti in uno schizzo HyperLogLog. |
| hll_union(expr1, expr2 [,allowDifferentLgConfigK]) | Combina due schizzi HyperLogLog. |
| http_request({parm => expr} [, ...]) | Effettua una richiesta HTTP usando una connessione HTTP definita. |
| java_method(classe, metodo[, arg1 [,...]]) | Richiama un metodo con riflessione. |
| if(cond, expr1, expr2) | Restituisce expr1 se cond è true o expr2 in caso contrario. |
| iff(cond, expr1, expr2) | Restituisce expr1 se cond è true o expr2 in caso contrario. |
| ifnull(expr1, expr2) | Restituisce expr2 se expr1 è NULL o expr1 in caso contrario. |
| input_file_block_length() | Restituisce la lunghezza in byte del blocco letto. |
| input_file_block_start() | Restituisce l'offset iniziale in byte del blocco letto. |
| input_file_name() | Restituisce il nome del file letto o una stringa vuota, se non disponibile. |
| is_account_group_member(group) | Restituisce vero se l'utente corrente è un membro del gruppo a livello di account. |
| is_member(group) | Restituisce vero se l'utente corrente è un membro del gruppo a livello di area di lavoro. |
| isnull(expr) | Restituisce true se expr è NULL. |
| isnotnull(expr) | Restituisce true se expr non è NULL. |
| least(expr1, expr2 [, ...]) | Restituisce il valore più piccolo di tutti gli argomenti, ignorando i valori Null. |
| list_secrets([scopeStr]) | Restituisce le chiavi negli ambiti in cui l'utente è autorizzato a visualizzarli dal servizio segreto di Databricks. |
| luhn_check(numStr) | Restituisce true se numStr supera il controllo dell'algoritmo Luhn . |
| monotonically_increasing_id() | Restituisce numeri interi a 64 bit che aumentano in modo monotonico. |
| nullif(expr1, expr2) | Restituisce NULL se expr1 è uguale a expr2 o expr1 in caso contrario. |
| nvl(expr1, expr2) | Restituisce expr2 se expr1 è NULL o expr1 in caso contrario. |
| nvl2(expr1, expr2, expr3) | Restituisce expr2 se expr1 non è NULL o expr3 in caso contrario. |
| raise_error(expr) | Genera un'eccezione con expr come messaggio. |
| range(end) | Restituisce una tabella di valori all'interno di un intervallo specificato. |
| range(start, end [, step [, numParts]]) | Restituisce una tabella di valori all'interno di un intervallo specificato. |
| reflect(class, method[, arg1 [, ...]]) | Richiama un metodo con riflessione. |
| secret(scope, key) | Estrae un valore segreto con il scope specificato e key dal servizio segreto Databricks. |
| session_user() | Restituisce l'utente connesso ad Azure Databricks. |
| spark_partition_id() | Restituisce l'ID partizione corrente. |
| sql_keywords() | Restituisce il set di parole chiave SQL in Azure Databricks. |
| stack(numRows, expr1 [, ...]) | Separa expr1, ..., exprN in numRows righe. |
| table_changes(table_str, start [, end]) | Restituisce un log delle modifiche apportate a una tabella Delta Lake con feed di dati delle modifiche abilitato. |
| try_reflect(class, method[, arg1 [, ...]]) | Chiama un metodo con riflessione, restituendo NULL se il metodo ha esito negativo. |
| try_secret(ambito, chiave) | Estrae un valore segreto con i dati specificati scope e key dal servizio segreto Databricks, oppure NULL se la chiave non può essere recuperata. |
| typeof(expr) | Restituisce una stringa di tipo DDL formattata per il tipo di dati di expr. |
| user() | Restituisce l'utente che esegue l'istruzione. |
| uuid() | Restituisce una stringa UUID (Universally Unique Identifier). |
| window(expr, width[, step [, start]]) | Crea una finestra temporale scorrevole basata su intervalli di salto su un'espressione di timestamp. |
| xxhash64(expr1 [, ...]) | Restituisce un valore con hash a 64 bit degli argomenti. |
| version() | Restituisce la versione di Apache Spark. |