Integrierte Funktionen
Gilt für: Databricks SQL 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.
Für Anwendungsfälle, die von vorhandenen integrierten Funktionen nicht unterstützt werden, sollten Sie eine benutzerdefinierte Funktion definieren. Siehe Was sind benutzerdefinierte Funktionen (UDFs, User Defined Functions)?.
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. |
und | 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 an 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. |
?:: | expr ?:: type |
Überführt den Wert expr in den Zieldatentyp type , wenn möglich, andernfalls wird NULL zurückgegeben. |
div | dividend div divisor |
Gibt den ganzzahligen Teil der Division von dividend durch divisor 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 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 true zurück, wenn expr STRING oder BINARY subExpr enthält. |
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 true zurück, wenn expr STRING oder BINARY mit endExpr endet. |
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, in der expr n -mal wiederholt wird. |
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 true zurück, wenn expr STRING oder BINARY mit startExpr beginnt. |
string(expr) | Wandelt den Wert 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. |
try_url_decode(str) | Übersetzt einen String aus dem Format application/x-www-form-urlencoded zurück und gibt im Fall eines Fehlers NULL zurück. |
try_zstd_decompress(value) | Gibt den mit der Zstandard-Komprimierung komprimierten Wert 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 expr -Wert 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. |
zstd_compress (Wert[,Level[,streaming_mode]]) | Gibt den mit der Zstandard-Komprimierung komprimierten Wert zurück. |
zstd_decompress(value) | Gibt den mit der Zstandard-Komprimierung komprimierten Wert 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 BIGINT 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 von der Zeitzone sourceTz 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 DECIMAL 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 DOUBLE 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 FLOAT 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 INTEGER 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. |
'nullifzero(ausdruck)' | Gibt zurück expr , wenn sie nicht null oder NULL anderweitig ist. |
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 zurück. |
round(expr[,targetScale]) | Gibt expr gerundet mit dem HALF_UP -Rundungsmodus zurück. |
sec(expr) | Gibt den Sekans 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 |
sin(expr) | Gibt den Sinus von expr zurück. |
sinh(expr) | Gibt den hyperbolischen Sinus von expr zurück. |
smallint(expr) | Wandelt den Wert expr in SMALLINT 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 TINYINT um. |
to_number(expr, fmt) | Gibt expr zurück, das in eine DECIMAL umgewandelt wurde (mithilfe der Formatierung fmt ). |
try_add(expr1, expr2) | Gibt die Summe von expr1 und expr2 zurück oder NULL bei einem Fehler. |
try_divide(dividend, divisor) | Gibt dividend dividiert durch divisor zurück oder NULL wenn divisor 0 (null) ist. |
try_mod(Dividend, Divisor) | Gibt den Rest nach dividend / divisor zurück oder NULL , wenn divisor 0 (null) 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 die expr -Umwandlung in DECIMAL mit der Formatierung fmt zurück oder NULL , wenn expr nicht mit dem Format übereinstimmt. |
width_bucket(expr, minExpr, maxExpr, numBuckets) | Gibt die Bucketnummer für einen Wert in einem Histogramm mit gleicher Breite zurück. |
'zeroifnull(expr)' | Gibt zurück expr , wenn sie nicht NULL oder 0 anderweitig ist. |
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. |
histogram_numeric(Ausdruck,numBins) | Berechnet ein Histogramm auf expr mit numBins Bins, wobei ein Array von Paaren zurückgegeben wird, das die Bin-Mittelpunkte darstellt. |
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 NOT NULL sind. |
regr_avgy(yExpr, xExpr) | Gibt den Mittelwert aus yExpr aus den Werten einer Gruppe zurück, in der xExpr und yExpr NOT NULL sind. |
regr_count(yExpr, xExpr) | Gibt die Anzahl von Nicht-Null-Wertpaaren yExpr xExpr 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 NOT 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. |
schema_of_variant_agg(variantExpr) | Gibt das kombinierte Schema von allen VARIANT -Werten 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 aus Werten einer Gruppe zurück oder NULL , wenn ein Überlauf auftritt. |
try_sum(expr) | Gibt die Summe der Werte einer Gruppe zurück oder NULL , 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 arrayExpr zurü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 array value 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 element count -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 mehrere Instanzen von value unit zu einem Zeitstempelausdruck (expr ) hinzu. |
date_diff(unit, start, stop) | Gibt den Unterschied zwischen zwei Zeitstempeln zurück, die in unit s 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 mehrere Instanzen von value unit zu einem Zeitstempelausdruck (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 unit s 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 den Zeitstempel für einen Zeitstempel expr bei UTC timeZone . |
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 unit s 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 mehrere Instanzen von value unit zu einem Zeitstempelausdruck (expr ) hinzu. |
timestampdiff(unit, start, stop) | Gibt den Unterschied zwischen zwei Zeitstempeln zurück, die in unit s 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 für einen Zeitstempel expr bei UTC timezone . |
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 DECIMA L (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- und Avro-Funktionen
Funktion | Beschreibung |
---|---|
from_avro(avroBin, jsonSchema[, options]) | Gibt einen Strukturwert basierend auf avroBin und jsonSchema zurück. |
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_avro(Ausdruck[, Optionen]) | Gibt einen Avro-Binärwert mit dem angegebenen Strukturwert 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. |
parse_json(jsonStr) | Gibt einen VARIANT -Wert von jsonStr 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 zurück, wobei STRUCT oder VARIANT in expr angegeben ist. |
VARIANT-Funktionen
Funktion | Beschreibung |
---|---|
variantExpr : jsonPath | Gibt aus variantExpr extrahierte Felder mit dem JSON-Pfad zurück. |
is_variant_null(variantExpr) | Prüft, ob variantExpr NULL mit VARIANT -Kodierung ist. |
parse_json(jsonStr) | Gibt einen VARIANT -Wert von jsonStr zurück. |
schema_of_variant(variantExpr) | Gibt das Schema eines VARIANT -Ausdrucks im DDL-Format zurück. |
schema_of_variant_agg(variantExpr) | Gibt das kombinierte Schema von allen VARIANT -Werten in einer Gruppe im DDL-Format zurück. |
to_json(expr[, options]) | Gibt eine JSON-Zeichenfolge zurück, wobei STRUCT oder VARIANT in expr angegeben ist. |
try_parse_json(jsonStr) | Gibt einen VARIANT -Wert von jsonStr zurück, sofern möglich. Wenn dies nicht möglich ist, wird NULL zurückgegeben. |
try_variant_get(variantExpr,path,type) | Extrahiert einen Wert vom Typ type aus variantExpr , angegeben von path , oder NULL , wenn eine Umwandlung in den Zieltyp nicht möglich ist. |
variant_explode(variantExpr) | Gibt eine Reihe von Zeilen zurück, indem sie die Schachtelung von variantExpr aufheben. |
variant_explode_outer(variantExpr) | Gibt Zeilen zurück, indem die Schachtelung von variantExpr mithilfe von äußerer Semantik aufgehoben wird. |
variant_get(variantExpr,path,type) | Extrahiert einen Wert des Typs type aus variantExpr , von path angegeben. |
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_forecast(observed, time_col) | Leitet Zeitreihendaten für die Zukunft ab |
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 Mosaic AI Model Serving-Endpunkt auf, analysiert 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 |
vector_search(index, query, num_results) | Abfragen eines Mosaik AI-Vektorsuche-Index mit SQL |
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 } ) | Gibt den Status einer cloud_files -Quelle des Autoloader auf Dateiebene zurück. |
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 } ) | Gibt eine Tabelle mit dem Aktualisierungsverlauf für eine materialisierte Sicht, eine Streaming-Tabelle oder eine DLT-Pipeline zurück. |
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 cond true ist, andernfalls expr2 |
iff(cond, expr1, expr2) | Gibt expr1 zurück, wenn cond true ist, andernfalls expr2 |
ifnull(expr1, expr2) | Gibt expr2 zurück, wenn expr1 NULL 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([scopeStr]) | Gibt die Schlüssel aus allen Bereichen oder einem Bereich zurück, die der Benutzer aus dem Databricks-Dienst für Geheimnisse anzeigen darf. |
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 expr1 NULL 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. |
try_secret(scope, key) | Extrahiert einen Geheimniswert mit dem angegebenen scope - und key -Element aus dem Databricks-Geheimnisdienst, oder NULL , wenn der Schlüssel nicht abgerufen werden kann. |
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. |