Integrierte Funktionen

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Dieser Artikel enthält Links zu und Beschreibungen von integrierten Operatoren und Funktionen für Zeichenfolgen und binäre Typen, numerische Skalare, Aggregationen, Fenster, Arrays, Zuordnungen, Datums- und Zeitstempel, Umwandlung, CSV-Daten, JSON-Daten, XPath-Bearbeitung und verschiedene andere Funktionen.

Siehe auch:

Operatoren und Prädikate

Informationen dazu, wie Operatoren im Verhältnis zueinander analysiert werden, finden Sie unter Operatorrangfolge.

Operator Syntax BESCHREIBUNG
& expr1 & expr2 Gibt das bitweise AND von expr1 und expr2 zurück.
and expr1 and expr2 Gibt das logische AND von expr1 und expr2 zurück.
* multiplier * multiplicand Der Operator gibt multiplier multipliziert mit multiplicand zurück.
!= expr1 != expr2 Gibt TRUE zurück, wenn expr1 ungleich expr2 ist, andernfalls false.
! !expr Gibt das logische NOT eines booleschen Ausdrucks zurück.
between expr1 [not] between expr2 and expr2 Prüft, ob expr1 größer oder gleich expr2 und kleiner oder gleich expr3 ist.
[ ] arrayExpr [ indexExpr ] Gibt das indexExpr. Element von ARRAY arrayExpr zurück.
[ ] mapExpr [ keyExpr ] Gibt den Wert bei keyExpr von MAP mapExpr zurück.
^ expr1 ^ expr2 Der Operator gibt das bitweise exklusive OR (XOR) von expr1 und expr2 zurück.
: jsonStr : jsonPath Gibt aus jsonStr extrahierte Felder zurück.
:: expr :: type Wandelt den Wert expr in den Zieldatentyp type um.
div divisor div dividend Gibt den ganzzahligen Teil der Division von divisor durch dividend zurück.
. mapExpr . keyIdentifier Gibt einen MAP-Wert nach keyIdentifier zurück.
. structExpr . fieldIdentifier Gibt ein STRUCT-Feld nach fieldIdentifier zurück.
== expr1 == expr2 Gibt true zurück, wenn expr1 gleich expr2 ist, andernfalls false.
= expr1 = expr2 Gibt true zurück, wenn expr1 gleich expr2 ist, andernfalls false.
>= expr1 >= expr2 Gibt true zurück, wenn expr1 größer oder gleich expr2 ist, andernfalls false.
> expr1 > expr2 Gibt true zurück, wenn expr1 größer als expr2 ist, andernfalls false.
exists exists(query) Gibt TRUE zurück, query wenn mindestens eine Zeile zurückgibt, andernfalls FALSE.
ilike str [not] ilike (pattern[ESCAPE escape]) Gibt TRUE zurück, wenn str entsprechend pattern (nicht) mit escape ohne Berücksichtigung der Groß-/Kleinschreibung vergleicht.
ilike str [not] ilike {ANY|SOME|ALL}([pattern[, ...]]) Gibt TRUE zurück, wenn str (nicht) mit allen Mustern ohne Berücksichtigung der Groß-/Kleinschreibung übereinstimmt.
in elem [not] in (expr1[, ...]) Gibt true zurück, wenn elem (nicht) einem exprN gleicht.
in elem [not] in (query) Gibt true zurück, wenn elem (nicht) einer Zeile in query gleicht.
is distinct expr1 is [not] distinct from expr2 Prüft, ob die Argumente (nicht) unterschiedliche Werte aufweisen, wobei NULL-Werte als vergleichbare Werte betrachtet werden.
is false expr is [not] false Prüft, ob expr (nicht) entsprechend false ist.
is null expr is [not] null Gibt true zurück, wenn expr (nicht) NULL ist.
is true expr is [not] true Prüft, ob expr (nicht) entsprechend true ist.
like str [not] like (pattern[ESCAPE escape]) Gibt TRUE zurück, wenn str (nicht) entsprechend pattern mit escape vergleicht.
like str [not] like {ANY|SOME|ALL}([pattern[, ...]]) Gibt TRUE zurück, wenn str (nicht) einem/allen Muster(n) entspricht.
<=> expr1 <=> expr2 Gibt das gleiche Ergebnis wie EQUAL(=) für Nicht-NULL-Operanden, aber true zurück, wenn beide NULL sind, sowie false, wenn einer der Operanden NULL ist.
<= expr1 <= expr2 Gibt true zurück, wenn expr1 kleiner oder gleich expr2 ist, andernfalls false.
<> expr1 <> expr2 Gibt true zurück, wenn expr1 ungleich expr2 ist, andernfalls false
< expr1 < expr2 Gibt true zurück, wenn expr1 kleiner als expr2 ist, andernfalls false.
- expr1 - expr2 Gibt das Ergebnis der Subtraktion von expr2 von expr1 zurück.
not not expr Gibt das logische NOT eines booleschen Ausdrucks zurück.
or expr1 or expr2 Gibt das logische OR von expr1 und expr2 zurück.
% dividend % divisor Gibt den Rest nach dividend / divisor zurück.
|| expr1 || expr2 Gibt die Verkettung von expr1 und expr2 zurück.
| expr1 | expr2 Gibt das bitweise OR von expr1 und expr2 zurück.
+ expr1 + expr2 Gibt die Summe von expr1 und expr2 zurück.
regexp str [not] regexp regex Gibt TRUE zurück, wenn str (nicht) mit regex übereinstimmt.
regexp_like str [not] regexp_like regex Gibt TRUE zurück, wenn str (nicht) mit regex übereinstimmt.
rlike str [not] rlike regex Gibt TRUE zurück, wenn str (nicht) mit regex übereinstimmt.
/ dividend / divisor Gibt dividend dividiert durch divisor zurück.
~ ~ expr Gibt das bitweise NOT von expr zurück.

Rangfolge der Operatoren

Rangfolge Operator
1 :, ::, [ ]
2 - (unär), + (unär), ~
3 *, /, %, div
4 +, -, ||
5 &
6 ^
7 |
8 =, ==, <=>, <>, !=, <, <=, >, >=
9 not, exists
10 between, in, rlike, regexp, ilike, like, is [not] [NULL, true, false], is [not] distinct from
11 and
12 or

Zeichenfolgen- und Binärfunktionen

Funktion BESCHREIBUNG
expr1 || expr2 Dieser gibt die Verkettung von expr1 und expr2 zurück.
aes_decrypt(expr, key[, mode[, padding[, aad]]]) Entschlüsselt einen binären Ausdruck (expr) mithilfe der AES-Verschlüsselung.
aes_encrypt(expr, key[, mode[, padding[, iv[, aad]]]]) Verschlüsselt einen binärem Ausdruck (expr) mithilfe der AES-Verschlüsselung.
ascii(str) Gibt das ASCII-Codeelement des ersten Zeichens von str zurück.
base64(expr) Konvertiert expr in eine Base64-Zeichenfolge.
bin(expr) Gibt die binäre Darstellung von expr zurück.
binary(expr) Wandelt den Wert von expr in BINARY um
bit_length(expr) Gibt die Bitlänge von Zeichenfolgendaten bzw. die Anzahl der Bits von Binärdaten zurück.
bitmap_count(expr) Gibt die Anzahl von Bits zurück, die in einer BINARY-Zeichenfolge festgelegt sind, die eine Bitmap darstellt.
btrim(str [, trimStr]) Gibt str ohne führende und nachgestellte Zeichen zurück.
char(expr) Die Funktion gibt das Zeichen am angegebenen UTF-16-Codepunkt zurück.
char_length(expr) Gibt die Zeichenlänge von Zeichenfolgendaten bzw. die Anzahl der Bytes von Binärdaten zurück.
character_length(expr) Gibt die Zeichenlänge von Zeichenfolgendaten bzw. die Anzahl der Bytes von Binärdaten zurück.
charindex(substr, str[, pos]) Gibt die Position des ersten Vorkommens von substr in str nach der Position pos zurück.
chr(expr) Die Funktion gibt das Zeichen am angegebenen UTF-16-Codepunkt zurück.
concat(expr1, expr2[, …]) Gibt die Verkettung der Argumente zurück.
concat_ws(sep[, expr1[, …]]) Gibt die durch sep getrennten Verkettungszeichenfolgen zurück.
contains(expr, subExpr) Gibt zurück true, wenn expr STRING oder BINARY enthält subExpr.
crc32(expr) Gibt einen CRC-Wert (Cyclic Redundancy Check) von expr zurück.
decode(expr, charSet) Übersetzt einen binären Ausdruck (expr) unter Verwendung der charSet-Zeichensatzcodierung in eine Zeichenfolge.
encode(expr, charSet) Die Funktion gibt die binäre Darstellung einer Zeichenfolge unter Verwendung der charSet-Zeichencodierung zurück.
endswith(expr, endExpr) Gibt zurück true, wenn expr STRING oder BINARY mit endExpr.
find_in_set(searchExpr, sourceExpr) Gibt die Position einer Zeichenfolge innerhalb einer durch Komma getrennten Liste von Zeichenfolgen zurück.
format_number(expr, scale) Formatiert expr wie #,###,###.##, gerundet auf scale Dezimalstellen.
format_number(expr, fmt) Formatiert expr wie fmt.
format_string(strfmt[, obj1 [, …]]) Mit dieser Funktion wird eine formatierte Zeichenfolge aus printf-Formatzeichenfolgen zurückgegeben.
hex(expr) Diese Funktion konvertiert expr in einen hexadezimalen Wert.
str ilike (pattern[ESCAPE escape]) Gibt TRUE zurück, wenn für str eine Übereinstimmung von pattern mit escape ohne Berücksichtigung der Groß- und Kleinschreibung vorliegt.
initcap(expr) Gibt expr mit dem ersten Buchstaben jedes Worts in Großbuchstaben zurück.
instr(str, substr) Die Funktion gibt den (1-basierten) Index des ersten Vorkommens von substr in str zurück.
lcase(expr) Gibt expr zurück, wobei alle Zeichen in Kleinbuchstaben geändert wurden.
left(str, len) Die Funktion gibt len-Zeichen am Anfang von str zurück.
len(expr) Gibt die Zeichenlänge von Zeichenfolgendaten bzw. die Anzahl der Bytes von Binärdaten zurück.
length(expr) Gibt die Zeichenlänge von Zeichenfolgendaten bzw. die Anzahl der Bytes von Binärdaten zurück.
levenshtein(str1, str2) Gibt die Levenshtein-Distanz zwischen den Zeichenfolgen str1 und str2 zurück.
str like (pattern[ESCAPE escape]) Gibt TRUE zurück, wenn für str eine Übereinstimmung von pattern mit escape vorliegt.
locate(substr, str[, pos]) Gibt die Position des ersten Vorkommens von substr in str nach der Position pos zurück.
lower(expr) Gibt expr zurück, wobei alle Zeichen in Kleinbuchstaben geändert wurden.
lpad(expr, len[, pad]) Gibt expr zurück, links mit pad bis zu einer Länge von len aufgefüllt.
ltrim([trimstr,] str) Die Funktion gibt str ohne führende Zeichen in trimStr zurück.
mask(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]]) Gibt eine maskierte Version der Eingabe str zurück.
md5(expr) Diese Funktion gibt eine MD5-128-Bit-Prüfsumme von expr als hexadezimale Zeichenfolge zurück.
octet_length(expr) Gibt die Bytelänge von Zeichenfolgendaten bzw. die Anzahl der Bytes von Binärdaten zurück.
overlay(input PLACING replace FROM pos [FOR len]) Ersetzt input durch replace, beginnend bei pos mit der Länge len.
parse_url(url, partToExtract[, key]) Extrahiert einen Teil von url.
position(substr, str[, pos]) Gibt die Position des ersten Vorkommens von substr in str nach der Position pos zurück.
position(subtr IN str) Gibt die Position des ersten Vorkommens von substr in str nach der Position pos zurück.
printf(strfmt[, obj1 [, …]]) Mit dieser Funktion wird eine formatierte Zeichenfolge aus printf-Formatzeichenfolgen zurückgegeben.
str regexp regex Gibt TRUE zurück, wenn str mit regex übereinstimmt
str regexp_like regex Gibt TRUE zurück, wenn str mit regex übereinstimmt
regexp_count(str, regexp) Gibt die Anzahl zurück, wie oft str mit dem regexp-Muster übereinstimmt.
regexp_extract(str, regexp[, idx]) Extrahiert die erste Zeichenfolge in str, die dem Ausdruck regexp und dem Gruppenindex regex entspricht.
regexp_extract_all(str, regexp[, idx]) Extrahiert alle Zeichenfolgen in str, die dem regexp-Ausdruck und dem regex-Gruppenindex entsprechen
regexp_instr(str, regexp) Gibt die Position des ersten Substrings in str zurück, die mit regexp übereinstimmt.
regexp_replace(str, regexp, rep[, position]) Ersetzt alle Teilzeichenfolgen von str, die regexp entsprechen, durch rep.
regexp_substr(str, regexp) Gibt den ersten Substring in str zurück, die mit regexp übereinstimmt.
repeat(expr, n) Gibt die Zeichenfolge zurück, die exprn-mal wiederholt.
replace(str, search [, replace]) Diese Funktion ersetzt alle Vorkommen von search durch replace.
reverse(expr) Gibt eine umgekehrte Zeichenfolge oder ein Array mit umgekehrter Elementreihenfolge zurück.
right(str, len) Gibt len Zeichen am Ende der Zeichenfolge str zurück.
str rlike regex Gibt TRUE zurück, wenn str mit regex übereinstimmt
rpad(expr, len[, pad]) Gibt expr zurück, rechts mit pad bis zu einer Länge von len aufgefüllt.
rtrim([trimStr,] str) Gibt str ohne nachgestellte Zeichen zurück.
sentences(str[, lang, country]) Teilt str in ein Array von Arrays von Wörtern.
sha(expr) Gibt einen sha1-Hashwert als hexadezimale Zeichenfolge von expr zurück.
sha1(expr) Gibt einen sha1-Hashwert als hexadezimale Zeichenfolge von expr zurück.
sha2(expr, bitLength) Gibt eine Prüfsumme der SHA-2-Familie als hexadezimale Zeichenfolge von expr zurück.
soundex(expr) Gibt den soundex-Code der Zeichenfolge zurüc.
space(n) Gibt eine Zeichenfolge zurück, die aus n Leerzeichen besteht.
split(str, regex[, limit]) Teilt str bei Vorkommen, die mit regex übereinstimmen und gibt ein Array mit einer Länge von höchstens limit zurück.
split_part(str, delim, partNum) Teilt str um Vorkommen von delim herum und gibt den partNum-Teil zurück.
startswith(expr, startExpr) Gibt zurück true, wenn expr STRING oder BINARY mit startExpr.
string(expr) Wandelt den Wert von expr in STRING um.
substr(expr, pos[, len]) Gibt die Teilzeichenfolge von expr zurück, die bei pos beginnt und die Länge len aufweist.
substr(expr FROM pos[ FOR len]) Gibt die Teilzeichenfolge von expr zurück, die bei pos beginnt und die Länge len aufweist.
substring(expr, pos[, len]) Gibt die Teilzeichenfolge von expr zurück, die bei pos beginnt und die Länge len aufweist.
substring(expr FROM pos[ FOR len]) Gibt die Teilzeichenfolge von expr zurück, die bei pos beginnt und die Länge len aufweist.
substring_index(expr, delim, count) Gibt die Teilzeichenfolge von expr vor count Vorkommen des Trennzeichens delim zurück.
to_binary(expr[, fmt]) Gibt die expr-Umwandlung in einen Binärwert basierend auf fmt zurück.
to_char(numExpr, fmt) Gibt numExpr zurück, das in einen STRING umgewandelt wurde (mithilfe der Formatierung fmt).
to_varchar(numExpr, fmt) Gibt numExpr zurück, das in einen STRING umgewandelt wurde (mithilfe der Formatierung fmt).
translate(expr, from, to) Gibt expr zurück, wobei alle Zeichen in from durch die Zeichen in to ersetzt wurden.
trim([[BOTH | LEADING | TRAILING] [trimStr] FROM] str) Schneidet Zeichen einer Zeichenfolge ab.
try_aes_decrypt(expr, key[, mode[, padding[, aad]]]) Entschlüsselt eine Binärdatei expr mithilfe der AES-Verschlüsselung und gibt im Fehlerfall NULL zurück.
try_to_binary(expr [, fmt]) Gibt die expr-Umwandlung in einen BINARY-Wert basierend auf fmt zurück (oder NULL, wenn die Eingabe ungültig ist).
ucase(expr) Gibt expr zurück, wobei alle Zeichen in Großbuchstaben geändert wurden.
unbase64(expr) Gibt eine decodierte base64-Zeichenfolge als Binärwert zurück.
unhex(expr) Konvertiert einen hexadezimalen Ausdruck (expr) in BINARY.
upper(expr) Gibt expr zurück, wobei alle Zeichen in Großbuchstaben geändert wurden.
url_decode(str) Übersetzt einen String aus dem Format application/x-www-form-urlencoded zurück.
url_encode(str) Übersetzt einen String ins Format application/x-www-form-urlencoded zurück.

Numerische Skalarfunktionen

Funktion BESCHREIBUNG
~ expr Gibt das bitweise NOT von expr zurück.
dividend / divisor Gibt dividend dividiert durch divisor zurück.
expr1 | expr2 Gibt das Bitweise OR von expr1 und expr2 zurück.
- expr Gibt den negierten Wert von expr zurück.
expr1 - expr2 Gibt das Ergebnis der Subtraktion von expr2 von expr1 zurück.
+ expr Gibt den Wert von expr zurück.
expr1 + expr2 Gibt die Summe von expr1 und expr2 zurück.
dividend % divisor Gibt den Rest nach dividend / divisor zurück.
expr1 ^ expr2 Der Operator gibt das bitweise exklusive OR (XOR) von expr1 und expr2 zurück.
expr1 & expr2 Gibt das bitweise AND von expr1 und expr2 zurück.
multiplier * multiplicand Der Operator gibt multiplier multipliziert mit multiplicand zurück.
abs(expr) Gibt den absoluten Wert des numerischen Werts in expr zurück.
acos(expr) Gibt den inversen Kosinus (Arkuskosinus) von expr zurück.
acosh(expr) Gibt den inversen hyperbolischen Kosinus von expr zurück.
asin(expr) Gibt den inversen Sinus (Arkussinus) von expr zurück.
asinh(expr) Gibt den inversen hyperbolischen Sinus von expr zurück.
atan(expr) Gibt den inversen Tangens (Arkustangens) von expr zurück.
atan2(exprY, exprX) Gibt den Winkel im Bogenmaß zwischen der positiven X-Achse einer Ebene und dem durch die Koordinaten (exprX, exprY) angegebenen Punkt zurück.
atanh(expr) Gibt den inversen hyperbolischen Tangens von expr zurück.
bigint(expr) Wandelt den Wert expr in einen BIGINT-Wert um.
bit_count(expr) Gibt die Anzahl der im Argument gesetzten Bits zurück.
bit_get(expr, pos) Gibt den Wert eines Bits in einer binären Darstellung eines ganzzahligen numerischen Werts zurück.
bit_reverse(expr) Gibt den Wert zurück, den durch die Umkehrung der Reihenfolge der Bits im Argument entsteht.
bitmap_bit_position(expr) Gibt die 0-basierte Bitposition einer angegebenen BIGINT-Zahl innerhalb eines Buckets zurück.
bitmap_bucket_number(expr) Gibt die Bitmap-Bucketnummer für eine angegebene BIGINT-Zahl zurück.
bround(expr[,targetScale]) Gibt expr gerundet mit dem HALF_EVEN-Rundungsmodus zurück.
cbrt(expr) Die Funktion gibt die Kubikwurzel von expr zurück.
ceil(expr[,targetScale]) Gibt die kleinste Zahl zurück, die nicht kleiner als expr gerundet auf targetScale Ziffern relativ zum Dezimalpunkt ist.
ceiling(expr[,targetScale]) Gibt die kleinste Zahl zurück, die nicht kleiner als expr gerundet auf targetScale Ziffern relativ zum Dezimalpunkt ist.
conv(num, fromBase, toBase) Konvertiert num von fromBase in toBase.
convert_timezone([sourceTz, ]targetTz, sourceTs) Konvertiert die TIMESTAMP_NTZ sourceTs aus der sourceTz-Zeitzone in targetTz.
cos(expr) Gibt den Kosinus von expr zurück.
cosh(expr) Gibt den hyperbolischen Kosinus von expr zurück.
cot(expr) Gibt den Kotangens von expr zurück.
csc(expr) Gibt den Kosekans von expr zurück.
decimal(expr) Wandelt den Wert expr in einen DECIMAL-Wert um.
degrees(expr) Konvertiert Bogenmaße zu Graden.
divisor div dividend Gibt den ganzzahligen Teil der Division von divisor durch dividend zurück.
double(expr) Wandelt den Wert expr in einen DOUBLE-Wert um.
e() Gibt die Konstante e zurück.
exp(expr) Gibt e hoch expr zurück.
expm1(expr) Gibt exp(expr) - 1 zurück.
factorial(expr) Gibt die Fakultät von expr zurück.
float(expr) Wandelt den Wert expr in einen FLOAT-Wert um.
floor(expr[,targetScale]) Gibt die größte Zahl zurück, die nicht kleiner als expr gerundet auf targetScale Ziffern relativ zum Dezimalpunkt ist.
getbit(expr, pos) Gibt den Wert eines Bits in einer binären Darstellung eines ganzzahligen numerischen Werts zurück.
hypot(expr1, expr2) Gibt sqrt(expr1 * expr1 + expr2 * expr2) zurück.
int(expr) Wandelt den Wert expr in einen INTEGER-Wert um.
isnan(expr) Gibt true zurück, wenn expr gleich NaN ist.
ln(expr) Die Funktion gibt den natürliche Logarithmus (Basis e) von expr zurück.
log([base,] expr) Gibt den Logarithmus von expr mit der Basis base zurück.
log1p(expr) Gibt log(1 + expr) zurück.
log2(expr) Gibt den Logarithmus von expr mit Basis 2 zurück.
log10(expr) Gibt den Logarithmus von expr mit Basis 10 zurück.
mod(dividend, divisor) Gibt den Teilungstest nach dividend / divisor zurück.
nanvl(expr1, expr2) Gibt expr1 zurück, wenn es sich nicht um NaN handelt, andernfalls expr2.
negative(expr) Gibt den negierten Wert von expr zurück.
pi() Gibt Pi zurück.
pmod(dividend, divisor) Gibt den positiven Teilungsrest nach dividend / divisor zurück.
positive(expr) Gibt den Wert von expr zurück.
pow(expr1, expr2) Potenziert expr1 mit expr2.
power(expr1, expr2) Potenziert expr1 mit expr2.
radians(expr) Diese Funktion konvertiert expr in Grad in Bogenmaße.
rand([seed]) Diese Funktion gibt einen Zufallswert zwischen 0 und 1 zurück.
randn([seed]) Die Funktion gibt einen Zufallswert aus einer Standardnormalverteilung zurück.
random([seed]) Diese Funktion gibt einen Zufallswert zwischen 0 und 1 zurück.
rint(expr) Gibt expr gerundet auf eine ganze Zahl als DOUBLE-Wert zurück.
round(expr[,targetScale]) Gibt expr gerundet mit dem HALF_UP-Rundungsmodus zurück.
sec(expr) Gibt den Sekans von expr zurück.
sin(expr) Gibt den Sinus von expr zurück.
shiftleft(expr, n) Gibt eine bitweise Linksverschiebung um n Bits zurück.
shiftright(expr, n) Gibt eine ganze Zahl mit Vorzeichen zurück, die bitweise um n Bits nach rechts verschoben wurde.
shiftrightunsigned(expr, n) Gibt eine ganze Zahl ohne Vorzeichen zurück, die bitweise um n Bits nach rechts verschoben wurde.
sign(expr) Gibt -1,0, 0,0 oder 1,0 zurück, da expr negativ, 0 oder positiv ist
signum(expr) Gibt -1,0, 0,0 oder 1,0 zurück, da expr negativ, 0 oder positiv ist
sinh(expr) Gibt den hyperbolischen Sinus von expr zurück.
smallint(expr) Wandelt den Wert expr in einen SMALLINT-Wert um.
sqrt(expr) Gibt die Quadratwurzel von expr zurück.
tan(expr) Gibt den Tangens von expr zurück.
tanh(expr) Gibt den hyperbolischen Tangens von expr zurück.
tinyint(expr) Wandelt expr in einen TINYINT-Wert um.
to_number(expr, fmt ) Gibt expr zurück, das mithilfe der Formatierung fmt in einen Dezimalwert umgewandelt wurde.
try_add(expr1, expr2) Gibt die Summe von expr1 und expr2 oder bei einem Fehler NULL zurück.
try_divide(dividend, divisor) Gibt dividend dividiert durch divisor zurück oder NULL, wenn divisor 0 ist.
try_multiply(multiplier, multiplicand) Gibt multiplier multipliziert mit multiplicand oder NULL im Überlauf zurück.
try_subtract(expr1, expr2) Gibt die Subtraktion von expr2 aus expr1 oder NULL im Überlauf zurück.
try_to_number(expr, fmt ) Gibt expr zurück, das mit der Formatierung fmt (oder NULL, wenn expr nicht mit dem Format übereinstimmt) in einen Dezimalwert umgewandelt wurde.
width_bucket(expr, minExpr, maxExpr, numBuckets) Gibt die Bucketnummer für einen Wert in einem Histogramm mit gleicher Breite zurück.

Aggregatfunktionen

Funktion BESCHREIBUNG
any(expr) Gibt TRUE zurück, wenn mindestens ein Wert von expr in der Gruppe TRUE ist.
any_value(expr[,ignoreNull]) Gibt einen Wert von expr für eine Gruppe von Zeilen zurück.
approx_count_distinct(expr[,relativeSD]) Gibt die geschätzte Anzahl unterschiedlicher Werte in expr innerhalb der Gruppe zurück.
approx_percentile(expr,percentage[,accuracy]) Gibt das ungefähre Perzentil von expr in der Gruppe zurück.
approx_top_k(expr[,k[,maxItemsTracked]]) Gibt die k häufigsten Elementwerte in einem Ausdruck (expr) zusammen mit ihrer ungefähren Anzahl zurück.
array_agg(expr) Gibt ein Array zurück, das aus allen Werten in expr innerhalb der Gruppe besteht.
avg(expr) Gibt den Mittelwert zurück, der aus Werten einer Gruppe berechnet wird.
bit_and(expr) Gibt das bitweise AND aller Eingabewerte in der Gruppe zurück
bit_or(expr) Gibt das bitweise OR aller Eingabewerte in der Gruppe zurück
bit_xor(expr) Gibt das bitweise XOR aller Eingabewerte in der Gruppe zurück
bitmap_construct_agg(expr) Gibt das bitweise OR aller Bitpositionswerte in der Gruppe zurück zwischen 0 und 32767 in einer Gruppe als BINARY.
bitmap_or_agg(expr) Gibt das bitweise OR aller BINARY-Eingabewerte in der Gruppe zurück
bool_and(expr) Gibt TRUE zurück, wenn alle Werte in expr innerhalb der Gruppe TRUE sind.
bool_or(expr) Gibt TRUE zurück, wenn mindestens ein Wert in expr innerhalb der Gruppe TRUE ist
collect_list(expr) Gibt ein Array zurück, das aus allen Werten in expr innerhalb der Gruppe besteht.
collect_set(expr) Gibt ein Array zurück, das aus allen eindeutigen Werten in expr innerhalb der Gruppe besteht
corr(expr1,expr2) Gibt den Pearson-Korrelationskoeffizienten zwischen einer Gruppe von Zahlenpaaren zurück.
count(*) Gibt die Gesamtzahl der abgerufenen Zeilen in einer Gruppe zurück, einschließlich der Zeilen, die NULL enthalten.
count(expr[, …]) Gibt die Anzahl der Zeilen in einer Gruppe zurück, für die alle angegebenen Ausdrücke ungleich NULL sind.
count_if(expr) Gibt die Anzahl der TRUE-Werte für die Gruppe in expr zurück.
count_min_sketch(column,epsilon,confidence,seed) Die Funktion gibt eine „count_min_sketch“-Aggregation aller Werte in der Gruppe in column mit epsilon, confidence und seed zurück.
covar_pop(expr1,expr2) Die Funktion gibt die Kovarianz der Grundgesamtheit von Zahlenpaaren in einer Gruppe zurück.
covar_samp(expr1,expr2) Gibt die Stichprobenkovarianz von Zahlenpaaren in einer Gruppe zurück.
every(expr) Gibt TRUE zurück, wenn alle Werte von expr in der Gruppe TRUE sind
first(expr[,ignoreNull]) Gibt den ersten Wert von expr für eine Zeilengruppe zurück.
first_value(expr[,ignoreNull]) Gibt den ersten Wert von expr für eine Zeilengruppe zurück.
hll_sketch_agg(expr[,lgConfigK]) Gibt eine HyperLogLog-Skizze zurück, die verwendet wird, um die Anzahl unterschiedlicher Werte anzunähern.
hll_union_agg(expr[,allowDifferentLgConfigK]) Aggregiert HyperLogLog-Skizzen für eine Gruppe von Zeilen.
kurtosis(expr) Gibt den Wölbungswert zurück, der aus Werten einer Gruppe berechnet wird.
last(expr[,ignoreNull]) Gibt den letzten Wert von expr für die Zeilengruppe zurück.
last_value(expr[,ignoreNull]) Gibt den letzten Wert von expr für die Zeilengruppe zurück.
max(expr) Gibt den maximalen Wert von expr in einer Gruppe zurück
max_by(expr1,expr2) Gibt den Wert eines Ausdrucks (expr1) zurück, für den der Wert von expr2 in einer Gruppe maximal ist
mean(expr) Gibt den Mittelwert zurück, der aus Werten einer Gruppe berechnet wird.
median(expr) Gibt den aus den Werten einer Gruppe berechneten Median zurück.
min(expr) Gibt den kleinsten Wert von expr in einer Gruppe zurück.
min_by(expr1, expr2) Gibt den Wert eines Ausdrucks (expr1) zurück, für den der Wert von expr2 in einer Gruppe minimal ist.
mode(expr [,deterministic]) Gibt den häufigsten Wert von expr (nicht NULL) einer Gruppe zurück.
percentile(expr, percentage [,frequency]) Gibt den genauen Perzentilwert von expr am angegebenen percentage-Wert zurück.
percentile_approx(expr,percentage[,accuracy]) Gibt das ungefähre Perzentil von expr in der Gruppe zurück.
percentile_cont(pct) WITHIN GROUP (ORDER BY key) Gibt das interpolierte Perzentil von key innerhalb der Gruppe zurück.
percentile_disc(pct) WITHIN GROUP (ORDER BY key) Gibt das diskrete Perzentil von key innerhalb der Gruppe zurück.
regr_avgx(yExpr, xExpr) Gibt den Mittelwert aus xExpr aus den Werten einer Gruppe zurück, in der xExpr und yExpr NICHT NULL sind.
regr_avgy(yExpr, xExpr) Gibt den Mittelwert aus yExpr aus den Werten einer Gruppe zurück, in der xExpr und yExpr NICHT NULL sind.
regr_count(yExpr, xExpr) Gibt die Anzahl von Nicht-Null-Wertpaaren yExprxExpr in der Gruppe zurück.
regr_intercept(yExpr, xExpr) Gibt den Schnittpunkt der eindimensionalen linearen Regressionsgeraden einer Gruppe zurück, in der xExpr und yExpr NICHT NULL sind.
regr_r2(yExpr, xExpr) Gibt den Bestimmungskoeffizienten von Werten einer Gruppe zurück, bei dem xExpr und yExpr NICHT NULL sind.
regr_slope(yExpr, xExpr) Gibt die Neigung der linearen Regressionsgeraden von Nicht-NULL-Wertepaaren yExpr, xExpr in der Gruppe zurück.
regr_sxx(yExpr, xExpr) Gibt die Summe der Quadrate der xExpr-Werte einer Gruppe zurück, wobei xExpr und yExpr nicht NULL sind.
regr_sxy(yExpr, xExpr) Gibt die Summe der Produkte von yExpr und xExpr zurück, die aus den Werten einer Gruppe berechnet wurde, wobei xExpr und yExpr NICHT NULL sind.
regr_syy(yExpr, xExpr) Gibt die Summe der Quadrate der yExpr-Werte einer Gruppe zurück, wobei xExpr und yExpr nicht NULL sind.
schema_of_json_agg(json[, options]) Gibt das kombinierte Schema von JSON-Zeichenfolgen in einer Gruppe im DDL-Format zurück.
skewness(expr) Die Funktion gibt den Schiefewert zurück, der aus Werten einer Gruppe berechnet wird.
some(expr) Gibt TRUE zurück, wenn mindestens ein Wert von expr in einer Gruppe true ist.
std(expr) Gibt die Standardabweichung der Stichprobe zurück, die aus den Werten innerhalb der Gruppe berechnet wurde
stddev(expr) Gibt die Standardabweichung der Stichprobe zurück, die aus den Werten innerhalb der Gruppe berechnet wurde
stddev_pop(expr) Gibt die aus den Werten einer Gruppe berechnete Standardabweichung der Grundgesamtheit zurück.
stddev_samp(expr) Gibt die aus den Werten einer Gruppe berechnete Standardabweichung einer Stichprobe zurück.
sum(expr) Gibt die Summe zurück, die aus Werten einer Gruppe berechnet wird.
try_avg(expr) Gibt den Mittelwert, der aus Werten einer Gruppe berechnet wurde, oder NULL zurück, wenn ein Überlauf auftritt.
try_sum(expr) Gibt die Summe, die aus Werten einer Gruppe berechnet wurde, oder NULL zurück, wenn ein Überlauf auftritt.
var_pop(expr) Gibt die aus den Werten einer Gruppe berechnete Varianz der Grundgesamtheit zurück.
var_samp(expr) Gibt die Varianz der Stichprobe zurück, die aus Werten einer Gruppe berechnet wird.
variance(expr) Gibt die Varianz der Stichprobe zurück, die aus Werten einer Gruppe berechnet wird.

Fensterrangfunktionen

Funktion BESCHREIBUNG
dense_rank() Gibt den Rang eines Werts im Vergleich zu allen Werten in der Partition zurück.
ntile(n) Dividiert die Zeilen für jede Fensterpartition in n Buckets von 1 bis höchstens n.
percent_rank() Berechnet die prozentuale Rangfolge eines Werts innerhalb der Partition.
rank() Gibt den Rang eines Werts im Vergleich zu allen Werten in der Partition zurück.
row_number() Weist jeder Zeile eine eindeutige, fortlaufende Nummer entsprechend der Reihenfolge der Zeilen innerhalb der Fensterpartition beginnend mit eins zu.

Analysefensterfunktionen

Funktion BESCHREIBUNG
cume_dist() Gibt die Position eines Werts relativ zu allen Werten in der Partition zurück.
lag(expr[,offset[,default]]) Gibt den Wert von expr aus einer vorangehenden Zeile innerhalb der Partition zurück.
lead(expr[,offset[,default]]) Gibt den Wert von expr aus einer nachfolgenden Zeile innerhalb der Partition zurück.
nth_value(expr, offset[, ignoreNulls]) Gibt den Wert von expr an einem bestimmten offset im Fenster zurück.

Arrayfunktionen

Funktion BESCHREIBUNG
arrayExpr[indexExpr] Gibt das Element an der Position indexExpr von ARRAY arrayExprzurück.
aggregate(expr,start,merge[,finish]) Aggregiert Elemente in einem Array unter Verwendung eines benutzerdefinierten Aggregators.
array([expr [, …]]) Gibt ein Array mit den Elementen in expr zurück.
array_append(array, elem) Gibt elem angefügt an array zurück.
array_compact(array) Entfernt NULL-Werte aus array.
array_contains(array,value) Gibt TRUE zurück, wenn arrayvalue enthält.
array_distinct(array) Entfernt doppelte Werte aus array.
array_except(array1,array2) Gibt ein Array der Elemente zurück, die in array1, aber nicht in array2 enthalten sind.
array_insert(array, index, elem) Gibt einen erweiterten array-Wert zurück, bei dem elem an der index-Position eingefügt wird.
array_intersect(array1,array2) Gibt ein Array mit den Elementen in der Schnittmenge von array1 und array2 zurück.
array_join(array,delimiter[,nullReplacement]) Verkettet die Elemente von array.
array_max(array) Gibt den maximalen Wert in array zurück.
array_min(array) Gibt den kleinsten Wert in array zurück.
array_position(array,element) Gibt die Position des ersten Vorkommens von element in array zurück.
array_prepend(array, elem) Gibt elem vorangestellt vor array zurück.
array_remove(array,element) Entfernt alle Vorkommen von element aus array.
array_repeat(element,count) Gibt ein Array zurück, das elementcount-mal enthält.
array_size(array) Gibt die Anzahl von Elementen in einer array zurück.
array_sort(array,func) Gibt array sortiert nach func zurück.
array_union(array1,array2) Gibt ein Array mit den Elementen in der Vereinigung von array1 und array2 ohne Duplikate zurück.
arrays_overlap(array1, array2) Gibt TRUE zurück, wenn die Schnittmenge von array1 und array2 nicht leer ist.
arrays_zip(array1 [, …]) Gibt ein zusammengeführtes Array aus Strukturen zurück, in dem die n-te Struktur alle N-ten Werte der Eingabearrays enthält.
cardinality(expr) Gibt die Größe von expr zurück.
concat(expr1, expr2 [, …]) Gibt die Verkettung der Argumente zurück.
element_at(arrayExpr, index) Gibt das Element eines arrayExpr bei index zurück.
exists(expr, pred) Gibt TRUE zurück, wenn pred für ein beliebiges Element in expr TRUE ist.
explode(collection) Gibt Zeilen zurück, indem die Schachtelung von collection aufgehoben wird.
explode_outer(collection) Gibt Zeilen zurück, indem die Schachtelung von collection mithilfe von äußerer Semantik aufgehoben wird.
filter(expr,func) Filtert das Array in expr mit der Funktion func.
flatten(arrayOfArrays) Transformiert ein Array von Arrays in ein einzelnes Array.
forall(expr, predFunc) Prüft, ob predFunc für alle Elemente im Array gilt.
get(arrayExpr, index) Gibt das Element eines Arrayausdrucks (arrayExpr) bei index ab 0 zurück.
inline(expr) Erstellt aus einem Array von Strukturen eine Tabelle.
inline_outer(expr) Erstellt aus einem Array von Strukturen eine Tabelle unter Verwendung einer OUTER-Semantik.
posexplode(expr) Gibt Zeilen durch Entschachtelung des Arrays mit Nummerierung der Positionen zurück.
posexplode_outer(expr) Gibt Zeilen durch Entschachtelung des Arrays mit Nummerierung der Positionen unter Verwendung der OUTER-Semantik zurück.
reduce(expr,start,merge[,finish]) Aggregiert Elemente in einem Array unter Verwendung eines benutzerdefinierten Aggregators.
reverse(array) Gibt eine umgekehrte Zeichenfolge oder ein Array mit umgekehrter Elementreihenfolge zurück.
sequence(start,stop,step) Generiert ein Array von Elementen von start bis stop (einschließlich) mit der Schrittweite step.
shuffle(array) Gibt eine zufällige Permutation des Arrays in expr zurück.
size(expr) Gibt die Kardinalität von expr zurück.
slice(expr,start,length) Gibt eine Teilmenge eines Arrays zurück.
sort_array(expr[,ascendingOrder]) Die Funktion gibt das Array in expr in sortierter Reihenfolge zurück.
transform(expr, func) Transformiert Elemente in einem Array in expr unter Verwendung der Funktion func.
try_element_at(arrayExpr, index) Gibt das Element eines Arrayausdrucks (arrayExpr) bei index zurück (oder NULL, wenn index außerhalb des gültigen Bereichs liegt).
zip_with(expr1, expr2, func) Führt die Arrays in expr1 und expr2 Element für Element unter Verwendung von func in einem einzelnen Array zusammen.

map-Funktionen

Funktion BESCHREIBUNG
mapExpr[keyExpr] Gibt den Wert bei keyExpr von MAP mapExpr zurück.
cardinality(expr) Gibt die Größe von expr zurück.
element_at(mapExpr, key) Gibt den Wert von mapExpr für key zurück.
explode(expr) Gibt Zeilen zurück, indem die Schachtelung von expr aufgehoben wird.
explode_outer(expr) Gibt Zeilen zurück, indem die Schachtelung von expr mithilfe von äußerer Semantik aufgehoben wird.
map([{key1, value1}[, …]]) Erstellt eine Zuordnung mit den angegebenen Schlüssel-Wert-Paaren.
map_concat([expr1 [, …]]) Gibt die Vereinigung aller expr-Zuordnungsausdrücke zurück.
map_contains_key(map, key) Gibt true zurück, wenn map andererseits key, false enthält.
map_entries(map) Gibt ein ungeordnetes Array aller Einträge in map zurück.
map_filter(expr, func) Filtert Einträge in der Zuordnung in expr unter Verwendung der Funktion func.
map_from_arrays(keys, values) Erstellt eine Zuordnung mit einem Paar der keys- und values-Arrays.
map_from_entries(expr) Erstellt eine Zuordnung aus dem angegebenen Array von Einträgen.
map_keys(map) Gibt ein unsortiertes Array zurück, das die Schlüssel von map enthält.
map_values(map) Gibt ein ungeordnetes Array zurück, das die Werte von map enthält.
map_zip_with(map1, map2, func) Führt map1 und map2 in einer einzelnen Zuordnung zusammen.
size(expr) Gibt die Kardinalität von expr zurück.
str_to_map(expr[,pairDelim[,keyValueDelim]]) Gibt eine Zuordnung zurück, nachdem expr mithilfe von Trennzeichen in Schlüssel-Wert-Paare aufgeteilt wurde.
transform_keys(expr, func) Transformiert Schlüssel in einer Zuordnung in expr mithilfe der Funktion func.
transform_values(expr, func) Transformiert Werte in einer Zuordnung in expr mithilfe der Funktion func.
try_element_at(mapExpr, key) Gibt den Wert von mapExpr für key zurück (oder NULL, wenn key nicht vorhanden ist).

Datums-, Zeitstempel- und Intervallfunktionen

Informationen zu Datums- und Zeitstempelformaten finden Sie unter Datetime-Muster.

Funktion BESCHREIBUNG
intervalExpr / divisor Gibt das Intervall dividiert durch divisor zurück.
- intervalExpr Gibt den negierten Wert von intervalExpr zurück.
intervalExpr1 - intervalExpr2 Gibt das Ergebnis der Subtraktion von intervalExpr2 von intervalExpr1 zurück.
datetimeExpr1 - datetimeExpr2 Gibt das Ergebnis der Subtraktion von datetimeExpr2 von datetimeExpr1 zurück.
+ intervalExpr Gibt den Wert von intervalExpr zurück.
intervalExpr1 + intervalExpr2 Gibt die Summe von intervalExpr1 und intervalExpr2 zurück.
intervalExpr * multiplicand Der Operator gibt intervalExpr multipliziert mit multiplicand zurück.
abs(expr) Gibt den absoluten Wert des Intervallwerts in expr zurück.
add_months(startDate,numMonths) Gibt das Datum zurück, das numMonths nach dem startDate liegt.
curdate() Gibt das aktuelle Datum zu Beginn der Abfrageauswertung zurück.
current_date() Gibt das aktuelle Datum zu Beginn der Abfrageauswertung zurück.
current_timestamp() Gibt den aktuellen Zeitstempel zu Beginn der Abfrageauswertung zurück.
current_timezone() Gibt die lokale Zeitzone der aktuellen Sitzung zurück.
date(expr) Wandelt den Wert expr in einen DATE-Wert um.
date_add(startDate,numDays) Gibt das Datum zurück, das numDays nach dem startDate liegt.
date_add(unit, value, expr) Fügt valueuniten zu einem Zeitstempel expr hinzu.
date_diff(unit, start, stop) Gibt den Unterschied zwischen zwei Zeitstempeln zurück, die in units gemessen werden.
date_format(expr,fmt) Konvertiert einen Zeitstempel in eine Zeichenfolge im Format fmt
date_from_unix_date(days) Erstellt ein Datum aus der Anzahl von Tagen seit 1970-01-01.
date_part(field,expr) Extrahiert einen Teil des Datums, Zeitstempels oder Intervalls
date_sub(startDate,numDays) Gibt das Datum zurück, das numDays vor dem startDate liegt.
date_trunc(unit,expr) Gibt den Zeitstempel zurück, der auf die in unit angegebene Einheit abgeschnitten wurde.
dateadd(startDate,numDays) Gibt das Datum zurück, das numDays nach dem startDate liegt.
dateadd(unit, value, expr) Fügt valueuniten zu einem Zeitstempel expr hinzu.
datediff(endDate,startDate) Die Funktion gibt die Anzahl der Tage von startDate bis endDate zurück.
datediff(unit, start, stop) Gibt den Unterschied zwischen zwei Zeitstempeln zurück, die in units gemessen werden.
day(expr) Die Funktion gibt den Tag des Monats des Datums oder Zeitstempels zurück.
dayofmonth(expr) Die Funktion gibt den Tag des Monats des Datums oder Zeitstempels zurück.
dayofweek(expr) Gibt den Wochentag des Datums oder Zeitstempels zurück.
dayofyear(expr) Gibt den Kalendertag des Datums oder Zeitstempels zurück
divisor div dividend Gibt den ganzzahligen Teil der Division des Intervalls divisor durch das Intervall dividend zurück.
extract(field FROM source) Gibt field von source zurück.
from_unixtime(unixTime,fmt) Gibt unixTime in fmt zurück.
from_utc_timestamp(expr,timezone) Gibt einen Zeitstempel in expr zurück, der in UTC in der Zeitzone timeZone angegeben wird.
getdate() Gibt den aktuellen Zeitstempel zu Beginn der Abfrageauswertung zurück.
hour(expr) Gibt die Stundenkomponente eines Zeitstempels zurück.
last_day(expr) Gibt den letzten Tag des Monats zurück, zu dem das Datum gehört.
make_date(year,month,day) Erstellt ein Datum aus den Feldern year, month und day.
make_dt_interval([days[, hours[, mins[, secs]]]]) Erzeugt ein Tageszeitintervall aus days, hours, mins und secs.
make_interval(years, months, weeks, days, hours, mins, secs) Veraltet: Erstellt ein Intervall aus years, months, weeks, days, hours, mins und secs.
make_timestamp(year,month,day,hour,min,sec[,timezone]) Erstellt einen Zeitstempel aus den Feldern year, month, day, hour, min, sec und timezone.
make_ym_interval([years[, months]]) Erstellt ein Jahr-Monat-Intervall aus years und months.
minute(expr) Gibt die Minutenkomponente des Zeitstempels in expr zurück.
month(expr) Gibt die Monatskomponente des Zeitstempels in expr zurück.
months_between(expr1,expr2[,roundOff]) Gibt die Anzahl der Monate zurück, die zwischen den Datumsangaben oder Zeitstempeln in expr1 und expr2 verstrichen sind.
next_day(expr,dayOfWeek) Gibt das erste Datum zurück, das nach expr liegt und wie in dayOfWeek benannt ist.
now() Gibt den aktuellen Zeitstempel zu Beginn der Abfrageauswertung zurück.
quarter(expr) Gibt das Quartal des Jahres für expr im Bereich von 1 bis 4 zurück.
second(expr) Gibt die Sekundenkomponente des Zeitstempels in expr zurück.
session_window(expr, gpDuration) Erstellt ein Sitzungsfenster über einen TIMESTAMP-Ausdruck.
sign(expr) Gibt -1.0, 0.0 oder 1.0 als Intervall zurück, wenn expr negativ, 0 oder positiv ist.
signum(expr) Gibt -1.0, 0.0 oder 1.0 als Intervall zurück, wenn expr negativ, 0 oder positiv ist.
timediff(unit, start, stop) Gibt den Unterschied zwischen zwei Zeitstempeln zurück, die in units gemessen werden.
timestamp(expr) Wandelt expr in TIMESTAMP um.
timestamp_micros(expr) Erstellt Mikrosekunden nach der UTC-Epoche einen timestamp-expr
timestamp_millis(expr) Erstellt einen Zeitstempelausdruck (expr) in Millisekunden seit der UTC-Epoche.
timestamp_seconds(expr) Erstellt einen Zeitstempelausdruck (expr) in Sekunden seit der UTC-Epoche.
timestampadd(unit, value, expr) Fügt valueuniten zu einem Zeitstempel expr hinzu.
timestampdiff(unit, start, stop) Gibt den Unterschied zwischen zwei Zeitstempeln zurück, die in units gemessen werden.
to_date(expr[,fmt]) Gibt expr umgewandelt in ein Datum unter Verwendung einer optionalen Formatierung zurück
to_timestamp(expr[,fmt]) Gibt expr umgewandelt in einen Zeitstempel unter Verwendung einer optionalen Formatierung zurück.
to_unix_timestamp(expr[,fmt]) Gibt den Zeitstempel in expr als UNIX-Zeitstempel zurück.
to_utc_timestamp(expr,timezone) Gibt den Zeitstempel in expr in einer anderen Zeitzone als UTC zurück.
trunc(expr, fmt) Gibt ein Datum zurück, bei dem ein Teil des Datums auf die durch das Formatmodell fmt angegebene Einheit abgeschnitten wurde.
try_add(expr1, expr2) Gibt die Summe von expr1 und expr2 oder bei einem Fehler NULL zurück.
try_divide(dividend, divisor) Gibt dividend dividiert durch divisor zurück oder NULL, wenn divisor 0 ist.
try_multiply(multiplier, multiplicand) Gibt multiplier multipliziert mit multiplicand oder NULL im Überlauf zurück.
try_subtract(expr1, expr2) Gibt die Subtraktion von expr2 aus expr1 oder NULL im Überlauf zurück.
try_to_timestamp(expr[,fmt]) Gibt eine expr-Umwandlung in einen Zeitstempel unter Verwendung einer optionalen Formatierung oder NULL zurück, wenn die Umwandlung fehlschlägt.
unix_date(expr) Gibt die Anzahl der Tage seit 1970-01-01 zurück.
unix_micros(expr) Gibt die Anzahl der Mikrosekunden seit 1970-01-01 00:00:00 UTC zurück.
unix_millis(expr) Gibt die Anzahl der Millisekunden seit 1970-01-01 00:00:00 UTC zurück.
unix_seconds(expr) Gibt die Anzahl der Sekunden seit 1970-01-01 00:00:00 UTC zurück.
unix_timestamp([expr[, fmt]]) Gibt den UNIX-Zeitstempel der aktuellen oder angegebenen Zeit zurück.
weekday(expr) Gibt den Tag der Woche von expr zurück.
weekofyear(expr) Gibt die Woche des Jahres von expr zurück.
year(expr) Gibt die Jahreskomponente von expr zurück.
window(expr, width[, step[, start]]) Erstellt ein Hopping-basiertes gleitendes Fenster über einen TIMESTAMP-Ausdruck.
window_time(window) Gibt die inklusive Endzeit einer sliding-window-Funktion zurück, die von den window- oder session_window-Funktionen erstellt wird.

H3 geospatiale Funktionen

Informationen zu H3-Geodatenfunktionen finden Sie unter H3-Geodatenfunktionen.

Umwandlungsfunktionen und Konstruktoren

Informationen zur Umwandlung zwischen Typen finden Sie unter cast-Funktion und try_cast-Funktion.

Funktion BESCHREIBUNG
array([expr [, …]]) Gibt ein Array mit den Elementen in expr zurück.
bigint(expr) Wandelt den Wert expr in BIGINT um.
binary(expr) Wandelt den Wert expr in BINARY um.
boolean(expr) Wandelt expr in BOOLEAN um.
cast(expr AS type) Wandelt den Wert expr in den Zieldatentyp type um.
expr :: type Wandelt den Wert expr in den Zieldatentyp type um.
date(expr) Wandelt den Wert expr in DATE um.
decimal(expr) Wandelt den Wert expr in DECIMAL um.
double(expr) Wandelt den Wert expr in DOUBLE um.
float(expr) Wandelt den Wert expr in FLOAT um.
int(expr) Wandelt den Wert expr in INTEGER um.
make_date(year,month,day) Erstellt ein Datum aus den Feldern year, month und day.
make_dt_interval([days[, hours[, mins[, secs]]]]) Erzeugt ein Tageszeitintervall aus days, hours, mins und secs.
make_interval(years, months, weeks, days, hours, mins, secs) Erstellt ein Intervall aus years, months, weeks, days, hours, mins und secs.
make_timestamp(year,month,day,hour,min,sec[,timezone]) Erstellt einen Zeitstempel aus den Feldern year, month, day, hour, min, sec und timezone.
make_ym_interval([years[, months]]) Erstellt ein Jahr-Monat-Intervall aus years und months.
map([{key1, value1} [, …]]) Erstellt eine Zuordnung mit den angegebenen Schlüssel-Wert-Paaren.
named_struct({name1, val1} [, …]) Erstellt eine Struktur mit den angegebenen Feldnamen und Werten.
smallint(expr) Wandelt den Wert expr in SMALLINT um.
string(expr) Wandelt den Wert expr in STRING um.
struct(expr1 [, …]) Erstellt einen STRUCT mit den angegebenen Feldwerten.
tinyint(expr) Wandelt expr in TINYINT um.
timestamp(expr) Wandelt expr in TIMESTAMP um.
to_char(expr, fmt) Gibt expr zurück, das in einen STRING umgewandelt wurde (mithilfe der Formatierung fmt).
to_date(expr[,fmt]) Gibt expr umgewandelt in ein Datum unter Verwendung einer optionalen Formatierung zurück
to_number(expr, fmt) Gibt expr nach Umwandlung in DECIMAL (mithilfe der Formatierung fmt) zurück.
to_timestamp(expr[,fmt]) Gibt expr umgewandelt in einen Zeitstempel unter Verwendung einer optionalen Formatierung zurück.
to_varchar(expr, fmt) Gibt expr zurück, das in einen STRING umgewandelt wurde (mithilfe der Formatierung fmt).
try_cast(expr AS type) Wandelt den Wert expr sicher in den Zieldatentyp type um.
try_to_number(expr, fmt) Gibt expr nach Umwandlung in DECIMAL (mithilfe der Formatierung fmt oder NULL, wenn expr ungültig ist) zurück.

CSV-Funktionen

Funktion BESCHREIBUNG
from_csv(csvStr, schema[, options]) Gibt einen Strukturwert mit csvStr und schema zurück.
schema_of_csv(csv[, options]) Gibt das Schema einer CSV-Zeichenfolge im DDL-Format zurück.
to_csv(expr[, options]) Gibt eine CSV-Zeichenfolge mit dem angegebenen Strukturwert zurück.

JSON-Funktionen

Funktion BESCHREIBUNG
jsonStr : jsonPath Gibt aus jsonStr extrahierte Felder zurück.
from_json(jsonStr, schema[, options]) Gibt einen Strukturwert mit jsonStr und schema zurück.
get_json_object(expr, path) Extrahiert ein JSON-Objekt aus path.
json_array_length(jsonArray) Gibt die Anzahl der Elemente im äußersten JSON-Array zurück.
json_object_keys(jsonObject) Gibt alle Schlüssel des äußersten JSON-Objekts als Array zurück.
json_tuple(jsonStr, path1 [, …]) Gibt mehrere JSON-Objekte als Tupel zurück.
schema_of_json(jsonStr[, options]) Gibt das Schema einer JSON-Zeichenfolge im DDL-Format zurück.
schema_of_json_agg(jsonStr[, options]) Gibt das kombinierte Schema von JSON-Zeichenfolgen in einer Gruppe im DDL-Format zurück.
to_json(expr[, options]) Gibt eine JSON-Zeichenfolge mit der in expr angegebenen Struktur zurück.

XPath- und XML-Funktionen

Function Beschreibung
from_xml(xmlStr, schema[, options]) Gibt einen Strukturwert zurück, der mithilfe von schema aus xmlStr analysiert wird.
schema_of_xml(xmlStr[, options]) Gibt das Schema einer XML-Zeichenfolge im DDL-Format zurück.
xpath(xml, xpath) Gibt Werte in den Knoten von xml zurück, die mit xpath übereinstimmen.
xpath_boolean(xml, xpath) Gibt true zurück, wenn der xpath-Ausdruck als true ausgewertet oder ein übereinstimmender Knoten in xml gefunden wird.
xpath_double(xml, xpath) Gibt einen DOUBLE-Wert aus einem XML-Dokument zurück.
xpath_float(xml, xpath) Gibt einen FLOAT-Wert aus einem XML-Dokument zurück.
xpath_int(xml, xpath) Gibt einen INTEGER-Wert aus einem XML-Dokument zurück.
xpath_long(xml, xpath) Gibt einen BIGINT-Wert aus einem XML-Dokument zurück.
xpath_number(xml, xpath) Gibt einen DOUBLE-Wert aus einem XML-Dokument zurück.
xpath_short(xml, xpath) Gibt einen SHORT-Wert aus einem XML-Dokument zurück.
xpath_string(xml, xpath) Gibt den Inhalt des ersten XML-Knotens zurück, der mit dem XPath-Ausdruck übereinstimmt.

KI-Funktionen

Funktion Beschreibung
ai_analyze_sentiment(content) Gibt die Stimmung eines Texts zurück
ai_classify(content, labels) Klassifiziert den bereitgestellten Inhalt mit einer der bereitgestellten Bezeichnungen
ai_extract(content, labels) Extrahiert Entitäten, die durch Beschriftungen aus einem bestimmten Text angegeben werden
ai_fix_grammar(content) Korrigiert Grammatikfehler in einem bestimmten Text
ai_gen(content) Ruft ein hochmodernes Modell für generative KI aus den Basismodell-APIs von Databricks auf, um den Benutzerprompt zu beantworten
ai_generate_text(prompt, modelName[, param1, value1] […]) Veraltet: Gibt Text zurück, der von einem ausgewählten großen Sprachmodell (Large Language Model, LLM) aufgrund des Prompts generiert wurde.
ai_mask(content, labels) Maskiert angegebene Entitäten innerhalb eines bestimmten Texts
ai_query(endpointName, request, returnType) Ruft einen vorhandenen Databricks Model Serving-Endpunkt auf, parst ihn und gibt seine Antwort zurück.
ai_similarity(strExpr1, strExpr2) Vergleicht zwei Zeichenfolgen und berechnet den Score der semantischen Ähnlichkeit
ai_summarize(content[, max_words]) Generiert die Zusammenfassung eines bestimmten Texts
ai_translate(content, to_lang) Übersetzt Text in die angegebene Zielsprache

Lesefunktionen

Funktion BESCHREIBUNG
read_files(path, [optionKey => optionValue] [, …]) Liest Datendateien im Cloudspeicher und gibt sie in Tabellenform zurück.
read_kafka([optionKey => optionValue] [, …]) Liest Datensätze aus einem Apache Kafka-Cluster und gibt sie in Tabellenform zurück.
read_kinesis({parameter => value} [, …]) Gibt eine Tabelle mit Datensätzen zurück, die aus Kinesis aus einem oder mehreren Streams gelesen werden.
read_pubsub([parameter => value] [, …]) Eine Tabellenwertfunktion zum Lesen von Datensätzen aus Pub/Sub aus einem Thema.
read_pulsar({optionKey => optionValue} [, …]) Gibt eine Tabelle mit aus Pulsar gelesenen Datensätzen zurück.
read_state_metadata(path) Gibt eine Tabelle mit Zeilen zurück, die die Metadaten eines Streamingabfragestatus darstellen.
read_statestore(path [, option_key => option_value] […]) Gibt Datensätze aus dem Statusspeicher von Streamingabfragen zurück.

Sonstige Funktionen

Funktion BESCHREIBUNG
assert_true(expr) Gibt einen Fehler zurück, wenn expr nicht TRUE ist.
CASE expr { WHEN opt1 THEN res1 } […] [ELSE def] END Gibt resN für das erste optN-Element zurück, das gleich expr ist, oder def, wenn keine Übereinstimmung gefunden wird.
CASE { WHEN cond1 THEN res1 } […] [ELSE def] END Gibt resN für das erste condN-Element zurück, das als TRUE ausgewertet wird, oder def, wenn kein solches Element gefunden wurde.
cloud_files_state( { TABLE(table) | checkpoint } )
coalesce(expr1, expr2 [, …]) Gibt das erste Argument zurück, das ungleich NULL ist.
cube (expr1 [, …]) Erstellt einen mehrdimensionalen Cube unter Verwendung der angegebenen Ausdrucksspalten.
current_catalog() Diese Funktion gibt den aktuellen Katalog zurück.
current_database() Gibt das aktuelle Schema zurück.
current_metastore() Gibt die aktuelle Unity Catalog Metastore-ID zurück.
current_recipient(key) Gibt eine Eigenschaft für den aktuellen Empfänger in einer Ansicht zurück, die für Delta Sharing freigegeben ist.
current_schema() Gibt das aktuelle Schema zurück.
current_user() Gibt den Benutzer zurück, der die Anweisung ausführt.
current_version() Gibt die aktuelle Version von Azure Databricks zurück.
decode(expr, { key, value } [, …] [,defValue]) Gibt den Wert zurück, der dem Schlüssel entspricht.
elt(index, expr1 [, …] ) Gibt den n-ten Ausdruck zurück.
equal_null(expr1, expr2) Gibt true zurück, wenn expr1 entsprechend expr2 gleicht oder andernfalls beide Ausdrücke NULL oder false sind.
event_log( { TABLE(table) | pipeline_id } )
greatest(expr1, expr2 [, …]) Gibt den größten Wert aller Argumente zurück, wobei NULL-Werte übersprungen werden.
grouping(col) Gibt an, ob eine angegebene Spalte in einem GROUPING SET-, ROLLUP- oder CUBE-Element eine Zwischensumme darstellt
grouping_id([col1 [, …]]) Gibt die Gruppierungsebene für eine Gruppe von Spalten zurück.
hash(expr1 [, …]) Gibt einen Hashwert der Argumente zurück.
hll_sketch_estimate(expr) Schätzt die Anzahl unterschiedlicher Werte, die in einer HyperLogLog-Skizze gesammelt wurden.
hll_union(expr1, expr2 [,allowDifferentLgConfigK]) Kombiniert zwei HyperLogLog-Skizzen.
java_method(class, method[, arg1 [, …]]) Ruft eine Methode mit Reflexion auf.
if(cond, expr1, expr2) Gibt expr1 zurück, wenn condtrue ist, andernfalls expr2
iff(cond, expr1, expr2) Gibt expr1 zurück, wenn condtrue ist, andernfalls expr2
ifnull(expr1, expr2) Gibt expr2 zurück, wenn expr1NULL ist, andernfalls expr1
input_file_block_length() Gibt die Länge des gelesenen Blocks in Bytes zurück
input_file_block_start() Gibt den Startoffset des gelesenen Blocks in Bytes zurück.
input_file_name() Gibt den Namen der gelesenen Datei zurück, oder eine leere Zeichenfolge, sofern nicht verfügbar.
is_account_group_member(group) Gibt true zurück, wenn der aktuelle Benutzer ein Mitglied der Gruppe auf Kontoebene ist.
is_member(group) Gibt true zurück, wenn der aktuelle Benutzer ein Mitglied der Gruppe auf Arbeitsbereichsebene ist.
isnull(expr) Gibt true zurück, wenn expr gleich NULL ist.
isnotnull(expr) Gibt true zurück, wenn expr nicht NULL ist.
least(expr1, expr2 [, …]) Gibt den kleinsten Wert aller Argumente zurück, wobei NULL-Werte übersprungen werden.
list_secrets() Gibt die Schlüssel, die der Benutzer anzeigen darf, aus dem Databricks-Geheimnisdienst zurück.
luhn_check(numStr) Gibt true zurück, wenn numStr die Luhn-Algorithmusprüfung besteht.
monotonically_increasing_id() Gibt monoton ansteigende 64-Bit-Integerwerte zurück.
nullif(expr1, expr2) Gibt NULL zurück, wenn expr1 gleich expr2 ist, andernfalls expr1.
nvl(expr1, expr2) Gibt expr2 zurück, wenn expr1NULL ist, andernfalls expr1
nvl2(expr1, expr2, expr3) Gibt expr2 zurück, wenn expr1 nicht NULL ist, andernfalls expr3.
raise_error(expr) Löst eine Ausnahme mit expr als Meldung aus.
range(end) Gibt eine Tabelle mit Werten innerhalb eines angegebenen Bereichs zurück.
range(start, end [, step [, numParts]]) Gibt eine Tabelle mit Werten innerhalb eines angegebenen Bereichs zurück.
reflect(class, method[, arg1 [, …]]) Ruft eine Methode mit Reflexion auf.
secret(scope, key) Extrahiert einen Geheimniswert mit dem angegebenen scope- und key-Element aus dem Databricks-Geheimnisdienst.
session_user() Gibt den Benutzer zurück, der mit Azure Databricks verbunden ist.
spark_partition_id() Gibt die aktuelle Partitions-ID zurück.
sql_keywords() Gibt den Satz von SQL-Schlüsselwörtern in Azure Databricks zurück.
stack(numRows, expr1 [, …]) Trennt expr1, ..., exprN in numRows Zeilen.
table_changes(table_str, start [, end]) Gibt ein Protokoll von Änderungen an eine Delta Lake-Tabelle mit aktiviertem Datenänderungsfeed zurück.
try_reflect(class, method[, arg1 [, …]]) Ruft eine Methode mit Spiegelung auf und gibt NULL zurück, wenn bei der Methode ein Fehler auftritt.
typeof(expr) Gibt eine DDL-formatierte Typzeichenfolge für den Datentyp des expr zurück.
user() Gibt den Benutzer zurück, der die Anweisung ausführt.
uuid() Gibt eine UUID-Zeichenfolge (Universally Unique Identifier) zurück.
window(expr, width[, step [, start]]) Erstellt ein Hopping-basiertes gleitendes Fenster über einen TIMESTAMP-Ausdruck.
xxhash64(expr1 [, …]) Gibt einen 64-Bit-Hashwert der Argumente zurück.
version() Gibt die Apache Spark-Version zurück.