Udostępnij za pośrednictwem


Funkcje wbudowane

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

W tym artykule przedstawiono linki do wbudowanych operatorów i funkcji dla ciągów i typów binarnych, skalarów liczbowych, agregacji, okien, tablic, map, dat i sygnatur czasowych, rzutowania, danych CSV, danych JSON, manipulacji XPath i innych różnych funkcji.

W przypadku przypadków użycia, które nie są obsługiwane przez istniejące wbudowane funkcje, rozważ zdefiniowanie funkcji niestandardowej. Zobacz Co to są funkcje zdefiniowane przez użytkownika (UDF)?.

Zobacz również:

Operatory i predykaty

Aby uzyskać informacje na temat analizowania operatorów względem siebie, zobacz Precedencja operatorów.

Obsługujący Składnia opis
& expr1 & expr2 Zwraca bitowe AND wartości expr1 i expr2.
i expr1 and expr2 Zwraca wartość logiczną AND, oraz expr1 i expr2.
* multiplier * multiplicand Zwraca multiplier pomnożone przez multiplicand.
!= expr1 != expr2 Zwraca wartość true, jeśli expr1 nie jest równa expr2, lub false w przeciwnym razie.
! !expr Zwraca wartość logiczną NOT wyrażenia logicznego.
między expr1 [not] between expr2 and expr2 Sprawdza, czy expr1 jest większa lub równa expr2 oraz mniejsza lub równa expr3.
[] arrayExpr [ indexExpr ] Zwraca indexExprdrugi element ARRAYarrayExpr.
[] mapExpr [ keyExpr ] Zwraca wartość w keyExpr z MAPmapExpr.
^ expr1 ^ expr2 Zwraca bitowe wartości wykluczające OR (XOR) wartości expr1 i expr2.
: jsonStr : jsonPath Zwraca pola wyodrębnione z obiektu jsonStr.
:: expr :: type Rzutuje wartość expr na docelowy typ danych type.
?:: expr ?:: type Rzutuje wartość expr na docelowy typ danych type, jeśli to możliwe, zwraca NULL w przeciwnym wypadku.
Div dividend div divisor Zwraca całkowitą część z dzielenia dividend przez divisor.
. mapExpr . keyIdentifier MAP Zwraca wartość według keyIdentifier.
. structExpr . fieldIdentifier STRUCT Zwraca pole według fieldIdentifier.
== expr1 == expr2 Zwraca true, jeśli expr1 równa się expr2, lub false w przeciwnym razie.
= expr1 = expr2 Zwraca true, jeśli expr1 równa się expr2, lub false w przeciwnym razie.
>= expr1 >= expr2 Zwraca true, jeśli expr1 jest większe lub równe expr2, lub false w przeciwnym razie.
> expr1 > expr2 Zwraca wartość true , jeśli expr1 jest większa niż expr2, lub false w przeciwnym razie.
Istnieje exists(query) Zwraca true, jeśli query zwraca co najmniej jeden wiersz, lub false w przeciwnym razie.
ilike str [not] ilike (pattern[ESCAPE escape]) Zwraca wartość true, jeśli str (nie) jest zgodna pattern z escape bez uwzględniania wielkości liter.
ilike str [not] ilike {ANY\|SOME\|ALL}([pattern[, ...]]) Zwraca wartość true, jeśli str (nie) pasuje do żadnego/wszystkich wzorców bez uwzględniania wielkości liter.
w elem [not] in (expr1[, ...]) Zwraca wartość true , jeśli elem wartość nie jest równa dowolnej exprNwartości .
w elem [not] in (query) Zwraca true, jeśli elem jest (nie) równe z żadnym wierszem w query.
jest odrębna expr1 is [not] distinct from expr2 Sprawdza, czy argumenty mają różne wartości, gdzie NULL są uznawane za porównywalne wartości.
jest fałszywy expr is [not] false Sprawdza, czy expr jest (nie) false.
ma wartość null expr is [not] null Zwraca true, jeśli expr (nie) jest NULL.
jest prawda expr is [not] true Sprawdza, czy expr jest (nie) true.
lubić str [not] like (pattern[ESCAPE escape]) Zwraca true, jeśli str (nie) jest zgodny z pattern przy użyciu escape.
lubić str [not] like {ANY\|SOME\|ALL}([pattern[, ...]]) Zwraca wartość true, jeśli str nie jest zgodna z żadnym/wszystkimi wzorcami.
<=> expr1 <=> expr2 Zwraca ten sam wynik co EQUAL(=) dla wartości innych niż null, ale zwraca true jeśli oba są NULL wartościami, false jeśli jeden z nich to NULL.
<= expr1 <= expr2 Zwraca true, jeśli expr1 jest mniejsze lub równe expr2, lub false w przeciwnym razie.
<> expr1 <> expr2 Zwraca wartość true , jeśli expr1 nie jest równa expr2, lub false w inny sposób.
< expr1 < expr2 Zwraca true, jeśli expr1 jest mniejsza niż expr2, lub false w przeciwnym razie.
- expr1 - expr2 Zwraca różnicę wartości expr2 od expr1.
nie not expr Zwraca wartość logiczną NOT wyrażenia logicznego.
lub expr1 or expr2 Zwraca wartość logiczną OR, oraz expr1 i expr2.
% dividend % divisor Zwraca resztę po dividend / divisor.
|| expr1 \|\| expr2 Zwraca łączenie elementów expr1 i expr2.
| expr1 \| expr2 Zwraca bitowe OR wartości expr1 i expr2.
+ expr1 + expr2 Zwraca sumę wartości expr1 i expr2.
regexp str [not] regexp regex Zwraca wartość true, jeśli str (nie) jest zgodny z regex.
regexp_like str [not] regexp_like regex Zwraca wartość true, jeśli str (nie) jest zgodny z regex.
rlike str [not] rlike regex Zwraca wartość true, jeśli str (nie) jest zgodny z regex.
/ dividend / divisor Zwraca wartość dividend podzieloną przez divisor.
~ ~ expr Zwraca wynik bitowy NOT z expr.

Kolejność wykonywania działań

Pierwszeństwo Obsługujący
1 :, , ::, , ?::[ ]
2 -(jednoargumentowy), +(jednoargumentowy), ~
3 *, , /, , %div
4 +, , -\|\|
5 &
6 ^
7 \|
8 =, ==, , <=>, <>!=, <, , <=>>=
9 not, exists
10 between, in, , rlike, regexpilike, , like, , is [not] [NULL, true, false]is [not] distinct from
11 and
12 or

Funkcje ciągowe i binarne

Funkcja opis
wyrażenie1 || wyrażenie2 Zwraca łączenie elementów expr1 i expr2.
aes_decrypt(wyrazenie, klucz[, tryb[, wypełnienie[, aad]]]) Odszyfrowuje dane binarne expr przy użyciu szyfrowania AES.
aes_encrypt(wyrażenie, klucz[, tryb[, wypełnienie[, iv[, aad]]]) Szyfruje dane binarne expr przy użyciu szyfrowania AES.
ascii(str) Zwraca punkt kodu ASCII pierwszego znaku str.
base64(wyrażenie) Konwertuje expr na podstawowy ciąg 64.
bin(wyrażenie) Zwraca binarną reprezentację elementu expr.
binary(expr) Rzutuje wartość expr na BINARY.
bit_length (wyrażenie) Zwraca bitową długość danych ciągu lub liczbę bitów danych binarnych.
bitmap_count (wyrażenie) Zwraca liczbę bitów ustawionych w ciągu BINARY reprezentującym mapę bitową.
btrim(str [, trimStr]) Zwraca str z usuniętymi znakami wiodącymi i końcowymi.
char(wyrażenie) Zwraca znak odpowiadający podanemu punktowi kodu UTF-16.
char_length(wyrażenie) Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych.
character_length(wyrażenie) Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych.
charindex(substr, str[, pos]) Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos.
chr(wyrażenie) Zwraca znak odpowiadający podanemu punktowi kodu UTF-16.
strExpr collationName Dołącza jawne sortowanie collationName do strExpr.
kojarzenie [dla] (strExpr) Zwraca ustawienia porządkowania przypisane do strExpr.
concat(expr1, expr2[, ...]) Zwraca konkatenację argumentów.
concat_ws(sep[, expr1[, ...]]) Zwraca ciągi łączenia oddzielone ciągami sep.
contains(expr, subExpr) Zwraca true, jeśli exprSTRING lub BINARY zawiera subExpr.
crc32(wyrażenie) Zwraca cykliczną wartość sprawdzania nadmiarowości .expr
decode(expr, charSet) Tłumaczy binarny expr na łańcuch znaków przy użyciu kodowania zbioru znaków charSet.
encode(expr, charSet) Zwraca binarną reprezentację ciągu przy użyciu charSet kodowania znaków.
endswith(wyrażenie, endExpr) Zwraca true jeśli exprSTRING lub BINARY kończy się ciągiem endExpr.
znajdź_w_zestawie(searchExpr, sourceExpr) Zwraca położenie ciągu w rozdzielanej przecinkami liście ciągów.
format_number (wyrażenie, skala) Formaty takie jak expr, podobne do #,###,###.##, zaokrąglone do scale miejsc dziesiętnych.
format_number(wyraż., fmt) Formaty expr takie jak fmt.
format_string(strfmt[, obj1 [, ...]]) Zwraca sformatowany ciąg znaków według wzorca formatowania printf.
hex(wyrażenie) Konwertuje expr na szesnastkowy.
str ilike (wzorzec[ESCAPE escape]) Zwraca wartość true, jeśli str odpowiada pattern przy escape ignorowaniu wielkości liter.
initcap(wyrażenie) Zwraca expr z pierwszą literą każdego wyrazu zapisaną wielką literą.
instr(str, substr) Zwraca indeks (zaczynający się od 1) pierwszego wystąpienia substr w str.
lcase(wyrażenie) Zwraca expr z wszystkimi znakami zmienionymi na małe litery.
left(str, len) Zwraca najbardziej lewe znaki len z str.
len(wyrażenie) Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych.
długość(expr) Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych.
levenshtein(str1, str2) Zwraca odległość Levenshtein między ciągami str1 i str2.
str like (wzorzec[ESCAPE escape]) Zwraca wartość true, jeśli str jest zgodny z pattern z escape.
locate(substr, str[, pos]) Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos.
lower(expr) Zwraca expr z wszystkimi znakami zmienionymi na małe litery.
lpad(wyrażenie, len[, pad]) Zwraca expr, uzupełnione z lewej strony pad do długości len.
ltrim([trimstr,] str) Zwraca str z usuniętymi wiodącymi znakami w obrębie trimStr.
mask(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]]) Zwraca maskowaną wersję danych wejściowych str.
md5(wyrażenie) Zwraca sumę kontrolną MD5 o długości 128 bitów dla expr jako ciąg szesnastkowy.
octet_length(wyrażenie) Zwraca długość bajtów danych ciągu lub liczbę bajtów danych binarnych.
nakładka(input PLACING replace FROM pos [FOR len]) Zastępuje input na replace, który zaczyna się na pos i ma długość len.
nakładka(input PLACING replace FROM pos [FOR len]) Zastępuje input na replace, który zaczyna się na pos i ma długość len.
parse_url(url, partToExtract[, key]) Wyodrębnia fragment z elementu url.
position(subtekst, str[, pos]) Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos.
position(podtr IN str) Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos.
printf(strfmt[, obj1 [, ...]]) Zwraca sformatowany ciąg znaków według wzorca formatowania printf.
randstr(długość) Zwraca losowy ciąg znaków alfanumerycznych length.
regexp regex Zwraca wartość true, jeśli str pasuje do regex.
str regexp_like regex Zwraca wartość true, jeśli str pasuje do regex.
regexp_count(str, regexp) Zwraca liczbę razy str zgodną ze wzorcem regexp .
regexp_extract(str, regexp[, idx]) Wyodrębnia pierwszy ciąg w str, który pasuje do wyrażenia regexp i odpowiada indeksowi grupy regex.
regexp_extract_all(str, regexp[, idx]) Wyodrębnia wszystkie ciągi w str, które pasują do wyrażenia regexp i odpowiadają indeksowi grupy regex.
regexp_instr(str, regexp) Zwraca pozycję pierwszego podciągu w str, który pasuje do regexp.
regexp_replace(str, regexp, rep[, position]) Zamienia wszystkie podciągi str dopasowujące się do regexp na rep.
regexp_substr(str, regexp) Zwraca pierwszy podciąg w str, który pasuje do regexp.
repeat(wyrażenie, n) Zwraca ciąg, który powtarza się razy exprn .
replace(str, search [, replace]) Zamienia wszystkie wystąpienia elementu search na replace.
odwróć(wyrażenie) Zwraca odwrócony ciąg lub tablicę z odwrotną kolejnością elementów.
right(str, len) Zwraca najbardziej prawe len znaki z ciągu str.
str rlike regex Zwraca wartość true, jeśli str pasuje do regex.
rpad(wyrażenie, długość[, wypełnienie]) Zwraca expr, dopełniony z prawej strony elementem pad do długości len.
rtrim([trimStr,] str) Zwraca str ze usuniętymi znakami końcowymi.
zdania(str[, lang, country]) str Dzieli się na tablicę wyrazów.
sha(wyrażenie) Zwraca wartość skrótu sha1 jako szesnastkowy ciąg expr.
sha1(wyrażenie) Zwraca wartość skrótu sha1 jako szesnastkowy ciąg expr.
sha2(wyrażenie, bitLength) Zwraca sumę kontrolną rodziny SHA-2 jako ciąg szesnastkowy expr.
soundex(wyrażenie) Zwraca kod soundex ciągu tekstowego.
przestrzeń(n) Zwraca ciąg składający się ze spacji n .
split(str, regex[, limit]) str Dzieli wokół wystąpień zgodnych z regex i zwraca tablicę o maksymalnej długości limit.
split_part(str, delim, partNum) Dzieli str wokół wystąpień delim i zwraca część partNum.
startswith(wyrażenie, startExpr) Zwraca true jeśli exprSTRING lub BINARY rozpoczyna się od startExpr.
string(wyrażenie) Rzutuje wartość expr na STRING.
substr(wyrażenie, pos[, len]) Zwraca podciąg expr , który zaczyna się od pos i ma długość len.
substr(expr FROM pos[ FOR len]) Zwraca podciąg expr , który zaczyna się od pos i ma długość len.
substring(wyrażenie, pos[, len]) Zwraca podciąg expr , który zaczyna się od pos i ma długość len.
substring(wyrażenie FROM pos[ FOR len]) Zwraca podciąg expr , który zaczyna się od pos i ma długość len.
substring_index(expr, ogranicznik, liczba) Zwraca podciąg expr przed count wystąpieniem ogranicznika delim.
to_binary(wyrażenie[, fmt]) Zwraca expr, rzutowany do postaci binarnej na podstawie fmt.
to_char(numExpr, fmt) Zwraca numExpr skonwertowane na STRING z użyciem formatowania fmt.
to_varchar(numExpr, fmt) Zwraca numExpr skonwertowane na STRING z użyciem formatowania fmt.
translate(wyrażenie, od, do) Zwraca expr, w którym wszystkie znaki from zostały zamienione na znaki w to.
trim([[OBYDWA | POCZĄTKOWY | KOŃCOWY] [trimStr] FROM] str) Przycinanie znaków z ciągu.
try_aes_decrypt(expr, klucz[, tryb[, dopełnienie[, aad]]]) Odszyfrowuje dane binarne expr przy użyciu szyfrowania AES i zwraca NULL wartość w przypadku błędu.
try_to_binary(wyrażenie [, fmt]) Zwraca expr, rzutując na BINARY na podstawie fmt, lub NULL, jeśli dane wejściowe są nieprawidłowe.
try_url_decode(str) Tłumaczy ciąg z powrotem z formatu application/x-www-form-urlencoded i w przypadku błędu zwraca NULL.
try_zstd_decompress(wartość) Zwraca wartość dekompresowaną przy użyciu kompresji Zstandard lub NULL jeśli dane wejściowe są nieprawidłowe.
ucase(wyrażenie) Zwraca expr ze wszystkimi znakami zamienionymi na wielkie litery.
unbase64(wyrażenie) Zwraca zdekodowany ciąg base64 jako binarny.
unhex(wyrażenie) Konwertuje szesnastkowe expr na BINARY.
upper(expr) Zwraca expr ze wszystkimi znakami zamienionymi na wielkie litery.
url_decode(str) Tłumaczy z powrotem ciąg z formatu application/x-www-form-urlencoded.
url_encode(str) Tłumaczy ciąg do formatu application/x-www-form-urlencoded.
zstd_compress (wartość[,poziom[,streaming_mode]]) Zwraca wartość skompresowaną za pomocą Zstandard.
zstd_decompress(wartość) Zwraca wartość dekompresowaną przy użyciu kompresji Zstandard.

Funkcje skalarne liczbowe

Funkcja opis
~ wyrażenie Zwraca wynik bitowy NOT z expr.
dywidenda / dzielnik Zwraca wartość dividend podzieloną przez divisor.
wyrażenie1 | wyrażenie2 Zwraca bitowe OR wartości expr1 i expr2.
— wyrażenie Zwraca przeciwną wartość expr.
expr1 — expr2 Zwraca różnicę wartości expr2 od expr1.
+ wyrażenie Zwraca wartość expr.
expr1 + expr2 Zwraca sumę wartości expr1 i expr2.
dywidenda % dzielnik Zwraca resztę po dividend / divisor.
expr1 ^ expr2 Zwraca bitowe wartości wykluczające OR (XOR) wartości expr1 i expr2.
expr1 i expr2 Zwraca bitowe AND wartości expr1 i expr2.
mnożnik * mnożna Zwraca multiplier pomnożone przez multiplicand.
abs(wyrażenie) Zwraca wartość bezwzględną wartości liczbowej w pliku expr.
acos(wyrażenie) Zwraca odwrotny cosinus (arcus cosinus) wartości expr.
acosh(wyrażenie) Zwraca odwrotny cosinus hiperboliczny expr.
asin(wyrażenie) Zwraca odwrotny sinus (arcsinus) wartości expr.
asinh(argument) Zwraca odwrotny sinus hiperboliczny expr.
atan(wyrażenie) Zwraca odwrotny tangens (arctangent) wartości expr.
atan2(exprY, exprX) Zwraca kąt w radianach między dodatnią osią x płaszczyzny a punktem określonym przez współrzędne (exprX, exprY).
atanh(wyrażenie) Zwraca odwrotny tangens hiperboliczny liczby expr.
bigint(wyrażenie) Rzutuje wartość expr na BIGINT.
bit_count(wyrażenie) Zwraca liczbę bitów ustawionych w argumencie.
bit_get(wyrażenie, pos) Zwraca wartość bitu w binarnej reprezentacji całkowitej liczbowej.
bit_reverse(wyrażenie) Zwraca wartość uzyskaną przez odwrócenie kolejności bitów w argumencie.
bitmap_bit_position(wyrażenie) Zwraca pozycję bitową rozpoczynającą się od zera danej BIGINT liczby w segmencie.
bitmap_bucket_number(wyrażenie) Zwraca numer zasobnika mapy bitowej dla danej BIGINT liczby.
bround(expr[,targetScale]) Zwraca zaokrąglony expr przy użyciu trybu zaokrąglania HALF_EVEN.
cbrt(argument) Zwraca pierwiastek modułu .expr
ceil(expr[,targetScale]) Zwraca najmniejszą liczbę nie mniejszą niż expr, zaokrągloną w górę do targetScale miejsc po przecinku.
ceiling(expr[,docelowaSkala]) Zwraca najmniejszą liczbę nie mniejszą niż expr, zaokrągloną w górę do targetScale miejsc po przecinku.
conv(num, fromBase, toBase) Konwertuje num z fromBase na toBase.
convert_timezone([sourceTz, ]targetTz, sourceTs) Konwertuje element TIMESTAMP_NTZsourceTs ze strefy czasowej sourceTz na targetTz.
cos(wyrażenie) Zwraca cosinus wartości expr.
cosh(wyrażenie) Zwraca cosinus hiperboliczny expr.
cot(expr) Zwraca cotangent wartości expr.
csc(wyrażenie) Zwraca kosekans wartości expr.
dziesiętne (wyrażenie) Rzutuje wartość expr na DECIMAL.
stopnie(wyrażenie) Przekształca radiany na stopnie.
dzielnik div dywidenda Zwraca całkowitą część z dzielenia divisor przez dividend.
double(wyrażenie) Rzutuje wartość expr na DOUBLE.
e() Zwraca stałą e.
exp(wyrażenie) Podnosi e do potęgi expr.
expm1(wyrażenie) Zwraca wartość exp(expr) - 1.
factorial(wyrażenie) Zwraca współczynnik .expr
float(wyrażenie) Rzutuje wartość expr na FLOAT.
floor(expr[,targetScale]) Zwraca największą liczbę nie mniejszą niż expr, zaokrąglaną w dół do targetScale cyfr względem przecinka dziesiętnego.
getbit(expr, pos) Zwraca wartość bitu w binarnej reprezentacji całkowitej liczbowej.
hypot(expr1, expr2) Zwraca wartość sqrt(expr1 * expr1 + expr2 * expr2).
int(wyrażenie) Rzutuje wartość expr na INTEGER.
isnan(wyrażenie) Zwraca wartość true , jeśli expr ma wartość NaN.
ln(wyrażenie) Zwraca logarytm naturalny (podstawa e) wartości expr.
log([base,] expr) Zwraca logarytm elementu expr z wartością base.
log1p(wyrażenie) Zwraca wartość log(1 + expr).
log2(wyrażenie) Zwraca logarytm expr o podstawie 2.
log10(wyrażenie) Zwraca logarytm expr o podstawie 10.
mod(dywidenda, dzielnik) Zwraca resztę po dividend / divisor.
nanvl(expr1, expr2) Zwraca expr1, jeśli nie jest NaN, lub expr2 w przeciwnym razie.
negative(wyrażenie) Zwraca przeciwną wartość expr.
"nullifzero(expr)" Zwraca wartość expr , jeśli nie jest równa zero lub NULL w przeciwnym razie.
pi() Zwraca wartość pi.
pmod(dywidenda, dzielnik) Zwraca dodatnią resztę po dividend / divisor.
positive(wyrażenie) Zwraca wartość expr.
pow(wyrażenie1, wyrażenie2) Podnosi expr1 do potęgi expr2.
power(expr1, expr2) Podnosi expr1 do potęgi expr2.
radiany (wyrażenie) Konwertuje expr w stopniach na radiany.
rand([seed]) Zwraca losową wartość z zakresu od 0 do 1.
randn([seed]) Zwraca wartość losową ze standardowego rozkładu normalnego.
random([seed]) Zwraca losową wartość z zakresu od 0 do 1.
rint(wyrażenie) Zwraca zaokrąglone expr do liczby całkowitej jako DOUBLE.
round(expr[,skalaDocelowa]) Zwraca zaokrąglony expr przy użyciu trybu zaokrąglania HALF_UP.
sek(wyrażenie) Zwraca sekans wartości expr.
shiftleft(wyrażenie, n) Zwraca wartość bitową przesuniętą w lewo o n bitów.
shiftright(wyrażenie, n) Zwraca bitową liczbę całkowitą ze znakiem przesuniętą w prawo o n bitów.
shiftrightunsigned(wyrażenie, n) Zwraca bitową niepodpisaną liczbę całkowitą w prawo przesuniętą według n bitów.
znak(wyrażenie) Zwraca wartość -1.0, 0.0 lub 1.0, jak expr ma wartość ujemną, 0 lub dodatnią.
signum(wyrażenie) Zwraca wartość -1.0, 0.0 lub 1.0, jak expr ma wartość ujemną, 0 lub dodatnią.
sin(wyrażenie) Zwraca sinus expr.
sinh(wyrażenie) Zwraca sinus hiperboliczny wartości expr.
smallint(wyrażenie) Rzutuje wartość expr na SMALLINT.
sqrt(wyrażenie) Zwraca pierwiastek kwadratowy elementu expr.
tan(arg) Zwraca tangens liczby expr.
tanh(wyrażenie) Zwraca wartość tangensa hiperbolicznego dla expr.
tinyint(wyrażenie) Rzutuje expr na TINYINT.
to_number(expr, fmt) Zwraca expr przekonwertowane do DECIMAL z formatowaniem fmt.
try_add(wyrażenie1, wyrażenie2) Zwraca sumę expr1 i expr2 lub NULL w przypadku błędu.
try_divide(dzielna, dzielnik) Zwraca dividend podzielone przez divisor, lub NULL, jeśli divisor wynosi 0.
try_mod(dzielna, dzielnik) Zwraca resztę po dividend / divisor, lub NULL , jeśli divisor ma wartość 0..
try_multiply(mnożnik, mnożenie) Zwraca multiplier pomnożony przez multiplicand, albo NULL przy przepełnieniu.
try_subtract(wyrażenie1, wyrażenie2) Zwraca różnicę wartości expr2 od expr1, albo NULL w przypadku przepełnienia.
try_to_number(wyrażenie, fmt ) Zwraca expr przekształcenie na DECIMAL przy użyciu formatu fmt, lub NULL jeśli expr nie jest zgodne z formatem.
uniform(expr1, expr2 [,seed]) Zwraca wartość losową z niezależnymi i identycznymi wartościami rozproszonymi w określonym zakresie liczb.
width_bucket(wyrażenie, minExpr, maxExpr, numBuckets) Zwraca liczbę zasobnika dla wartości w histogramie o szerokości równej.
"zeroifnull(expr)" Zwraca expr, jeśli nie NULL, lub 0 w przeciwnym razie.

Funkcje agregujące

Funkcja opis
any(wyrażenie) Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie ma wartość true.
any_value(wyrażenie[,ignorujNull]) Zwraca pewną wartość expr dla grupy wierszy.
approx_count_distinct(wyrażenie[,względneSD]) Zwraca szacowaną liczbę unikatowych wartości w expr grupie.
approx_percentile(wyrażenie,procent[,dokładność]) Zwraca przybliżony percentyl expr w grupie.
przybliżony_top_k(wyrażenie[,k[,maksLiczbaŚledzonychElementów]]) Zwraca k najczęściej występujące wartości elementów w expr oraz ich przybliżone liczby wystąpień.
array_agg(wyrażenie) Zwraca tablicę składającą się ze wszystkich wartości w expr grupie.
avg(expr) Zwraca średnią obliczoną na podstawie wartości grupy.
bit_and (wyrażenie) Zwraca bitowo AND wszystkich wartości wejściowych w grupie.
bit_or(wyrażenie) Zwraca bitowo OR wszystkich wartości wejściowych w grupie.
bit_xor(wyrażenie) Zwraca bitowo XOR wszystkich wartości wejściowych w grupie.
bitmap_construct_agg(wyrażenie) Zwraca bitowe OR wartości pozycji wszystkich bitów w grupie. od 0 do 32767 w grupie jako BINARY.
bitmap_or_agg(wyrażenie) Zwraca wynik operacji bitowej OR dla wszystkich wartości wejściowych typu BINARY w grupie.
bool_and(wyrażenie) Zwraca wartość true, jeśli wszystkie wartości w expr grupie mają wartość true.
bool_or(wyrażenie) Zwraca wartość true, jeśli co najmniej jedna wartość w elemencie expr jest prawdziwa w grupie.
collect_list(wyrażenie) Zwraca tablicę składającą się ze wszystkich wartości w expr grupie.
collect_set(wyrażenie) Zwraca tablicę składającą się ze wszystkich unikatowych wartości w expr w grupie.
corr(expr1,expr2) Zwraca współczynnik Pearson korelacji między grupą par liczbowych.
count(*) Zwraca łączną liczbę pobranych wierszy w grupie, w tym wierszy zawierających wartość null.
licz(wyrażenie[, ...]) Zwraca liczbę wierszy w grupie, dla której wszystkie podane wyrażenia nie mają wartości null.
count_if (wyrażenie) Zwraca liczbę wartości True dla grupy w expr.
count_min_sketch(kolumna,epsilon,ufność,nasion) Zwraca szkic Count-Min wszystkich wartości w grupie w column z epsilon, confidence i seed.
covar_pop(wyrażenie1,wyrażenie2) Zwraca kowariancję populacji par liczbowych w grupie.
covar_samp(wyrażenie1,wyrażenie2) Zwraca współczynnik kowariancji dla próbki par liczb w grupie.
każde(wyrażenie) Zwraca wartość true, jeśli wszystkie wartości expr w grupie mają wartość true.
first(expr[,ignoreNull]) Zwraca pierwszą wartość expr dla grupy wierszy.
first_value(wyrażenie[,ignorujNul]) Zwraca pierwszą wartość expr dla grupy wierszy.
histogram_numeric(wyrażenie,numBins) Oblicza histogram z exprnumBins pojemnikami, zwracając tablicę par reprezentujących centra bin.
hll_sketch_agg(wyrażenie[,lgConfigK]) Zwraca szkic HyperLogLog używany do oszacowania liczby unikatowych wartości.
hll_union_agg(wyrażenie[,allowDifferentLgConfigK]) Agreguje szkice funkcji HyperLogLog dla grupy wierszy.
kurtosis(wyrażenie) Zwraca wartość kurtozy obliczoną na podstawie wartości z danej grupy.
last(expr[,ignoreNull]) Zwraca ostatnią wartość expr dla grupy wierszy.
last_value(wyrażenie[,ignoreNull]) Zwraca ostatnią wartość expr dla grupy wierszy.
listagg(expr[,delim]) [W GRUPIE (ORDER BY klucz [,...])] Zwraca wartość połączoną STRING lub BINARY wszystkich wartości w expr grupie rozdzielonych wartościami delim.
max(wyrażenie) Zwraca maksymalną wartość expr w grupie.
max_by(wyrażenie1,wyrażenie2) Zwraca wartość elementu skojarzonego z maksymalną wartością expr1 w grupie.
mean(expr) Zwraca średnią obliczoną na podstawie wartości grupy.
miara(kolumna_miara) Zwraca miarę widoku metryki obliczonego na podstawie wartości grupy.
median(wyrażenie) Zwraca medianę obliczaną na podstawie wartości grupy.
min(expr) Zwraca minimalną wartość expr w grupie.
min_by(wyrażenie1, wyrażenie2) Zwraca wartość expr1 skojarzona z minimalną wartością expr2 w grupie.
tryb(wyrażenie [,deterministyczny]) Zwraca najczęstszą wartość NULL, a nie expr, w grupie.
percentyl(wyrażenie, procent [,częstotliwość]) Zwraca dokładną wartość percentyla expr przy określonym percentage.
percentile_approx(wyrażenie,procent[,dokładność]) Zwraca przybliżony percentyl expr w grupie.
percentile_cont(pct) WITHIN GROUP (kluczORDER BY) Zwraca interpolowany percentyl wartości key w grupie.
percentile_disc(pct) W GRUPIE (kluczORDER BY) Zwraca percentyl dyskretny dla key wewnątrz grupy.
regr_avgx(yExpr, xExpr) Zwraca średnią z xExpr, obliczoną z wartości grupy, gdzie xExpr i yExpr są równe NOT NULL.
regr_avgy(yExpr, xExpr) Zwraca średnią z yExpr, obliczoną z wartości grupy, gdzie xExpr i yExpr są równe NOT NULL.
regr_count(yExpr, xExpr) Zwraca liczbę par yExprxExpr wartości innych niż null w grupie.
regr_intercept(yExpr, xExpr) Zwraca przecięcie linii regresji liniowej jednowariancji w grupie, gdzie xExpr i yExpr nie mają wartości NULL.
regr_r2(yExpr, xExpr) Zwraca współczynnik determinacji z wartości grupy, gdzie xExpr i yExpr nie mają wartości NULL.
regr_slope(yExpr, xExpr) Zwraca nachylenie linii regresji liniowej par wartości niebędących nullem yExpr, xExpr w grupie.
regr_sxx(yExpr, xExpr) Zwraca sumę kwadratów wartości z grupy, w której xExpr i xExpr nie są NULL.
regr_sxy(yExpr, xExpr) Zwraca sumę produktów yExpr i xExpr obliczonych na podstawie wartości grupy, w której xExpr i yExprNOT NULL.
regr_syy(yExpr, xExpr) Zwraca sumę kwadratów wartości z grupy, w której yExpr i xExpr nie są NULL.
schema_of_json_agg(json[, opcje]) Zwraca połączony schemat ciągów JSON w grupie w formacie DDL.
schema_of_variant_agg(variantExpr) Zwraca połączony schemat wszystkich VARIANT wartości w grupie w formacie DDL.
skośność(expr) Zwraca wartość niesymetryczności obliczoną na podstawie wartości grupy.
some(wyrażenie) Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie to true.
std(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z wartości w grupie.
stddev(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z wartości w grupie.
stddev_pop (wyrażenie) Zwraca odchylenie standardowe populacji obliczone z wartości grupy.
stddev_samp(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z wartości grupy.
string_agg(wyrażenie[,delim]) [WITHIN GROUP (ORDER BY klucz [,...])] Zwraca wartość połączoną STRING lub BINARY wszystkich wartości w expr grupie rozdzielonych wartościami delim.
sum(wyrażenie) Zwraca sumę obliczaną na podstawie wartości grupy.
try_avg(wyrażenie) Zwraca średnią obliczoną na podstawie wartości grupy, NULL jeśli występuje przepełnienie.
try_sum(wyrażenie) Zwraca sumę obliczoną na podstawie wartości grupy, NULL jeśli istnieje przepełnienie.
var_pop(wyrażenie) Zwraca wariancję populacji obliczoną na podstawie wartości grupy.
var_samp(wyrażenie) Zwraca wariancję próbki obliczoną na podstawie wartości grupy.
wariancja(expr) Zwraca wariancję próbki obliczoną na podstawie wartości grupy.

Funkcje okna klasyfikacji

Funkcja opis
dense_rank() Zwraca rangę wartości w porównaniu ze wszystkimi wartościami w partycji.
ntile(n) Dzieli wiersze dla każdej partycji okna na n przedziałów w zakresie od 1 do maksymalnie n.
stopień_procentowy() Oblicza procentową klasyfikację wartości w partycji.
rank() Zwraca rangę wartości w porównaniu ze wszystkimi wartościami w partycji.
row_number() Przypisuje unikatową, sekwencyjną liczbę do każdego wiersza, zaczynając od jednego, zgodnie z kolejnością wierszy w partycji okna.

Funkcje okna analitycznego

Funkcja opis
cume_dist() Zwraca położenie wartości względem wszystkich wartości w partycji.
lag(expr[,offset[,default]]) Zwraca wartość expr z poprzedniego wiersza wewnątrz partycji.
lead(expr[,offset[,default]]) Zwraca wartość expr z kolejnego wiersza w partycji.
nth_value(wyrażenie, przesunięcie[, ignoruj_zerowe_wartości]) Zwraca wartość expr w określonym offset w oknie.

Funkcje tablicy

Funkcja opis
arrayExpr[indexExpr] Zwraca element na pozycji indexExpr w TABLICY arrayExpr.
agregat(expr,start,merge[,finish]) Agreguje elementy w tablicy przy użyciu niestandardowego agregatora.
array([wyrażenie [, ...]]) Zwraca tablicę z elementami w expr.
array_append(tablica, elem) Zwraca array z dodatkiem elem.
array_compact(tablica) Usuwa wartości NULL z arrayelementu .
array_contains(tablica,wartość) Zwraca true, jeśli array zawiera value.
array_distinct(tablica) Usuwa zduplikowane wartości z array.
array_except(tablica1, tablica2) Zwraca tablicę elementów, które znajdują się w array1, ale nie w array2.
array_insert(tablica, indeks, elem) Zwraca rozszerzony array, w którym elem jest wstawiany na pozycji index.
array_intersect(tablica1,tablica2) Zwraca tablicę elementów znajdujących się w przecięciu array1 i array2.
array_join(tablica,ogranicznik[,nullReplacement]) Łączy elementy array.
array_max(tablica) Zwraca wartość maksymalną w array.
array_min(tablica) Zwraca wartość minimalną w pliku array.
array_position(tablica,element) Zwraca pozycję pierwszego wystąpienia element elementu w pliku array.
array_prepend(tablica, element) Zwraca array poprzedzony przez elem.
array_remove(tablica,element) Usuwa wszystkie wystąpienia elementu element z .array
array_repeat(element,count) - funkcja powtarzająca element określoną liczbę razy. Zwraca tablicę, która zawiera elementcount razy.
array_size(tablica) Zwraca liczbę elementów w array.
array_sort(array, func) Zwraca array posortowane według func.
array_union(tablica1, tablica2) Zwraca tablicę elementów w zbiorze array1 oraz array2 bez duplikatów.
arrays_overlap(tablica1, tablica2) Zwraca wartość true, jeśli przecięcie array1 i array2 nie jest puste.
arrays_zip(array1 [, ...]) Zwraca scaloną tablicę struktur, gdzie n-ta struktura zawiera wszystkie n-te wartości z tablic wejściowych.
kardynalność(expr) Zwraca rozmiar expr.
concat(expr1, expr2 [, ...]) Zwraca konkatenację argumentów.
element_at(arrayExpr, index) Zwraca element arrayExpr pod index.
exists(expr, pred) Zwraca wartość true, jeśli pred ma wartość true dla dowolnego elementu w pliku expr.
eksploduj(kolekcja) Zwraca wiersze przez anulowanie zagnieżdżania collection.
explode_outer(kolekcja) Zwraca wiersze przez anulowanie zagnieżdżania collection przy użyciu semantyki zewnętrznej.
filter(expr,func) Filtruje tablicę w expr używając funkcji func.
flatten(arrayOfArrays) Przekształca tablice tablic w pojedynczą tablicę.
forall(expr, predFunc) Sprawdza, czy predFunc spełnia warunki dla wszystkich elementów w tablicy.
get(arrayExpr, index) Zwraca element arrayExpr znajdujący się na index, zaczynający się od 0.
inline(input) Eksploduje tablicę struktur w tabeli.
inline_outer(dane wejściowe) Rozwija tablicę struktur do tabeli z zewnętrznymi semantykami.
posexplode(kolekcja) Zwraca wiersze poprzez od-zagnieżdżanie tablicy wraz z numerowaniem pozycji.
posexplode_outer(kolekcja) Zwraca wiersze przez usunięcie zagnieżdżenia tablicy i numerowanie pozycji zgodnie z semantyką OUTER.
reduce(expr,start,merge[,finish]) Agreguje elementy w tablicy przy użyciu niestandardowego agregatora.
odwróć(tablica) Zwraca odwrócony ciąg lub tablicę z odwrotną kolejnością elementów.
sekwencja(start,stop,krok) Generuje tablicę elementów od start do stop (włącznie), z przyrostem o step.
shuffle(array) Zwraca losową permutację tablicy w expr.
size(expr) Zwraca kardynalność wartości expr.
slice(expr,start,length) Zwraca podzbiór tablicy.
sort_array(wyrażenie[,rosnąco]) Zwraca tablicę w expr kolejności posortowanej.
transform(expr, func) Przekształca elementy w tablicy expr przy użyciu funkcji func.
try_element_at(arrayExpr, index) Zwraca element arrayExpr w index, lub NULL, jeśli index jest poza granicą.
zip_with(wyrażenie1, wyrażenie2, funkcja) Łączy tablice w expr1 i expr2 element po elemencie w jedną tablicę za pomocą func.

Funkcje mapy

Funkcja opis
mapExpr[keyExpr] Zwraca wartość z pozycji keyExpr w mapie mapExpr.
kardynalność(expr) Zwraca rozmiar expr.
element_at(mapExpr, klucz) Zwraca wartość mapExpr dla key.
eksploduj(kolekcja) Zwraca wiersze przez anulowanie zagnieżdżania expr.
explode_outer(kolekcja) Zwraca wiersze przez anulowanie zagnieżdżania expr przy użyciu semantyki zewnętrznej.
map([{key1, wartość1}[, ...]]) Tworzy mapę z określonymi parami klucz-wartość.
map_concat([expr1 [, ...]]) Zwraca połączenie wszystkich expr wyrażeń mapy.
map_contains_key (mapa, klucz) Zwraca true , jeśli map zawiera key , w przeciwnym razie false.
map_entries(mapa) Zwraca nieuporządkowaną tablicę wszystkich wpisów w map.
map_filter(wyrażenie, funkcja) Filtruje wpisy na mapie w expr przy użyciu funkcji func.
map_from_arrays(klucze, wartości) Tworzy mapę z pary tablic keys i values.
map_from_entries(wyrażenie) Tworzy mapę utworzoną na podstawie określonej tablicy wpisów.
map_keys(mapa) Zwraca nieurządkowaną tablicę zawierającą klucze map.
map_values(mapa) Zwraca nieurządkowaną tablicę zawierającą wartości map.
map_zip_with(map1, map2, func) Łączy map1 i map2 w jedną mapę.
size(expr) Zwraca kardynalność wartości expr.
str_to_map(wyrażenie[,pairDelim[,keyValueDelim]]) Zwraca mapę po podzieleniu expr na pary klucz-wartość przy użyciu ograniczników.
transform_keys(wyrażenie, func) Przekształca klucze na mapie expr przy użyciu funkcji func.
transform_values(wyrażenie, funkcja) Przekształca wartości na mapie expr przy użyciu funkcji func.
try_element_at(mapExpr, klucz) Zwraca wartość parametru mapExpr dla key, lub NULL jeśli key nie istnieje.

Funkcje daty, znacznika czasu i interwału

Aby uzyskać informacje na temat formatów daty i znacznika czasu, zobacz Wzorce daty i godziny.

Funkcja opis
intervalExpr/dzielnik Zwraca interwał podzielony przez divisor.
- intervalExpr Zwraca przeciwną wartość intervalExpr.
intervalExpr1 — intervalExpr2 Zwraca różnicę wartości intervalExpr2 od intervalExpr1.
datetimeExpr1 — datetimeExpr2 Zwraca różnicę wartości datetimeExpr2 od datetimeExpr1.
+ interwałExpr Zwraca wartość intervalExpr.
intervalExpr1 + intervalExpr2 Zwraca sumę wartości intervalExpr1 i intervalExpr2.
intervalExpr * multiplicand Zwraca intervalExpr pomnożone przez multiplicand.
abs(wyrażenie) Zwraca wartość bezwzględną wartości interwału w pliku expr.
add_months(startDate,numMonths) Zwraca datę, która jest późniejsza numMonths niż startDate.
curdate() Zwraca bieżącą datę na początku oceny zapytania.
current_date() Zwraca bieżącą datę na początku oceny zapytania.
current_timestamp() Zwraca bieżący znacznik czasu na początku oceny zapytania.
current_timezone() Zwraca lokalną strefę czasową bieżącej sesji.
date(expr) Rzutuje wartość expr na DATE.
date_add(startDate,numDays) Zwraca datę numDays po startDate.
date_add(jednostka, wartość, wyrażenie) Dodaje valueunitelementy do znacznika czasu expr.
date_diff(jednostka, początek, koniec) Zwraca różnicę między dwoma znacznikami czasu mierzonymi w units.
date_format(expr, fmt) Konwertuje znacznik czasu na ciąg w formacie fmt.
date_from_unix_date (dni) Tworzy datę z liczby dni od .1970-01-01
date_part(pole, wyrażenie) Ekstrahuje część daty, znacznika czasowego lub interwału.
date_sub(startDate,numDays) Zwraca datę numDays przed startDate.
date_trunc(jednostka, wyrażenie) Zwraca znacznik czasu skrócony do jednostki określonej w unit.
dateadd(startDate,numDays) Zwraca datę numDays po startDate.
dateadd(jednostka, wartość, expr) Dodaje valueunitelementy do znacznika czasu expr.
datediff(endDate,startDate) Zwraca liczbę dni z startDate do endDate.
datediff(jednostka, początek, zatrzymywanie) Zwraca różnicę między dwoma znacznikami czasu mierzonymi w units.
day(expr) Zwraca dzień miesiąca daty lub znacznika czasu.
dayname(wyrażenie) Zwraca trzyliterowy akronim angielski dla dnia tygodnia dla danej daty.
dayofmonth(wyrażenie) Zwraca dzień miesiąca daty lub znacznika czasu.
dayofweek(wyrażenie) Zwraca dzień tygodnia dla podanej daty lub znacznika czasu.
dayofyear(wyrażenie) Zwraca dzień roku daty lub znacznika czasu.
dzielnik div dywidenda Zwraca część całkowitą wyniku dzielenia interwału divisor przez interwał dividend.
extract(pole z źródła) Zwraca field z source.
from_unixtime(unixTime,fmt) Zwraca wartość unixTime w pliku fmt.
from_utc_timestamp(wyrażenie,strefa czasowa) Zwraca znacznik czasu przy UTC dla znacznika czasu expr przy timeZone.
getdate() Zwraca bieżący znacznik czasu na początku oceny zapytania.
hour(expr) Zwraca część godzinową znacznika czasu.
last_day(wyrażenie) Zwraca ostatni dzień miesiąca, do którego należy data.
make_date (rok, miesiąc,dzień) Tworzy datę z pól year, month i day.
make_dt_interval([dni[, godziny[, min[, s]]]]) Tworzy przedział czasowy z days, hours, mins i secs.
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) Przestarzała funkcja: tworzy interwał z years, months, weeks, days, hours, mins i secs.
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,strefa czasowa]) Tworzy znacznik czasu na podstawie pól year, month, day, hour, min, sec i timezone.
make_ym_interval([lata[, miesiące]]) Tworzy interwał roku i miesiąca na podstawie years oraz months.
minute(wyrażenie) Zwraca składnik minuty znacznika czasu w elemencie expr.
month(expr) Zwraca element miesiąca z znacznika czasu w expr.
months_between(wyrażenie1,wyrażenie2[,zaokrąglenie]) Zwraca liczbę miesięcy, które upłynęły między datami lub znacznikami czasu w expr1 i expr2.
next_day(wyrażenie,dzieńTygodnia) Zwraca pierwszą datę, która jest późniejsza niż expr i nazywa się jak dayOfWeek.
now() Zwraca bieżący znacznik czasu na początku oceny zapytania.
quarter(wyrażenie) Zwraca numer kwartału roku dla expr w zakresie od 1 do 4.
drugi(wyrażenie) Zwraca drugi składnik znacznika czasu z expr.
session_window(wyrażenie, gpDuration) Tworzy okno sesji na podstawie wyrażenia ze znacznikiem czasu.
znak(wyrażenie) Zwraca wartość -1.0, 0.0 lub 1.0, ponieważ interwał expr jest ujemny, 0 lub dodatni.
signum(wyrażenie) Zwraca wartość -1.0, 0.0 lub 1.0, ponieważ interwał expr jest ujemny, 0 lub dodatni.
timediff(jednostka, uruchamianie, zatrzymywanie) Zwraca różnicę między dwoma znacznikami czasu mierzonymi w units.
znacznikCzasu(wyrażenie) Rzutuje expr na TIMESTAMP.
timestamp_micros(wyrażenie) Tworzy znacznik czasu w mikrosekundach od epoki UTC.
timestamp_millis (wyrażenie) Tworzy znacznik czasu w milisekundach od epoki UTC.
timestamp_seconds(wyrażenie) Tworzy znacznik czasu od epoki UTC w sekundach.
timestampadd(jednostka, wartość, wyrażenie) Dodaje valueunitelementy do znacznika czasu expr.
timestampdiff(jednostka, uruchamianie, zatrzymywanie) Zwraca różnicę między dwoma znacznikami czasu mierzonymi w units.
to_date(wyrażenie[,fmt]) Zwraca expr rzutowanie do daty przy użyciu opcjonalnego formatowania.
to_timestamp(wyrażenie[,fmt]) Zwraca expr konwersję na znacznik czasu przy użyciu opcjonalnego formatowania.
to_unix_timestamp(wyrażenie[,fmt]) Zwraca znacznik czasu w expr jako znacznik czasu UNIX.
to_utc_timestamp(wyrażenie, strefa_czasowa) Zwraca znacznik czasu przy UTC dla znacznika czasu expr przy timezone.
trunc(wyrażenie, fmt) Zwraca datę, której część została skrócona do jednostki określonej przez format modelu fmt.
try_add(wyrażenie1, wyrażenie2) Zwraca sumę expr1 i expr2, lub NULL w przypadku błędu.
try_divide(dzielna, dzielnik) Zwraca wartość dividend podzieloną przez divisorwartość , lub NULL, jeśli divisor ma wartość 0.
try_multiply(mnożnik, mnożenie) Zwraca multiplier pomnożony przez multiplicand, albo NULL przy przepełnieniu.
try_subtract(wyrażenie1, wyrażenie2) Zwraca różnicę wartości expr2 od expr1, albo NULL w przypadku przepełnienia.
spróbuj_przekonwertować_na_znacznik_czasu(wyrażenie[,fmt]) Zwraca expr przekonwertowane na znacznik czasu z opcjonalnym formatowaniem lub NULL, jeśli konwersja zakończyła się niepowodzeniem.
unix_date (wyrażenie) Zwraca liczbę dni od 1970-01-01.
unix_micros(wyrażenie) Zwraca liczbę mikrosekund od .1970-01-01 00:00:00 UTC
unix_millis(wyrażenie) Zwraca liczbę milisekund od .1970-01-01 00:00:00 UTC
unix_seconds (wyrażenie) Zwraca liczbę sekund od .1970-01-01 00:00:00 UTC
unix_timestamp([wyrażenie[, fmt]]) zwraca znacznik czasu UNIX dla bieżącego lub określonego czasu.
dzień powszedni (wyrażenie) Zwraca dzień tygodnia expr.
weekofyear(wyrażenie) Zwraca tydzień roku expr.
year(expr) Zwraca składnik roku expr.
window(expr, width[, step[, start]]) Tworzy okno przesuwne oparte na przeskokach w wyrażeniu czasowym.
window_time(okno) Zwraca końcowy czas inkluzywny okna przesuwanego generowanego przez funkcje window lub session_window.

Funkcje geoprzestrzenne H3

Aby uzyskać informacje o funkcjach geoprzestrzennych H3, zobacz Funkcje geoprzestrzenne H3.

Funkcje rzutujące i konstruktory

Aby uzyskać więcej informacji o rzutowaniu między typami, zobacz funkcja cast i funkcja try_cast.

Funkcja opis
array([wyrażenie [, ...]]) Zwraca tablicę z elementami w expr.
bigint(wyrażenie) Rzutuje wartość expr na BIGINT.
binary(expr) Rzutuje wartość expr na BINARY.
boolean(wyrażenie) Rzutuje expr na BOOLEAN.
cast(expr AS type) Rzutuje wartość expr na docelowy typ danych type.
wyrażenie :: typ Rzutuje wartość expr na docelowy typ danych type.
date(expr) Rzutuje wartość expr na DATE.
dziesiętne (wyrażenie) Rzutuje wartość expr na DECIMAL.
double(wyrażenie) Rzutuje wartość expr na DOUBLE.
float(wyrażenie) Rzutuje wartość expr na FLOAT.
int(wyrażenie) Rzutuje wartość expr na INTEGER.
make_date (rok, miesiąc,dzień) Tworzy datę z pól year, month i day.
make_dt_interval([dni[, godziny[, min[, s]]]]) Tworzy przedział czasowy z days, hours, mins i secs.
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) Tworzy interwał na podstawie years, months, weeks, days, hours, mins i secs.
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,strefa czasowa]) Tworzy znacznik czasu na podstawie pól year, month, day, hour, min, sec i timezone.
make_ym_interval([lata[, miesiące]]) Tworzy interwał roku i miesiąca na podstawie years oraz months.
map([{key1, wartość1} [, ...]]) Tworzy mapę z określonymi parami klucz-wartość.
named_struct({name1, val1} [, ...]) Tworzy strukturę z określonymi nazwami i wartościami pól.
smallint(wyrażenie) Rzutuje wartość expr na SMALLINT.
string(wyrażenie) Rzutuje wartość expr na STRING.
struct(expr1 [, ...]) Tworzy STRUCT z określonymi wartościami pól.
tinyint(wyrażenie) Rzutuje expr na TINYINT.
znacznikCzasu(wyrażenie) Rzutuje expr na TIMESTAMP.
to_char(wyrażenie, fmt) Zwraca expr skonwertowane na STRING z użyciem formatowania fmt.
to_date(wyrażenie[,fmt]) Zwraca expr rzutowanie do daty przy użyciu opcjonalnego formatowania.
to_number(wyrażenie, fmt) Zwraca expr przekonwertowane na DECIMAL przy użyciu formatowania fmt.
to_timestamp(wyrażenie[,fmt]) Zwraca expr konwersję na znacznik czasu przy użyciu opcjonalnego formatowania.
to_varchar(wyrażenie, fmt) Zwraca expr skonwertowane na STRING z użyciem formatowania fmt.
try_cast(expr AS typ) Bezpiecznie przekształca wartość expr do docelowego typu danych type.
try_to_number(wyrażenie, fmt) Zwraca expr rzutowany do DECIMAL z użyciem formatowania fmt, lub NULL, jeśli expr nie jest prawidłowy.

Funkcje CSV i Avro

Funkcja opis
from_avro(avroBin, jsonSchema[, opcje]) Zwraca wartość struktury na podstawie wartości avroBin i jsonSchema.
from_csv(csvStr, schema[, options]) Zwraca wartość struktury z wartościami csvStr i schema.
schema_of_csv(csv[, opcje]) Zwraca schemat ciągu CSV w formacie DDL.
to_avro(wyrażenie[, opcje]) Zwraca wartość binarną Avro z podaną wartością struktury.
to_csv(expr[, opcje]) Zwraca ciąg CSV z określoną wartością struktury.

Funkcje JSON

Funkcja opis
jsonStr: jsonPath Zwraca pola wyodrębnione z obiektu jsonStr.
from_json(jsonStr, schema[, options]) Zwraca wartość struktury z wartościami jsonStr i schema.
get_json_object(wyrażenie, ścieżka) Wyodrębnia JSON obiekt z pathobiektu .
json_array_length(jsonArray) Zwraca liczbę elementów w najbardziej zewnętrznej tablicy JSON.
json_object_keys(jsonObject) Zwraca wszystkie klucze najbardziej zewnętrznego obiektu JSON jako tablicę.
json_tuple(jsonStr, path1 [, ...]) Zwraca wiele JSON obiektów jako krotkę.
parse_json(jsonStr) Zwraca VARIANT wartość z jsonStr.
schema_of_json(jsonStr[, options]) Zwraca schemat ciągu JSON w formacie DDL.
schema_of_json_agg(jsonStr[, options]) Zwraca połączony schemat ciągów JSON w grupie w formacie DDL.
to_json(expr[, opcje]) Zwraca ciąg JSON z wartością STRUCT lub VARIANT określoną w pliku expr.

Funkcje VARIANT

Funkcja opis
variantExpr: jsonPath Zwraca pola wyodrębnione z variantExpr za pomocą ścieżki JSON.
is_variant_null(variantExpr) Sprawdza, czy variantExpr jest zakodowany jako VARIANT-format NULL.
parse_json(jsonStr) Zwraca VARIANT wartość z jsonStr.
schema_of_variant(variantExpr) Zwraca schemat wyrażenia VARIANT w formacie DDL.
schema_of_variant_agg(variantExpr) Zwraca połączony schemat wszystkich VARIANT wartości w grupie w formacie DDL.
to_json(expr[, opcje]) Zwraca ciąg JSON z wartością STRUCT lub VARIANT określoną w pliku expr.
try_parse_json(jsonStr) Zwraca wartość VARIANT z jsonStr, jeśli to możliwe. Jeśli nie jest to możliwe, NULL zostanie zwrócony.
try_variant_get(variantExpr,path,type) Wyodrębnia wartość typu type z wartości variantExpr, określonego przez path, lub NULL jeśli rzutowanie do typu docelowego nie jest możliwe.
variant_explode(dane wejściowe) Zwraca zestaw wierszy przez rozpakowywanie input.
variant_explode_outer(dane wejściowe) Zwraca zestaw wierszy przez anulowanie zagnieżdżania input przy użyciu semantyki zewnętrznej.
variant_get(variantExpr,path,type) Wyodrębnia wartość typu type z klasy variantExpr, określoną przez path.

Funkcje XPath i XML

Funkcja opis
from_xml(xmlStr, schema[, options]) Zwraca wartość struktury przeanalizowaną z xmlStr przy użyciu schema.
schema_of_xml(xmlStr[, opcje]) Zwraca schemat ciągu XML w formacie DDL.
xpath(xml, xpath) Zwraca wartości w węzłach xml, które są zgodne z xpath.
xpath_boolean(xml, xpath) Zwraca true, jeśli wyrażenie xpath zostanie ocenione jako true lub jeśli zostanie znaleziony pasujący węzeł w xml.
xpath_double(xml, xpath) DOUBLE Zwraca wartość z dokumentu XML.
xpath_float(xml, xpath) FLOAT Zwraca wartość z dokumentu XML.
xpath_int(xml, xpath) INTEGER Zwraca wartość z dokumentu XML.
xpath_long(xml, xpath) BIGINT Zwraca wartość z dokumentu XML.
xpath_number(xml, xpath) DOUBLE Zwraca wartość z dokumentu XML.
xpath_short(xml, xpath) SHORT Zwraca wartość z dokumentu XML.
xpath_string(xml, xpath) Zwraca zawartość pierwszego węzła XML zgodnego z wyrażeniem XPath.

Funkcje sztucznej inteligencji

Funkcja opis
ai_analyze_sentiment(zawartość) Zwraca nastrój tekstu.
ai_classify(zawartość, etykiety) Klasyfikuje podaną zawartość w jednej z podanych etykiet.
ai_extract (zawartość, etykiety) Wyodrębnia jednostki określone przez etykiety z danego tekstu.
ai_fix_grammar(zawartość) Poprawia błędy gramatyczne w danym tekście.
ai_forecast(obserwowane, kolumna_czasu) Ekstrapoluje dane szeregów czasowych w przyszłość.
ai_gen(zawartość) Wywołuje najnowocześniejszy model generatywny sztucznej inteligencji z API modeli Fundacji Databricks, aby odpowiedzieć na monit dostarczony przez użytkownika.
ai_generate_text(prompt, modelName[, param1, value1] [...]) Przestarzałe: Zwraca tekst wygenerowany przez wybrany duży model językowy (LLM) na podstawie polecenia.
ai_mask(zawartość, etykiety) Maskuje określone jednostki w danym tekście.
ai_query(endpointName, request, returnType) Wywołuje istniejący punkt końcowy obsługi modeli AI Mosaic, analizuje otrzymaną odpowiedź i ją zwraca.
ai_similarity(strExpr1, strExpr2) Porównuje dwa ciągi i oblicza wynik podobieństwa semantycznego.
ai_summarize(zawartość[, max_words]) Generuje podsumowanie danego tekstu.
ai_translate(zawartość, to_lang) Tłumaczy tekst na określony język docelowy.
vector_search(indeks, zapytanie, num_results) Wykonywanie zapytań do indeksu Wyszukiwania Wektorowego Mosaic AI za pomocą SQL.

Funkcje odczytu

Funkcja opis
read_files(path, [optionKey => optionValue] [, ...]) Odczytuje pliki danych w magazynie w chmurze i zwraca je w formacie tabelarycznym.
read_kafka([optionKey => optionValue] [, ...]) Odczytuje rekordy z klastra platformy Apache Kafka i zwraca je w formacie tabelarycznym.
read_kinesis({parameter => wartość} [, ...]) Zwraca tabelę z rekordami odczytanymi z Kinesis z co najmniej jednego strumienia.
read_pubsub([parametr => wartość] [, ...]) Funkcja zwracająca tabelę do odczytywania rekordów z Pub/Sub z tematu.
read_pulsar({optionKey => optionValue} [, ...]) Zwraca tabelę z rekordami odczytanymi z pulsaru.
read_state_metadata(ścieżka) Zwraca tabelę zawierającą wiersze, które przedstawiają metadane stanu zapytania strumieniowego.
read_statestore(ścieżka [, option_key => option_value] [...]) Zwraca rekordy z repozytorium stanów dla zapytań przesyłanych strumieniowo.

Różne funkcje

Funkcja opis
assert_true(wyrażenie) Zwraca błąd, jeśli expr nie ma wartości true.
Wyrażenie CASE { PO WYBRANIU OPCJI 1 NASTĘPNIE res1 } [...] [ELSE def] KONIEC Zwraca resN wartość dla pierwszego optN , który jest równy expr lub def jeśli żaden z nich nie pasuje.
CASE { WHEN cond1 THEN res1 } [...] [ELSE def] KONIEC Zwraca resN dla pierwszego condN, który daje wartość true, lub def, jeśli żadna nie zostanie znaleziona.
cloud_files_state( { TABLE(tabela) | punkt kontrolny } ) Zwraca stan pliku źródłowego autoloadera cloud_files.
coalesce(wyrażenie1, wyrażenie2 [, ...]) Zwraca pierwszy argument inny niż null.
kolacje() Zwraca listę dostępnych kolacji.
cube (wyrażenie1 [, ...]) Tworzy wielowymiarową kostkę przy użyciu określonych kolumn wyrażeń.
current_catalog() Zwraca bieżący wykaz.
current_database() Zwraca bieżący schemat.
current_metastore() Zwraca bieżący identyfikator Unity Catalog Metastore.
current_recipient(klucz) Zwraca właściwość bieżącego adresata w widoku udostępnionym przez Delta Sharing.
current_schema() Zwraca bieżący schemat.
current_user() Zwraca użytkownika wykonującego instrukcję .
current_version() Zwraca bieżącą wersję usługi Azure Databricks.
decode(expr, { key, value } [, ...] [,defValue]) Zwraca wartość odpowiadającą kluczowi.
elt(index, expr1 [, ...] ) Zwraca n-te wyrażenie.
equal_null(wyrażenie1, wyrażenie2) Zwraca true, jeśli expr1 jest równe expr2 lub oba wyrażenia są NULL, lub false w przeciwnym razie.
event_log( { TABLE(tabela) | pipeline_id } ) Zwraca tabelę historii aktualizacji dla zmaterializowanego widoku, tabeli przesyłania strumieniowego lub potoku.
greatest(expr1, expr2 [, ...]) Zwraca największą wartość wszystkich argumentów, pomijając wartości null.
grouping(col) Wskazuje, czy określona kolumna w GROUPING SET, ROLLUPlub CUBE reprezentuje sumę częściową.
grouping_id([col1 [, ...]]) Zwraca poziom grupowania dla zestawu kolumn.
hash(expr1 [, ...]) Zwraca skonstruowaną wartość argumentów.
hll_sketch_estimate(wyrażenie) Szacuje liczbę unikalnych wartości zebranych w szkicu HyperLogLog.
hll_union(wyrażenie1, wyrażenie2 [,allowDifferentLgConfigK]) Łączy dwa szkice danych HyperLogLog.
http_request({parm => expr} [, ...]) Wysyła żądanie HTTP przy użyciu zdefiniowanego połączenia HTTP.
java_method(klasa, metoda[, arg1 [, ...]]) Wywołuje metodę przy użyciu refleksji.
if(cond, expr1, expr2) Zwraca expr1 jeśli cond jest true, lub expr2 w przeciwnym razie.
iff(cond, expr1, expr2) Zwraca expr1 jeśli cond jest true, lub expr2 w przeciwnym razie.
ifnull(expr1, expr2) Zwraca expr2 jeśli expr1 jest NULL, lub expr1 w przeciwnym razie.
input_file_block_length() Zwraca długość w bajtach odczytywanego bloku.
input_file_block_start() Zwraca przesunięcie początkowe w bajtach odczytywanego bloku.
input_file_name() Zwraca nazwę odczytywanego pliku lub pusty ciąg, jeśli nie jest dostępny.
is_account_group_member(grupa) Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie konta.
is_member(grupa) Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie obszaru roboczego.
isnull(wyrażenie) Zwraca wartość true , jeśli expr ma wartość NULL.
isnotnull(wyrażenie) Zwraca true, jeśli expr nie jest NULL.
least(wyrażenie1, wyrażenie2 [, ...]) Zwraca najmniejszą wartość wszystkich argumentów, pomijając wartości null.
list_secrets([scopeStr]) Zwraca klucze w jednym lub wszystkich zakresach, które użytkownik jest autoryzowany do zobaczenia z usługi tajemnic Databricks.
luhn_check(numStr) Zwraca true, jeśli numStr przechodzi sprawdzian algorytmu Luhn.
monotonically_increasing_id() Zwraca monotonicznie rosnące 64-bitowe liczby całkowite.
nullif(expr1, expr2) Zwraca NULL, jeśli expr1 równa się expr2, lub expr1 w przeciwnym razie.
nvl(wyrażenie1, wyrażenie2) Zwraca expr2 jeśli expr1 jest NULL, lub expr1 w przeciwnym razie.
nvl2(expr1, expr2, expr3) Zwraca expr2, jeśli expr1 nie jest NULL, w przeciwnym razie zwraca expr3.
raise_error (wyrażenie) Zgłasza wyjątek z komunikatem expr.
range(end) Zwraca tabelę wartości w określonym zakresie.
range(start, end [, step [, numParts]]) Zwraca tabelę wartości w określonym zakresie.
reflect(klasa, metoda[, arg1 [, ...]]) Wywołuje metodę przy użyciu refleksji.
secret(scope, key) Wyodrębnia tajną wartość z daną scope i key z usługi tajnych danych Databricks.
session_user() Zwraca użytkownika połączonego z usługą Azure Databricks.
spark_partition_id() Zwraca bieżący identyfikator partycji.
sql_keywords() Zwraca zestaw słów kluczowych SQL w usłudze Azure Databricks.
stack(numRows, expr1 [, ...]) Oddziela expr1, ..., exprN na numRows wiersze.
table_changes(table_str, start [, end]) Zwraca dziennik zmian w tabeli Delta Lake z włączonym kanałem danych o zmianach.
try_reflect(klasa, metoda[, arg1 [, ...]]) Wywołuje metodę z odbiciem, zwracając NULL , jeśli metoda nie powiedzie się.
try_secret(zakres, klucz) Wyodrębnia wartość tajną z podanymi scope i key z usługi wpisów tajnych Databricks, lub zwraca NULL jeśli nie można odzyskać klucza.
typeof(wyrażenie) Zwraca ciąg znaków w formacie DDL dla typu danych expr.
user() Zwraca użytkownika wykonującego instrukcję .
uuid() Zwraca ciąg uniwersalnego unikatowego identyfikatora (UUID).
window(expr, width[, step [, start]]) Tworzy okno przesuwne oparte na przeskokach w wyrażeniu czasowym.
xxhash64(wyrażenie1 [, ...]) Zwraca 64-bitowy skrót wartości argumentów.
version() Zwraca wersję platformy Apache Spark.