Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Databricks SQL
Databricks Runtime
Cet article présente des liens vers des opérateurs intégrés et leurs descriptions, et des fonctions pour les types chaînes et binaires, scalaires numériques, agrégations, fenêtres, tableaux , mappages, dates et timestamps, cast, données CSV, données JSON, manipulation XPath et d’autres fonctions diverses.
Pour les cas d’usage qui ne sont pas pris en charge par les fonctions intégrées existantes, envisagez de définir une fonction personnalisée. Consultez Que sont les fonctions définies par l’utilisateur (UDF) ?.
Voir aussi :
Opérateurs et prédicats
Pour plus d’informations sur la façon dont les opérateurs sont analysés les uns par rapport aux autres, consultez Priorité des opérateurs.
Opérateur | Syntaxe | Descriptif |
---|---|---|
& | expr1 & expr2 |
Retourne l’opération au niveau du bit AND de expr1 et expr2 . |
et | expr1 and expr2 |
Retourne le AND logique de expr1 et expr2 . |
* | multiplier * multiplicand |
Retourne multiplier multiplié par multiplicand . |
!= | expr1 != expr2 |
Retourne la valeur true si expr1 n’est pas égal à expr2 , sinon false . |
! | !expr |
Retourne le NOT logique d’une expression booléenne. |
entre | expr1 [not] between expr2 and expr2 |
Vérifie si la valeur de expr1 est supérieure ou égale à celle de expr2 et inférieure ou égale à celle de expr3 . |
[] | arrayExpr [ indexExpr ] |
Retourne le indexExpr ème élément de ARRAY arrayExpr . |
[] | mapExpr [ keyExpr ] |
Retourne la valeur à keyExpr de MAP mapExpr . |
^ | expr1 ^ expr2 |
Retourne l’opération exclusive au niveau du bit OR (XOR) de expr1 et expr2 . |
: | jsonStr : jsonPath |
Retourne les champs extraits du jsonStr . |
:: | expr :: type |
Convertit la valeur expr dans le type de données cible type . |
?:: | expr ?:: type |
Convertit la valeur expr en type de données cible type si possible, retourne NULL dans le cas contraire. |
Div | dividend div divisor |
Retourne la partie entière de la division de dividend par divisor . |
. | mapExpr . keyIdentifier |
Renvoie une valeur MAP par keyIdentifier . |
. | structExpr . fieldIdentifier |
Retourne un champ STRUCT par fieldIdentifier . |
== | expr1 == expr2 |
Retourne true si expr1 est égal à expr2 , sinon false . |
= | expr1 = expr2 |
Retourne true si expr1 est égal à expr2 , sinon false . |
>= | expr1 >= expr2 |
Retourne true si la valeur de expr1 est supérieure ou égale à celle de expr2 , sinon false . |
> | expr1 > expr2 |
Retourne true si la valeur de expr1 est supérieure à celle de expr2 , sinon false . |
existe | exists(query) |
Retourne la valeur true si query retourne au moins une ligne, sinon false. |
ilike | str [not] ilike (pattern[ESCAPE escape]) |
Retourne true si str (ne) correspond (pas) à pattern avec escape sans respect de la casse. |
ilike | str [not] ilike {ANY\|SOME\|ALL}([pattern[, ...]]) |
Retourne true si str (ne) correspond (pas) à tout ou partie des modèles sans respect de la casse. |
dans | elem [not] in (expr1[, ...]) |
Retourne true si elem est égal (n’est pas égal) à un exprN . |
dans | elem [not] in (query) |
Retourne true si elem est (n’est pas) égal à l'une des lignes de query . |
est distinct | expr1 is [not] distinct from expr2 |
Vérifie si les arguments ont (n’ont pas) des valeurs différentes pour lesquelles les valeurs NULL sont considérées comme des valeurs comparables. |
est faux | expr is [not] false |
Vérifie si expr est (n’est pas) false . |
a la valeur Null | expr is [not] null |
Retourne true si expr n’a pas la valeur NULL . |
est vrai | expr is [not] true |
Vérifie si expr est (n’est pas) true . |
comme | str [not] like (pattern[ESCAPE escape]) |
Retourne true si str (ne) correspond (pas) à pattern avec escape . |
comme | str [not] like {ANY\|SOME\|ALL}([pattern[, ...]]) |
Retourne true si str (ne) correspond (pas) à tout ou partie des modèles. |
<=> | expr1 <=> expr2 |
Retourne le même résultat que EQUAL(=) pour les opérandes non Null, mais true si les deux sont NULL et false si l’un d’eux est NULL . |
<= | expr1 <= expr2 |
Retourne true si expr1 est inférieur ou égal à expr2 , sinon false . |
<> | expr1 <> expr2 |
Retourne true si expr1 n’est pas égal à expr2 , false sinon. |
< | expr1 < expr2 |
Renvoie true si expr1 est inférieur expr2 , ou false sinon. |
- | expr1 - expr2 |
Retourne la soustraction de expr2 à partir de expr1 . |
pas | not expr |
Retourne le NOT logique d’une expression booléenne. |
ou | expr1 or expr2 |
Retourne le OR logique de expr1 et expr2 . |
% | dividend % divisor |
Retourne le reste après dividend / divisor . |
|| | expr1 \|\| expr2 |
Retourne la concaténation de expr1 et de expr2 . |
| | expr1 \| expr2 |
Retourne l’opération au niveau du bit OR de expr1 et expr2 . |
+ | expr1 + expr2 |
Retourne la somme des valeurs expr1 et expr2 . |
regexp | str [not] regexp regex |
Retourne true si str (ne) correspond (pas) à regex . |
regexp_like | str [not] regexp_like regex |
Retourne true si str (ne) correspond (pas) à regex . |
rlike | str [not] rlike regex |
Retourne true si str (ne) correspond (pas) à regex . |
/ | dividend / divisor |
Retourne dividend divisé par divisor . |
~ | ~ expr |
Retourne le bit à bit NOT de expr . |
Précédence des opérateurs
Priorité | Opérateur |
---|---|
1 |
:
::
?::
[ ]
|
2 |
- (unaire), + (unaire), ~ |
3 |
*
/
%
div
|
4 |
+ , , - \|\| |
5 | & |
6 | ^ |
7 | \| |
8 |
= , == , , <> <=> , != , < , <= , > ,>= |
9 |
not , exists |
10 |
between , in , , regexp rlike , ilike , like , , is [not] [NULL, true, false] ,is [not] distinct from |
11 | and |
12 | or |
Fonctions de chaînes et binaires
Fonction | Descriptif |
---|---|
expr1 || expr2 | Retourne la concaténation de expr1 et de expr2 . |
aes_decrypt(expr, key[, mode[, padding[, aad]]]) - Fonction de décryptage qui utilise l'algorithme AES avec les paramètres indicatifs comme expr, clé, mode, remplissage et aad. | Déchiffre un binaire expr avec le chiffrement AES. |
aes_encrypt(expr, key[, mode[, padding[, iv[, aad]]]]) | Chiffre un binaire expr avec le chiffrement AES. |
ascii(str) | Retourne le point de code ASCII du premier caractère de str . |
base64(expr) | Convertit expr en une chaîne base 64. |
bin(expr) | Retourne la représentation binaire de expr . |
binary(expr) | Convertit la valeur de expr en BINARY . |
bit_length(expr) | Retourne la longueur en bits de données de type chaîne ou le nombre de bits de données binaires. |
bitmap_count(expr) | Renvoie le nombre de bits définis dans une chaîne BINARY représentant un bitmap. |
btrim(str [, trimStr]) | Retourne str en supprimant les caractères de début et de fin. |
char(expr) | Retourne le caractère correspondant au point de code UTF-16 fourni. |
char_length(expr) | Retourne la longueur en nombre de caractères de données de type chaîne, ou en nombre d’octets de données binaires. |
longueur_caractère(expr) | Retourne la longueur en nombre de caractères de données de type chaîne, ou en nombre d’octets de données binaires. |
charindex(substr, str[, pos]) | Retourne la position de la première occurrence de substr dans str après la position pos . |
chr(expr) | Retourne le caractère correspondant au point de code UTF-16 fourni. |
strExpr collate collationName | Associe une collation explicite collationName à strExpr . |
classement [pour] (strExpr) | Retourne le classement attaché à strExpr . |
concat(expr1, expr2[, ...]) | Retourne la concaténation des arguments. |
concat_ws(sep[, expr1[, ...]]) | Retourne les chaînes de concaténation séparées par sep . |
contains(expr, subExpr) | Retourne true si expr STRING ou BINARY contient subExpr . |
crc32(expr) | Retourne une valeur de vérification de redondance cyclique de expr . |
decode(expr, charSet) | Traduit la donnée binaire expr en une chaîne de caractères en utilisant l'encodage du jeu de caractères charSet . |
encode(expr, charSet) | Retourne la représentation binaire d’une chaîne à l’aide du codage de caractères charSet . |
endswith(expr, endExpr) | Retourne true si expr STRING ou BINARY se termine par endExpr . |
trouver_dans_ensemble(searchExpr, sourceExpr) | Retourne la position d’une chaîne au sein d’une liste de chaînes séparées par des virgules. |
format_number(expr, scale) | Met en forme expr comme #,###,###.## , arrondi à scale décimales. |
format_number(expr, fmt) | Met en forme expr comme fmt . |
format_string(strfmt[, obj1 [, ...]]) | Retourne une chaîne mise en forme à partir de chaînes au format printf-style. |
hex(expr) | Convertit expr au format hexadécimal. |
str ilike (pattern[ESCAPE escape]) | Retourne la valeur true si str correspond à pattern avec escape sans respect de la casse. |
initcap(expr) | Retourne expr avec la première lettre de chaque mot en majuscules. |
instr(str, substr) | Retourne l’index (base 1) de la première occurrence de substr dans str . |
lcase(expr) | Retourne expr avec tous les caractères convertis en minuscules. |
left(str, len) | Retourne les len caractères les plus à gauche dans str . |
len(expr) | Retourne la longueur en nombre de caractères de données de type chaîne, ou en nombre d’octets de données binaires. |
longueur(expr) | Retourne la longueur en nombre de caractères de données de type chaîne, ou en nombre d’octets de données binaires. |
levenshtein(str1, str2) | Retourne la distance Levenshtein entre les chaînes str1 et str2 . |
str like (pattern[ESCAPE escape]) | Retourne la valeur true si str correspond à pattern avec escape . |
locate(substr, str[, pos]) | Retourne la position de la première occurrence de substr dans str après la position pos . |
lower(expr) | Retourne expr avec tous les caractères convertis en minuscules. |
lpad(expr, len[, pad]) | Retourne expr , complété à gauche avec pad jusqu’à la longueur len . |
ltrim([trimstr,] str) | Retourne str en supprimant les caractères de début dans trimStr . |
mask(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]]) | Retourne une version masquée de l’entrée str . |
md5(expr) | Retourne une somme de contrôle MD5 128 bits de expr sous forme de chaîne hexadécimale. |
octet_length(expr) | Retourne la longueur en octets des données de chaîne ou le nombre d’octets de données binaires. |
superposition(input PLACING replace FROM pos [FOR len]) | Remplace input par replace qui commence à pos et dont la longueur est égale à len . |
superposition(input PLACING replace FROM pos [FOR len]) | Remplace input par replace qui commence à pos et dont la longueur est égale à len . |
parse_url(url, partToExtract[, clé]) | Extrait une partie de url . |
position(substr, str[, pos]) | Retourne la position de la première occurrence de substr dans str après la position pos . |
position(sous-tr IN str) | Retourne la position de la première occurrence de substr dans str après la position pos . |
printf(strfmt[, obj1 [, ...]]) | Retourne une chaîne mise en forme à partir de chaînes au format printf-style. |
randstr(length) | Retourne une chaîne aléatoire de caractères alphanumériques length . |
str regexp regex | Retourne la valeur true si str correspond à regex . |
str regexp_like regex | Retourne la valeur true si str correspond à regex . |
regexp_count(str, regexp) | Retourne le nombre de fois où str correspond au modèle regexp . |
regexp_extract(str, regexp[, idx]) | Extrait la première chaîne dans str qui correspond à l’expression regexp et à l’index de groupe regex . |
regexp_extract_all(str, regexp[, idx]) | Extrait toutes les chaînes dans str qui correspondent à l’expression regexp et correspond à l’index de groupe regex . |
regexp_instr(str, regexp) | Retourne la position de la première sous-chaîne de str qui correspond à regexp . |
regexp_replace(str, regexp, rep[, position]) | Remplace toutes les sous-chaînes de str qui correspondent à regexp par rep . |
regexp_substr(str, regexp) | Retourne la première sous-chaîne de str qui correspond à regexp . |
repeat(expr, n) | Retourne la chaîne qui répète expr n fois. |
remplacer(str, rechercher [, remplacer]) | Remplace toutes les occurrences de search par replace . |
reverse(expr) | Retourne une chaîne inversée ou un tableau avec l’ordre inverse des éléments. |
right(str, len) | Retourne les len caractères les plus à droite de la chaîne str . |
str rlike regex | Retourne la valeur true si str correspond à regex . |
rpad(expr, len[, pad]) | Retourne expr , complété à droite avec pad jusqu’à une longueur de len . |
rtrim([trimStr,] str) | Retourne str en supprimant les caractères de fin. |
sentences(str[, lang, country]) | Fractionne str en un tableau de mots. |
sha(expr) | Retourne une valeur de hachage sha1 sous la forme d’une chaîne hexadécimale de expr . |
sha1(expr) | Retourne une valeur de hachage sha1 sous la forme d’une chaîne hexadécimale de expr . |
sha2(expr, bitLength) | Retourne une somme de contrôle de la famille SHA-2 sous la forme d'une chaîne hexadécimale de expr . |
soundex(expr) | Retourne le code soundex de la chaîne. |
space(n) | Retourne une chaîne comprenant n espaces. |
split(str, regex[, limit]) | Fractionne str autour d’occurrences correspondant à regex , et retourne un tableau d’une longueur maximale de limit . |
split_part(str, delim, partNum) | Fractionne str autour des occurrences de delim et retourne la partie partNum . |
startswith(expr, startExpr) | Retourne true si expr STRING ou BINARY commence par startExpr . |
string(expr) | Convertit la valeur expr en STRING . |
substr(expr, pos[, len]) | Retourne la sous-chaîne de expr qui commence à pos et dont la longueur est égale à len . |
substr(expr FROM pos[ FOR len]) | Retourne la sous-chaîne de expr qui commence à pos et dont la longueur est égale à len . |
substring(expr, pos[, len]) | Retourne la sous-chaîne de expr qui commence à pos et dont la longueur est égale à len . |
substring(expr FROM pos[ FOR len]) | Retourne la sous-chaîne de expr qui commence à pos et dont la longueur est égale à len . |
substring_index(expr, delim, count) | Retourne la sous-chaîne de expr située avant count occurrences du délimiteur delim . |
to_binary(expr[, fmt]) | Retourne un cast expr vers un binaire basé sur fmt . |
to_char(numExpr, fmt) | Retourne le cast numExpr sur STRING en utilisant le formatage fmt .” |
to_varchar(numExpr, fmt) | Retourne le cast numExpr sur STRING en utilisant le formatage fmt .” |
traduire(expr, de, vers) | Retourne une expr où tous les caractères figurant dans from ont été remplacés par ceux figurant dans to . |
trim([[BOTH | LEADING | TRAILING] [trimStr] FROM] str) | Supprime des caractères d’une chaîne. |
try_aes_decrypt(expr, key[, mode[, padding[, aad]]]) | Déchiffre un fichier binaire expr à l’aide du chiffrement AES et retourne NULL en cas d’erreur. |
essayer_en_binaire(expr [, fmt]) | Retourne expr converti en BINARY en fonction de fmt , ou NULL si la valeur d'entrée n'est pas valide. |
try_url_decode(str) | Traduit une chaîne à partir du format application/x-www-form-urlencoded, et retourne NULL en cas d’erreur. |
try_zstd_decompress(value) | Retourne une valeur décompressée avec la compression Zstandard ou NULL si l’entrée n’est pas valide. |
ucase(expr) | Retourne expr avec tous les caractères convertis en majuscules. |
unbase64(expr) | Retourne une chaîne base64 décodée au format binaire. |
unhex(expr) | Convertit une expr hexadécimale en BINARY . |
upper(expr) | Retourne expr avec tous les caractères convertis en majuscules. |
url_decode(str) | Traduit une chaîne à partir du format application/x-www-form-urlencoded. |
url_encode(str) | Traduit une chaîne au format application/x-www-form-urlencoded. |
zstd_compress (value[,level[,streaming_mode]) | Retourne la valeur compressée avec la compression Zstandard. |
zstd_decompress(value) | Retourne la valeur décompressée avec la compression Zstandard. |
Fonctions scalaires numériques
Fonction | Descriptif |
---|---|
~ expr | Retourne le bit à bit NOT de expr . |
dividende / diviseur | Retourne dividend divisé par divisor . |
expr1 | expr2 | Retourne l’opération au niveau du bit OR de expr1 et expr2 . |
- expr | Retourne la valeur négative de expr . |
expr1 - expr2 | Retourne la soustraction de expr2 à partir de expr1 . |
+ expr | Retourne la valeur de expr . |
expr1 + expr2 | Retourne la somme des valeurs expr1 et expr2 . |
dividende % diviseur | Retourne le reste après dividend / divisor . |
expr1 ^ expr2 | Retourne l’opération exclusive au niveau du bit OR (XOR) de expr1 et expr2 . |
expr1 &expr2 | Retourne l’opération au niveau du bit AND de expr1 et expr2 . |
multiplicateur * multiplicand | Retourne multiplier multiplié par multiplicand . |
ABS(expr) | Retourne la valeur absolue de la valeur numérique dans expr . |
acos(expr) | Retourne le cosinus inverse (arc cosinus) de expr . |
acosh(expr) | Retourne le cosinus hyperbolique inverse de expr . |
asin(expr) | Retourne le sinus inverse (arc sinus) de expr . |
asinh(expr) | Retourne le sinus hyperbolique inverse de expr . |
atan(expr) | Retourne la tangente inverse (arc tangente) de expr . |
atan2(exprY, exprX) | Retourne l’angle (en radians) entre l’axe X positif d’un plan et le point donné par les coordonnées (exprX , exprY ). |
atanh(expr) | Retourne la tangente hyperbolique inverse de expr . |
bigint(expr) | Convertit la valeur expr en BIGINT . |
bit_count(expr) | Retourne le nombre de bits définis dans l’argument. |
bit_get(expr, pos) | Retourne la valeur d’un bit dans une représentation binaire d’un numérique intégral. |
bit_reverse(expr) | Retourne la valeur obtenue en inversant l’ordre des bits dans l’argument. |
bitmap_bit_position(expr) | Renvoie la position du bit de base 0 d'un nombre BIGINT donné dans un compartiment. |
bitmap_bucket_number(expr) | Retourne le numéro de compartiment bitmap pour un nombre BIGINT donné. |
bround(expr[,targetScale]) | Retourne l’arrondi de expr à l’aide du mode d’arrondi HALF_EVEN . |
cbrt(expr) | Retourne la racine cubique de expr . |
plafond(expr[,targetScale]) | Retourne le plus petit nombre non inférieur à expr arrondi à targetScale chiffres après la virgule à l’unité supérieure. |
plafond(expr[,targetScale]) | Retourne le plus petit nombre non inférieur à expr arrondi à targetScale chiffres après la virgule à l’unité supérieure. |
conv(num, fromBase, toBase) | Convertit num de fromBase en toBase . |
convert_timezone([sourceTz, ]targetTz, sourceTs) | Convertit le TIMESTAMP_NTZ sourceTs du fuseau horaire sourceTz en targetTz . |
cos(expr) | Retourne le cosinus de expr . |
cosh(expr) | Retourne le cosinus hyperbolique de expr . |
cot(expr) | Retourne la cotangente de expr . |
csc(expr) | Retourne la cosécante de expr . |
décimal(expr) | Convertit la valeur expr en DECIMAL . |
degrés(expr) | Convertit les radians en degrés. |
diviseur div dividende | Retourne la partie entière de la division de divisor par dividend . |
double(expr) | Convertit la valeur expr en DOUBLE . |
e() | Retourne la constante e . |
exp(expr) | Retourne e à la puissance expr . |
expm1(expr) | Retourne exp(expr) - 1 . |
factorial(expr) | Retourne la factorielle de expr . |
float(expr) | Convertit la valeur expr en FLOAT . |
floor(expr[,targetScale]) | Retourne le plus grand nombre non inférieur à expr arrondi à targetScale chiffres après la virgule à l’unité inférieure. |
getbit(expr, pos) | Retourne la valeur d’un bit dans une représentation binaire d’un numérique intégral. |
hypot(expr1, expr2) | Retourne sqrt(expr1 * expr1 + expr2 * expr2) . |
int(expr) | Convertit la valeur expr en INTEGER . |
isnan(expr) | Retourne la valeur true si expr a la valeur NaN . |
ln(expr) | Retourne le logarithme naturel (base e ) de expr . |
log([base,] expr) | Retourne le logarithme de expr avec base . |
log1p(expr) | Retourne log(1 + expr) . |
log2(expr) | Retourne le logarithme de expr avec la base 2 . |
log10(expr) | Retourne le logarithme de expr avec la base 10 . |
mod(dividende, diviseur) | Retourne le reste après dividend / divisor . |
nanvl(expr1, expr2) | Retourne expr1 si ce n’est pas NaN le cas, ou expr2 sinon. |
negative(expr) | Retourne la valeur négative de expr . |
'nullifzero(expr)' | Retourne expr s’il n’est pas égal à zéro, ou NULL sinon. |
pi() | Retourne pi. |
pmod(dividende, diviseur) | Retourne le reste positif après dividend / divisor . |
positif(expr) | Retourne la valeur de expr . |
pow(expr1, expr2) | Élève expr1 à la puissance expr2 . |
power(expr1, expr2) | Élève expr1 à la puissance expr2 . |
radians(expr) | Convertit expr , exprimée en degrés, en radians. |
rand([seed]) | Retourne une valeur aléatoire comprise entre 0 et 1. |
randn([seed]) | Retourne une valeur aléatoire à partir d’une distribution normale standard. |
random([graine]) | Retourne une valeur aléatoire comprise entre 0 et 1. |
rint(expr) | Retourne expr arrondi à un nombre entier sous la forme d’un DOUBLE . |
arrondir(expr[,échelleCible]) | Retourne l’arrondi de expr à l’aide du mode d’arrondi HALF_UP . |
sec(expr) | Retourne la sécante de expr . |
shiftleft(expr, n) | Retourne une valeur au niveau du bit décalée vers la gauche de n bits. |
shiftright(expr, n) | Retourne un nombre intégral signé au niveau du bit décalé vers la droite de n bits. |
shiftrightunsigned(expr, n) | Retourne un nombre intégral signé non signé au niveau du bit décalé vers la droite de n bits. |
sign(expr) | Retourne -1.0, 0.0 ou 1.0 si expr est négatif, égal à 0 ou positif. |
signum(expr) | Retourne -1.0, 0.0 ou 1.0 si expr est négatif, égal à 0 ou positif. |
sin(expr) | Retourne le sinus de expr . |
sinh(expr) | Retourne le sinus hyperbolique de expr . |
smallint(expr) | Convertit la valeur expr en SMALLINT . |
sqrt(expr) | Retourne la racine carrée du nombre expr . |
tan(expr) | Retourne la tangente de expr . |
tanh(expr) | Retourne la tangente hyperbolique de expr . |
tinyint(expr) | Convertit expr en TINYINT . |
to_number(expr, fmt) | Retourne expr casté en DECIMAL avec la mise en forme fmt . |
try_add(expr1, expr2) | Retourne la somme de expr1 et expr2 , ou NULL en cas d’erreur. |
try_divide(dividende, diviseur) | Retourne dividend divisé par divisor , ou NULL si divisor est égal à 0. |
try_mod(dividende, diviseur) | Retourne le reste après dividend / divisor , ou NULL si divisor est égal à 0. |
try_multiply(multiplicateur, multiplicand) | Retourne multiplier multiplié par multiplicand , ou NULL en cas de dépassement. |
try_subtract(expr1, expr2) | Retourne la soustraction de expr2 à expr1 , ou NULL en cas de dépassement. |
try_to_number(expr, fmt ) | Retourne expr casté en DECIMAL à l’aide de la mise en forme fmt , ou NULL si expr ne correspond pas au format. |
uniform(expr1, expr2 [,seed]) | Retourne une valeur aléatoire avec des valeurs indépendantes et distribuées identiquement dans la plage de nombres spécifiée. |
width_bucket(expr, minExpr, maxExpr, numBuckets) | Retourne le numéro de compartiment pour une valeur dans un histogramme equi-width. |
'zeroifnull(expr)' | Retourne expr si ce n’est pas NULL le cas, ou 0 sinon. |
Fonctions d'agrégation
Fonction | Descriptif |
---|---|
any(expr) | Retourne la valeur true si au moins une des valeurs de expr dans le groupe est true. |
toute_valeur(expr[,ignoreNull]) | Retourne une valeur de expr pour un groupe de lignes. |
approx_count_distinct(expr[,relativeSD]) | Retourne le nombre estimé de valeurs distinctes dans expr au sein du groupe. |
approx_percentile(expr, pourcentage[, précision]) | Retourne le centile approximatif de expr au sein du groupe. |
approx_top_k(expr[,k[,maxItemsTracked]]) | Retourne les k valeurs d’élément les plus fréquentes dans un expr avec leurs nombres approximatifs. |
array_agg(expr) | Retourne un tableau composé de toutes les valeurs d’expr dans le groupe. |
avg(expr) | Retourne la moyenne calculée à partir des valeurs d’un groupe. |
bit_and(expr) | Retourne l’opération au niveau du bit AND de toutes les valeurs d’entrée dans le groupe. |
bit_or(expr) | Retourne l’opération au niveau du bit OR de toutes les valeurs d’entrée dans le groupe. |
bit_xor(expr) | Retourne l’opération au niveau du bit XOR de toutes les valeurs d’entrée dans le groupe. |
bitmap_construct_agg(expr) | Retourne le OR au niveau du bit de toutes les valeurs de positions de bits dans le groupe. entre 0 et 32767 dans un groupe en tant que BINARY . |
bitmap_or_agg(expr) | Retourne le bit à bit OR de toutes les valeurs d’entrée BINARY du groupe. |
bool_and(expr) | Retourne la valeur true si toutes les valeurs de expr sont vraies au sein du groupe. |
bool_or(expr) | Retourne la valeur true si au moins une valeur dans expr est true au sein du groupe. |
collect_list(expr) | Retourne un tableau composé de toutes les valeurs d’expr dans le groupe. |
collect_set(expr) | Retourne un tableau contenant toutes les valeurs uniques figurant dans expr au sein du groupe. |
corr(expr1,expr2) | Retourne un coefficient de corrélation de Pearson entre un groupe de paires de nombres. |
count(*) | Retourne le nombre total de lignes récupérées dans un groupe, y compris celles contenant la valeur null. |
count(expr[, ...]) | Retourne le nombre de lignes dans un groupe pour lesquelles les expressions fournies sont toutes non null. |
count_if(expr) | Retourne le nombre de valeurs true pour le groupe dans expr . |
count_min_sketch(colonne,epsilon,confiance,graine) | Retourne la valeur count_min sketch de toutes les valeurs du groupe dans column avec epsilon , confidence et seed . |
covar_pop(expr1,expr2) | Retourne la covariance de population de paires de nombres dans un groupe. |
covar_samp(expr1,expr2) | Retourne la covariance d’échantillon de paires de nombres dans un groupe. |
every(expr) | Retourne la valeur true si toutes les valeurs de expr dans le groupe ont la valeur true. |
first(expr[,ignoreNull]) | Retourne la première valeur de expr pour un groupe de lignes. |
première_valeur(expr[,ignorerNul]) | Retourne la première valeur de expr pour un groupe de lignes. |
histogramme_numerique(expr,numBins) | Calcule un histogramme sur expr avec numBins bacs, en retournant un tableau de paires représentant les centres des bacs. |
hll_sketch_agg(expr[,lgConfigK]) | Retourne un croquis HyperLogLog utilisé pour estimer un nombre de valeurs distinctes. |
hll_union_agg(expr[,allowDifferentLgConfigK]) | Agrège les croquis HyperLogLog pour un groupe de lignes. |
kurtosis(expr) | Retourne la valeur kurtosis calculée à partir des valeurs d’un groupe. |
dernière(expr[,ignorerNul]) | Renvoie la dernière valeur de expr pour le groupe de lignes. |
last_value(expr[,ignoreNul]) | Renvoie la dernière valeur de expr pour le groupe de lignes. |
listagg(expr[,delim]) [DANS LE GROUPE (ORDER BY clé [,...])] | Retourne une concaténation STRING ou BINARY de toutes les valeurs dans le groupe expr , séparées par delim . |
max(expr) | Retourne la valeur maximale de expr dans un groupe. |
max_by(expr1,expr2) | Retourne la valeur d’expr1 associée à la valeur maximale d’expr2 dans un groupe. |
mean(expr) | Retourne la moyenne calculée à partir des valeurs d’un groupe. |
mesurer(colonne_mesure) | Retourne la mesure d’une vue de métrique calculée à partir des valeurs d’un groupe. |
median(expr) | Retourne la valeur médiane calculée à partir des valeurs d’un groupe. |
min(expr) | Retourne la valeur minimale de expr dans un groupe. |
min_by(expr1, expr2) | Retourne la valeur d’expr1 associée à la valeur minimale d’expr2 dans un groupe. |
mode(expr [,déterministe]) | Retourne la valeur la plus fréquente de NULL , autre que expr , dans un groupe. |
percentile(expr, pourcentage [,fréquence]) | Retourne la valeur de percentile exacte de expr au percentage spécifié. |
percentile_approx(expr, pourcentage[, précision]) | Retourne le centile approximatif de expr au sein du groupe. |
percentile_cont(pct) DANS LE GROUPE (ORDER BY clé) | Retourne le percentile interpolé de key au sein du groupe. |
percentile_disc(pct) DANS LE GROUPE (ORDER BY champ) | Retourne le centile discret de key au sein du groupe. |
regr_avgx(yExpr, xExpr) | Retourne la moyenne de xExpr calculée à partir des valeurs d’un groupe où xExpr et yExpr sont NOT NULL . |
regr_avgy(yExpr, xExpr) | Retourne la moyenne de yExpr calculée à partir des valeurs d’un groupe où xExpr et yExpr sont NOT NULL . |
regr_count(yExpr, xExpr) | Retourne le nombre de paires de valeurs non-nulles yExpr , xExpr dans le groupe. |
regr_intercept(yExpr, xExpr) | Retourne l'interception de la ligne de régression linéaire univariée dans un groupe où xExpr et yExpr ne sont NOT NULL. |
regr_r2(yExpr, xExpr) | Retourne le coefficient de détermination à partir des valeurs d’un groupe où xExpr et yExpr ne sont PAS NULL. |
regr_slope(yExpr, xExpr) | Retourne la pente de la ligne de régression linéaire des paires de valeurs non nulles yExpr , xExpr présentes dans le groupe. |
regr_sxx(yExpr, xExpr) | Retourne la somme des carrés des valeurs xExpr d’un groupe où xExpr et yExpr ne sont PAS NULL. |
regr_sxy(yExpr, xExpr) | Retourne la somme des produits de yExpr et xExpr calculés à partir des valeurs d’un groupe où xExpr et yExpr sont NOT NULL . |
regr_syy(yExpr, xExpr) | Retourne la somme des carrés des valeurs yExpr d’un groupe où xExpr et yExpr ne sont PAS NULL. |
schema_of_json_agg(json[, options]) | Retourne le schéma combiné de JSON chaînes dans un groupe au format DDL. |
schema_of_variant_agg(variantExpr) | Retourne le schéma combiné de toutes les valeurs VARIANT dans un groupe au format DDL. |
asymétrie(expr) | Retourne la valeur d’asymétrie calculée à partir des valeurs d’un groupe. |
some(expr) | Retourne la valeur true si au moins une valeur de expr dans un groupe est true . |
std(expr) | Retourne l’écart type de l’échantillon calculé à partir des valeurs du groupe. |
stddev(expr) | Retourne l’écart type de l’échantillon calculé à partir des valeurs du groupe. |
stddev_pop(expr) | Retourne l’écart type de population calculé à partir des valeurs d’un groupe. |
stddev_samp(expr) | Retourne l’écart type de l’échantillon calculé à partir des valeurs d’un groupe. |
string_agg(expr[,delim]) [WITHIN GROUP (ORDER BY clé [,...])] | Retourne une concaténation STRING ou BINARY de toutes les valeurs dans le groupe expr , séparées par delim . |
sum(expr) | Retourne la somme calculée à partir des valeurs d’un groupe. |
try_avg(expr) | Retourne la moyenne calculée à partir des valeurs d’un groupe, NULL en cas de dépassement de capacité. |
try_sum(expr) | Retourne la somme calculée à partir des valeurs d’un groupe, NULL en cas de dépassement de capacité. |
var_pop(expr) | Retourne la variance de population calculée à partir des valeurs d’un groupe. |
var_samp(expr) | Retourne l’écart de l’échantillon calculé à partir des valeurs d’un groupe. |
variance(expr) | Retourne l’écart de l’échantillon calculé à partir des valeurs d’un groupe. |
Fonctions de classement de fenêtre
Fonction | Descriptif |
---|---|
dense_rank() | Retourne le rang d’une valeur par rapport à toutes les valeurs dans la partition. |
ntile(n) | Divise les lignes de chaque partition de fenêtre en n buckets allant de 1 jusqu'à au maximum n . |
percent_rank() | Calcule le classement en pourcentage d’une valeur au sein de la partition. |
rank() | Retourne le rang d’une valeur par rapport à toutes les valeurs dans la partition. |
row_number() | Attribue un nombre séquentiel unique à chaque ligne, en commençant par un, en fonction de l’ordre des lignes dans la partition de fenêtre. |
Fonctions de fenêtre analytique
Fonction | Descriptif |
---|---|
cume_dist() | Retourne la position d’une valeur par rapport à toutes les valeurs de la partition. |
lag(expr[,décalage[,par défaut]]) | Retourne la valeur de expr à partir d’une ligne précédente dans la partition. |
lead(expr[,offset[,default]]) | Retourne la valeur de expr à partir d’une ligne suivante dans la partition. |
nth_value(expr, offset[, ignoreNulls]) | Retourne la valeur de expr à un offset spécifique dans la fenêtre. |
Fonctions de tableau
Fonction | Descriptif |
---|---|
arrayExpr[indexExpr] | Retourne l’élément à la position indexExpr du tableau arrayExpr . |
aggregate(expr,start,merge[,finish]) | Agrège les éléments d’un tableau à l’aide d’un agrégateur personnalisé. |
array([expr [, ...]]) | Retourne un tableau avec les éléments contenus dans expr . |
array_append(tableau, élément) | Retourne array ajouté par elem . |
array_compact(array) | Supprime les valeurs NULL de array . |
contient_tableau(array,value) | Retourne la valeur true si array contient value . |
array_distinct(array) | Supprime les valeurs en double de array . |
array_except(array1,array2) | Retourne un tableau des éléments dans array1 mais pas dans array2 . |
insérer_dans_tableau(tableau, indice, élément) | Retourne un développé array où elem est inséré à la index position. |
array_intersect(array1,array2) | Retourne un tableau des éléments de l’intersection de array1 et array2 . |
array_join(array,delimiter[,nullReplacement]) | Concatène les éléments de array . |
array_max(tableau) | Retourne la valeur maximale dans array . |
array_min(tableau) | Retourne la valeur minimale dans array . |
array_position(array,element) | Retourne la position de la première occurrence de element dans array . |
array_prepend(tableau, élément) | Retourne array précédé de elem . |
array_remove(array,element) | Supprime toutes les occurrences de element de array . |
array_repeat(élément,nombre) | Retourne un tableau contenant element count fois. |
array_size(array) | Retourne le nombre d’éléments contenus dans array . |
array_sort(array,func) | Retourne array trié en fonction de func . |
array_union(array1,array2) | Retourne un tableau des éléments de l’union de array1 et array2 sans doublons. |
arrays_overlap(array1, array2) | Retourne la valeur true si l’intersection de array1 et array2 n’est pas vide. |
arrays_zip(array1 [, ...]) | Retourne un tableau fusionné de structures dans lequel la nième structure contient toutes les Nièmes valeurs des tableaux d'entrée. |
cardinalité(expr) | Retourne la taille de expr . |
concat(expr1, expr2 [, ...]) | Retourne la concaténation des arguments. |
element_at(arrayExpr, index) | Retourne l’élément d’un arrayExpr à index . |
exists(expr, préd) | Retourne la valeur true si pred a la valeur true pour tout élément dans expr . |
explode(collection) | Retourne des lignes en annulant l’imbrication de collection . |
explode_outer(collection) | Retourne des lignes en annulant l’imbrication de collection à l’aide d’une sémantique externe. |
filter(expr,func) | Filtre le tableau dans expr à l’aide de la fonction func . |
flatten(arrayOfArrays) | Transforme un tableau de tableaux en un tableau unique. |
forall(expr, predFunc) | Vérifie si predFunc est valable pour tous les éléments du tableau. |
get(arrayExpr, index) | Retourne l’élément de arrayExpr à index , en commençant par 0 . |
inline(input) | Décompose un tableau de structures dans une table. |
inline_outer(input) | Décompose un tableau de structures dans une table avec une sémantique externe. |
posexplode(collection) | Retourne des lignes en annulant l’imbrication du tableau avec la numérotation des positions. |
posexplode_outer(collection) | Retourne des lignes en annulant l’imbrication du tableau avec la numérotation des positions à l’aide de la sémantique OUTER . |
reduce(expr,start,merge[,finish]) | Agrège les éléments d’un tableau à l’aide d’un agrégateur personnalisé. |
reverse(array) | Retourne une chaîne inversée ou un tableau avec l’ordre inverse des éléments. |
séquence(début,arrêt,pas) | Génère un tableau d’éléments de start à stop (inclus), en incrémentant par step . |
shuffle(array) | Retourne une permutation aléatoire du tableau dans expr . |
Taille(expr) | Retourne la cardinalité de expr . |
slice(expr,début,longueur) | Retourne un sous-ensemble d’un tableau. |
sort_array(expr[,ascendingOrder]) | Renvoie le tableau expr dans un ordre trié. |
transform(expr, func) | Transforme des éléments dans un tableau expr à l’aide de la fonction func . |
try_element_at(arrayExpr, index) | Retourne l’élément d’un arrayExpr à index , ou NULL si index est hors limite. |
zip_with(expr1, expr2, func) | Fusionne les tableaux présents dans expr1 et expr2 , élément par élément, en un tableau unique à l’aide de func . |
Fonctions cartographiques
Fonction | Descriptif |
---|---|
mapExpr[keyExpr] | Retourne la valeur à keyExpr du MAP mapExpr . |
cardinalité(expr) | Retourne la taille de expr . |
element_at(mapExpr, clé) | Retourne la valeur de mapExpr pour key . |
explode(collection) | Retourne des lignes en annulant l’imbrication de expr . |
explode_outer(collection) | Retourne des lignes en annulant l’imbrication de expr à l’aide d’une sémantique externe. |
map([{key1, value1}[, ...]]) | Crée un mappage avec les paires clé-valeur données. |
map_concat([expr1 [, ...]]) | Retourne l’union de toutes les expressions de mappage expr . |
map_contains_key(carte, clé) | Retourne true si map contient key , false sinon. |
entrées_de_carte(carte) | Retourne un tableau non trié de toutes les entrées de map . |
map_filter(expr, func) | Filtre les entrées du mappage dans expr à l’aide de la fonction func . |
map_from_arrays(clés, valeurs) | Crée un mappage avec une paire de tableaux keys et values . |
carte_des_entrées(expr) | Crée une carte à partir du tableau d’entrées spécifié. |
map_keys(carte) | Retourne un tableau non trié contenant les clés de map . |
valeurs_carte(mappage) | Retourne un tableau non trié contenant les valeurs de map . |
map_zip_with(carte1, carte2, fonction) | Fusionne map1 et map2 dans une seule carte. |
Taille(expr) | Retourne la cardinalité de expr . |
str_to_map(expr[,pairDelim[,keyValueDelim]]) | Retourne un mappage après fractionnement de expr en paires clé-valeur à l’aide de délimiteurs. |
transform_keys(expr, func) | Transforme les clés d’un mappage dans expr à l’aide de la fonction func . |
transform_values(expr, func) | Transforme les valeurs d’un mappage dans expr à l’aide de la fonction func . |
try_element_at(mapExpr, clé) | Retourne la valeur de mapExpr pour key , ou NULL si key n’existe pas. |
Fonctions de date, de timestamp et d’intervalle
Pour plus d’informations sur les formats de date et de timestamp, consultez Modèles de DateHeure.
Fonction | Descriptif |
---|---|
intervalExpr / divisor | Retourne l’intervalle divisé par divisor . |
- intervalExpr | Retourne la valeur négative de intervalExpr . |
intervalExpr1 - intervalExpr2 | Retourne la soustraction de intervalExpr2 à partir de intervalExpr1 . |
datetimeExpr1 - datetimeExpr2 | Retourne la soustraction de datetimeExpr2 à partir de datetimeExpr1 . |
+ intervalExpr | Retourne la valeur de intervalExpr . |
intervalExpr1 + intervalExpr2 | Retourne la somme des valeurs intervalExpr1 et intervalExpr2 . |
intervalExpr * multiplicand | Retourne intervalExpr multiplié par multiplicand . |
ABS(expr) | Retourne la valeur absolue de la valeur d’intervalle dans expr . |
add_months(startDate,numMonths) | Renvoie la date qui est numMonths après startDate . |
curdate() | Retourne la date actuelle au début de l’évaluation de la requête. |
current_date() | Retourne la date actuelle au début de l’évaluation de la requête. |
current_timestamp() | Retourne le timestamp actuel au début de l’évaluation de la requête. |
current_timezone() | Retourne le fuseau horaire local de la session actuelle. |
date(expr) | Convertit la valeur expr au format DATE. |
date_add(startDate,numDays) | Retourne la date numDays après startDate . |
date_add(unité, valeur, expr) | Ajoute value unit s à un horodatage expr . |
date_diff(unité, début, fin) | Retourne la différence entre deux horodatages mesurés dans unit s. |
date_format(expr,fmt) | Convertit un timestamp en une chaîne au format fmt . |
date_from_unix_date(jours) | Crée une date à partir du nombre de jours écoulés depuis 1970-01-01 . |
date_part(field,expr) | Extrait une partie de la date, du timestamp ou de l’intervalle. |
date_sub(startDate,numDays) | Retourne la date numDays avant startDate . |
date_trunc(unité, expr) | Retourne le timestamp tronqué à l’unité spécifiée dans unit . |
dateadd(startDate,numDays) | Retourne la date numDays après startDate . |
ajouterdate(unité, valeur, expr) | Ajoute value unit s à un horodatage expr . |
datediff(endDate,startDate) | Retourne le nombre de jours compris entre startDate et endDate . |
datediff(unit, start, stop) | Retourne la différence entre deux horodatages mesurés dans unit s. |
day(expr) | Retourne le jour du mois correspondant à la date ou au timestamp. |
dayname(expr) | Retourne l’acronyme anglais de trois lettres pour le jour de la semaine pour la date donnée. |
dayofmonth(expr) | Retourne le jour du mois correspondant à la date ou au timestamp. |
dayofweek(expr) | Retourne le jour de la semaine correspondant à la date ou au timestamp. |
dayofyear(expr) | Retourne le jour de l’année correspondant à la date ou au timestamp. |
diviseur div dividende | Retourne la partie entière de la division de l’intervalle divisor par l’intervalle dividend . |
extract(field FROM source) | Retourne field de source . |
from_unixtime(unixTime,fmt) | Retourne unixTime dans fmt . |
from_utc_timestamp(expr,timezone) | Retourne l'horodatage à UTC pour un horodatage expr à timeZone . |
getdate() | Retourne le timestamp actuel au début de l’évaluation de la requête. |
hour(expr) | Retourne le composant heure d’un timestamp. |
last_day(expr) | Retourne le dernier jour du mois auquel la date appartient. |
make_date(année,mois,jour) | Crée une date à partir des champs year , month et day . |
make_dt_interval([jours[, heures[, mins[, secs]]]]) | Crée un intervalle de jour-heure à partir de days , hours , mins et secs . |
make_interval(années, mois, semaines, jours, heures, mins, secs) | Déconseillé : crée un intervalle à partir de years , months , weeks , days , hours , mins et secs . |
make_timestamp(year,month,day,hour,min,sec[,timezone]) | Crée un timestamp à partir des champs year , month , day , hour , min , sec et timezone . |
make_ym_interval([années[, mois]]) | Crée un intervalle d’année-mois à partir de years et months . |
minute(expr) | Retourne le composant minute du timestamp dans expr . |
month(expr) | Retourne le composant mois du horodatage dans expr . |
months_between(expr1,expr2[,roundOff]) | Retourne le nombre de mois écoulés entre les dates ou les timestamps dans expr1 et expr2 . |
next_day(expr,jourdelasemaine) | Retourne la première date postérieure à expr et nommée comme dans dayOfWeek . |
now() | Retourne le timestamp actuel au début de l’évaluation de la requête. |
quarter(expr) | Retourne le trimestre de l’année pour expr dans la plage comprise entre 1 et 4. |
second(expr) | Retourne le deuxième composant du timestamp dans expr . |
session_window(expr, gpDuration) | Crée une fenêtre de session sur une expression d’horodatage. |
sign(expr) | Retourne -1.0, 0.0 ou 1.0 si expr est négatif, égal à 0 ou positif. |
signum(expr) | Retourne -1.0, 0.0 ou 1.0 si expr est négatif, égal à 0 ou positif. |
timediff(unit, start, stop) | Retourne la différence entre deux horodatages mesurés dans unit s. |
timestamp(expr) | Convertit expr en TIMESTAMP . |
timestamp_micros(expr) | Crée un horodatage expr microsecondes depuis l’époque UTC. |
timestamp_millis(expr) | Crée un timestamp expr en millisecondes depuis l’époque UTC. |
timestamp_seconds(expr) | Crée un horodatage en expr secondes depuis l'époque UTC. |
timestampadd(unité, valeur, expr) | Ajoute value unit s à un horodatage expr . |
timestampdiff(unité, début, fin) | Retourne la différence entre deux horodatages mesurés dans unit s. |
to_date(expr[,fmt]) | Retourne un cast de expr en date utilisant une mise en forme facultative. |
to_timestamp(expr[,fmt]) | Retourne expr cast en horodatage à l’aide d’une mise en forme facultative. |
to_unix_timestamp(expr[,fmt]) - convertit une expression de date/heure en un timestamp Unix. | Retourne le timestamp dans expr en tant que timestamp UNIX. |
to_utc_timestamp(expr,timezone) | Retourne l'horodatage à UTC pour un horodatage expr à timezone . |
trunc(expr, fmt) | Retourne une date dont une partie est tronquée à l’unité spécifiée par le modèle de format fmt . |
try_add(expr1, expr2) | Retourne la somme de expr1 et expr2 , ou NULL en cas d’erreur. |
try_divide(dividende, diviseur) | Retourne dividend divisé par divisor ou NULL si divisor est égal à 0. |
try_multiply(multiplicateur, multiplicand) | Retourne multiplier multiplié par multiplicand , ou NULL en cas de dépassement. |
try_subtract(expr1, expr2) | Retourne la soustraction de expr2 à expr1 , ou NULL en cas de dépassement. |
try_to_timestamp(expr[,fmt]) | Retourne expr cast en horodatage à l’aide d’une mise en forme facultative, ou NULL si le cast échoue. |
unix_date(expr) | Retourne le nombre de jours écoulés depuis 1970-01-01 . |
unix_micros(expr) | Retourne le nombre de microsecondes écoulées depuis 1970-01-01 00:00:00 UTC . |
unix_millis(expr) | Retourne le nombre de millisecondes écoulées depuis 1970-01-01 00:00:00 UTC . |
unix_seconds(expr) | Retourne le nombre de secondes écoulées depuis 1970-01-01 00:00:00 UTC . |
unix_timestamp([expr[, fmt]]) | Retourne l'horodatage UNIX de l'heure actuelle ou de l'heure spécifiée. |
weekday(expr) | Retourne le jour de la semaine de expr . |
semaineDeLannée(expr) | Retourne la semaine de l’année de expr . |
year(expr) | Retourne le composant année de expr . |
window(expr, width[, step[, start]]) | Crée une fenêtre glissante basée sur un saut sur une expression d’horodatage. |
window_time(fenêtre) | Retourne l’heure de fin inclusive d’une fenêtre glissante produite par les fonctions window ou session_window. |
Fonctions géospatiales H3
Pour plus d’informations sur les fonctions géospatiales H3, consultez Fonctions géospatiales H3.
Fonctions et constructeurs de cast
Pour plus d’informations sur la conversion entre les types, consultez la fonction cast
et la fonction try_cast
.
Fonction | Descriptif |
---|---|
array([expr [, ...]]) | Retourne un tableau avec les éléments contenus dans expr . |
bigint(expr) | Convertit la valeur expr en BIGINT . |
binary(expr) | Convertit la valeur de expr en BINARY . |
boolean(expr) | Convertit expr en BOOLEAN . |
cast(type AS expr) | Convertit la valeur expr dans le type de données cible type . |
expr :: type | Convertit la valeur expr dans le type de données cible type . |
date(expr) | Convertit la valeur expr en DATE . |
décimal(expr) | Convertit la valeur expr en DECIMAL . |
double(expr) | Convertit la valeur expr en DOUBLE . |
float(expr) | Convertit la valeur expr en FLOAT . |
int(expr) | Convertit la valeur expr en INTEGER . |
make_date(année,mois,jour) | Crée une date à partir des champs year , month et day . |
make_dt_interval([jours[, heures[, mins[, secs]]]]) | Crée un intervalle de jour-heure à partir de days , hours , mins et secs . |
make_interval(années, mois, semaines, jours, heures, mins, secs) | Crée un intervalle à partir de years , months , weeks , days , hours , mins et secs . |
make_timestamp(year,month,day,hour,min,sec[,timezone]) | Crée un timestamp à partir des champs year , month , day , hour , min , sec et timezone . |
make_ym_interval([années[, mois]]) | Crée un intervalle d’année-mois à partir de years et months . |
map([{key1, value1} [, ...]]) | Crée un mappage avec les paires clé-valeur données. |
named_struct({name1, val1} [, ...]) | Crée un struct avec les noms et valeurs de champs spécifiés. |
smallint(expr) | Convertit la valeur expr en SMALLINT . |
string(expr) | Convertit la valeur expr en STRING . |
struct(expr1 [, ...]) | Crée un STRUCT avec les valeurs de champs spécifiées. |
tinyint(expr) | Convertit expr en TINYINT . |
timestamp(expr) | Convertit expr en TIMESTAMP . |
to_char(expr, fmt) | Retourne le cast expr sur STRING en utilisant le formatage fmt .” |
to_date(expr[,fmt]) | Retourne un cast de expr en date utilisant une mise en forme facultative. |
to_number(expr, fmt) | Retourne expr cast en DECIMA L à l’aide de la mise en forme fmt . |
to_timestamp(expr[,fmt]) | Retourne expr cast en horodatage à l’aide d’une mise en forme facultative. |
to_varchar(expr, fmt) | Retourne le cast expr sur STRING en utilisant le formatage fmt .” |
try_cast(type AS expr) | Convertit la valeur expr vers le type de données cible type en toute sécurité. |
try_to_number(expr, fmt) | Retourne expr casté sur DECIMAL à l’aide de la mise en forme fmt , ou NULL si expr n’est pas valide. |
Fonctions CSV et Avro
Fonction | Descriptif |
---|---|
from_avro(avroBin, jsonSchema[, options]) | Retourne une valeur de struct basée sur avroBin et jsonSchema . |
from_csv(csvStr, schema[, options]) | Retourne une valeur de struct avec csvStr et schema . |
schema_of_csv(csv[, options]) | Retourne le schéma d’une chaîne CSV au format DDL. |
to_avro(expr[, options]) | Retourne une valeur binaire Avro avec la valeur de struct spécifiée. |
to_csv(expr[, options]) | Retourne une chaîne CSV avec la valeur de struct spécifiée. |
Fonctions JSON
Fonction | Descriptif |
---|---|
jsonStr : jsonPath | Retourne les champs extraits du jsonStr . |
from_json(jsonStr, schema[, options]) | Retourne une valeur de struct avec jsonStr et schema . |
get_json_object(expr, path) | Extrait un objet JSON de path . |
json_array_length(jsonArray) | Retourne le nombre d'éléments du tableau JSON le plus externe. |
json_object_keys(jsonObject) | Retourne toutes les clés de l’objet JSON le plus éloigné sous forme de tableau. |
json_tuple(jsonStr, path1 [, ...]) | Retourne plusieurs objets JSON sous forme de tuple. |
parse_json(jsonStr) | Retourne une valeur VARIANT à partir de jsonStr . |
schema_of_json(jsonStr[, options]) | Retourne le schéma d’une chaîne JSON au format DDL. |
schema_of_json_agg(jsonStr[, options]) | Retourne le schéma combiné de JSON chaînes dans un groupe au format DDL. |
to_json(expr[, options]) | Retourne une chaîne JSON avec le STRUCT ou VARIANT spécifié dans expr . |
Fonctions VARIANT
Fonction | Descriptif |
---|---|
variantExpr : jsonPath | Retourne les champs extraits de variantExpr à l’aide du chemin JSON. |
is_variant_null(variantExpr) | Teste si variantExpr est encodé en VARIANT avec la valeur NULL . |
parse_json(jsonStr) | Retourne une valeur VARIANT à partir de jsonStr . |
schema_of_variant(variantExpr) | Retourne le schéma d’une expression VARIANT au format DDL. |
schema_of_variant_agg(variantExpr) | Retourne le schéma combiné de toutes les valeurs VARIANT dans un groupe au format DDL. |
to_json(expr[, options]) | Retourne une chaîne JSON avec le STRUCT ou VARIANT spécifié dans expr . |
try_parse_json(jsonStr) | Retourne une valeur VARIANT de le jsonStr si possible. Si ce n’est pas possible, retourne NULL . |
try_variant_get(variantExpr,path,type) | Extrait une valeur de type type à partir de variantExpr , spécifiée par path , ou NULL s’il n’est pas possible d’effectuer une conversion vers le type cible. |
variant_explode(entrée) | Retourne un ensemble de lignes en dés imbrication input . |
variant_explosion_extérieure(entrée) | Retourne un ensemble de lignes en désimbriquant input à l’aide d’une sémantique externe. |
variant_get(variantExpr,path,type) | Extrait une valeur de type type à partir de variantExpr , spécifié par path . |
Fonctions XPath et XML
Fonction | Descriptif |
---|---|
from_xml(xmlStr, schema[, options]) | Renvoie une valeur de structure analysée à partir de xmlStr en utilisant schema . |
schema_of_xml(xmlStr[, options]) | Retourne le schéma d’une chaîne XML au format DDL. |
xpath(xml, xpath) | Retourne des valeurs dans les nœuds de xml qui correspondent à xpath . |
xpath_boolean(xml, xpath) | Retourne true si l’expression xpath prend la valeur true , ou si un nœud correspondant dans xml est trouvé. |
xpath_double(xml, xpath) | Retourne une valeur DOUBLE à partir d’un document XML. |
xpath_float(xml, xpath) | Retourne une valeur FLOAT à partir d’un document XML. |
xpath_int(xml, xpath) | Retourne une valeur INTEGER à partir d’un document XML. |
xpath_long(xml, xpath) | Retourne une valeur BIGINT à partir d’un document XML. |
xpath_number(xml, xpath) | Retourne une valeur DOUBLE à partir d’un document XML. |
xpath_short(xml, xpath) | Retourne une valeur SHORT à partir d’un document XML. |
xpath_string(xml, xpath) | Retourne le contenu du premier nœud XML correspondant à l’expression XPath. |
Fonctions IA
Fonction | Descriptif |
---|---|
ai_analyze_sentiment(contenu) | Retourne le sentiment d’un texte. |
ai_classify(contenu, étiquettes) | Classe le contenu fourni dans l’une des étiquettes fournies. |
ai_extract(contenu, étiquettes) | Extrait les entités spécifiées par les étiquettes d’un texte donné. |
ai_fix_grammar(contenu) | Corrige les erreurs grammaticales dans un texte donné. |
ai_forecast(observé, time_col) | Extrapole les données de série chronologique à l’avenir. |
ai_gen(contenu) | Invoque un modèle d’IA génératif de pointe à partir des API du modèle Databricks Foundation pour répondre à l’invite fournie par l’utilisateur. |
ai_generate_text(prompt, modelName[, param1, value1] [...]) | Déconseillé : retourne du texte généré par un grand modèle de langage (LLM) sélectionné en fonction de l’invite. |
ai_mask(contenu, étiquettes) | Masque les entités spécifiées dans un texte donné. |
ai_query(endpointName, request, returnType) | Appelle un point de terminaison de service de modèles Mosaic AI existant, analyse sa réponse et la retourne. |
ai_similarity(strExpr1, strExpr2) | Compare deux chaînes et calcule le score de similarité sémantique. |
ai_summarize(contenu[, max_words]) | Génère un résumé d’un texte donné. |
ai_translate(contenu, to_lang) | Convertit le texte en langue cible spécifiée. |
vector_search(index, requête, nombre_de_résultats) | Interrogez un index de recherche vectorielle d’IA mosaïque à l’aide de SQL. |
Lire des fonctions
Fonction | Descriptif |
---|---|
read_files(path, [optionKey => optionValue] [, ...]) | Permet de lire des fichiers de données sur un stockage cloud et de les retourner au format tabulaire. |
read_kafka([optionKey => optionValue] [, ...]) | Permet de lire des enregistrements d’un cluster Apache Kafka et de les retourner au format tabulaire. |
read_kinesis({parameter=>value}[, …]) | Retourne une table avec des enregistrements lus à partir de Kinesis depuis un ou plusieurs flux. |
read_pubsub([parameter => value] [, ...]) | Fonction table pour la lecture d’enregistrements à partir de Pub/Sub à partir d’une rubrique. |
read_pulsar({optionKey => optionValue} [, ...]) | Retourne une table avec des enregistrements lus depuis Pulsar. |
read_state_metadata(path) | Retourne une table avec des lignes qui représentent les métadonnées d’un état de requête de diffusion en continu. |
read_statestore(path [, option_key => option_value] [...]) | Retourne des enregistrements à partir du magasin d’état des requêtes de diffusion en continu. |
Fonctions diverses
Fonction | Descriptif |
---|---|
assert_true(expr) | Retourne une erreur si expr n’a pas la valeur true. |
CASE expr { WHEN opt1 THEN res1 } [...] [ELSE def] FIN | Retourne resN pour le premier optN qui est égal à expr ou def si aucune correspondance n’est trouvée. |
CASE { WHEN cond1 THEN res1 } [...] [ELSE def] FIN | Retourne resN pour le premier condN qui prend la valeur true, ou def si aucun n’est trouvé. |
cloud_files_state( { TABLE(table) | point de contrôle } ) | Retourne l’état au niveau du fichier d’une source cloud_files de chargeur automatique. |
coalesce(expr1, expr2 [, ...]) | Retourne le premier argument non nul. |
classements() | Retourne la liste des classements disponibles. |
cube (expr1 [, ...]) | Crée un cube multidimensionnel à l’aide des colonnes d’expression spécifiées. |
current_catalog() | Retourne le catalogue actuel. |
current_database() | Retourne le schéma actuel. |
current_metastore() | Retourne l'ID actuel du Metastore du catalogue Unity. |
destinataire_actuel(clé) | Retourne une propriété pour le destinataire actuel dans un affichage partagé avec Delta Sharing. |
current_schema() | Retourne le schéma actuel. |
current_user() | Retourne l’utilisateur exécutant l’instruction. |
current_version() | Retourne la version actuelle de Azure Databricks. |
decode(expr, { key, value } [, ...] [,defValue]) | Retourne la valeur correspondant à la clé. |
elt(index, expr1 [, ...] ) | Retourne la nième expression. |
equal_null(expr1, expr2) | Retourne true si expr1 est égal à expr2 ou si les deux expressions sont NULL ; sinon, false . |
event_log( { TABLE(table) | pipeline_id } ) | Retourne une table de l’historique d’actualisation pour une vue matérialisée, une table en flux continu ou un pipeline. |
greatest(expr1, expr2 [, ...]) | Retourne la plus grande valeur de tous les arguments, en ignorant les valeurs null. |
grouping(col) | Indique si une colonne spécifiée dans un GROUPING SET , un ROLLUP ou un CUBE représente un sous-total. |
grouping_id([col1 [, ...]]) | Retourne le niveau de regroupement d’un ensemble de colonnes. |
hash(expr1 [, ...]) | Renvoie une valeur hachée des arguments. |
hll_sketch_estimate(expr) | Estime le nombre de valeurs distinctes collectées dans un croquis HyperLogLog. |
hll_union(expr1, expr2 [,allowDifferentLgConfigK]) | Combine deux croquis HyperLogLog. |
http_request({parm => expr} [, ...]) | Effectue une requête HTTP à l’aide d’une connexion HTTP définie. |
java_method(class, method[, arg1 [, ...]]) | Appelle une méthode avec réflexion. |
if(cond, expr1, expr2) | Retourne expr1 si cond a la valeur true , sinon expr2 . |
iff(cond, expr1, expr2) | Retourne expr1 si cond a la valeur true , sinon expr2 . |
ifnull(expr1, expr2) | Retourne expr2 si expr1 a la valeur NULL , sinon expr1 . |
input_file_block_length() | Retourne la longueur en octets du bloc en cours de lecture. |
input_file_block_start() | Retourne le décalage de début en octets du bloc en cours de lecture. |
input_file_name() | Retourne le nom du fichier en cours de lecture, ou une chaîne vide s’il n’est pas disponible. |
is_account_group_member(groupe) | Retourne vrai (true) si l’utilisateur actuel est membre du groupe au niveau du compte. |
is_member(groupe) | Retourne vrai (true) si l’utilisateur actuel est membre du groupe au niveau de l’espace de travail. |
isnull(expr) | Retourne la valeur true si expr a la valeur NULL . |
isnotnull(expr) | Retourne true si expr n’a pas la valeur NULL . |
least(expr1, expr2 [, ...]) | Retourne la plus petite valeur de tous les arguments, en ignorant les valeurs null. |
list_secrets([scopeStr]) | Retourne les clés dans une ou toutes les étendues que l’utilisateur est autorisé à voir à partir du service de secret Databricks. |
luhn_check(numStr) | Retourne true si numStr passe le test de vérification de l'algorithme de Luhn. |
monotonically_increasing_id() | Retourne des entiers 64 bits à incrémentation monotone. |
nullif(expr1, expr2) | Retourne NULL si expr1 est égal à expr2 , sinon expr1 . |
nvl(expr1, expr2) | Retourne expr2 si expr1 a la valeur NULL , sinon expr1 . |
nvl2(expr1, expr2, expr3) | Retourne expr2 si expr1 n’a pas la valeur NULL , sinon expr3 . |
raise_error(expr) | Lève une exception avec expr en tant que message. |
range(end) | Retourne une table de valeurs dans une plage spécifiée. |
range(start, end [, step [, numParts]]) | Retourne une table de valeurs dans une plage spécifiée. |
reflect(class, method[, arg1 [, ...]]) | Appelle une méthode avec réflexion. |
secret(scope, key) | Extrait une valeur secret avec les valeurs scope et key données à partir du service secret Databricks. |
session_user() | Retourne l’utilisateur connecté à Azure Databricks. |
spark_partition_id() | Retourne l’ID de la partition actuelle. |
sql_keywords() | Retourne l’ensemble de mots clés SQL dans Azure Databricks. |
stack(numRows, expr1 [, ...]) | Sépare expr1 , …, exprN en numRows lignes. |
table_changes(table_str, start [, end]) | Retourne un journal des modifications apportées à une table Delta Lake avec le flux de données de modifications activé. |
try_reflect(class, method[, arg1 [, ...]]) | Appelle une méthode avec réflexion, retournant NULL en cas d’échec de la méthode. |
try_secret(étendue, clé) | Extrait une valeur de secret avec les valeurs de scope et de key auprès du service des secrets Databricks, ou NULL si la clé ne peut pas être récupérée. |
typeof(expr) | Retourne une chaîne de type au format DDL pour le type de données de expr . |
user() | Retourne l’utilisateur exécutant l’instruction. |
uuid() | Retourne une chaîne d’identificateur unique universel (UUID). |
window(expr, width[, step [, start]]) | Crée une fenêtre glissante basée sur un saut sur une expression d’horodatage. |
xxhash64(expr1 [, ...]) | Retourne une valeur de code de hachage 64 bits des arguments. |
version() | Retourne la version d’Apache Spark. |