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.
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 expr n -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 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 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 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 value unit en zu einem Zeitstempel 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 value unit en 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 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 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 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 value unit en zu einem Zeitstempel 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 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 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-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 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() | 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 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. |
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. |