Udostępnij za pomocą


Wbudowane funkcje

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 nawzajem, zobacz Pierwszeństwo operatora.

Operator Syntax Description
& expr1 & expr2 Zwraca bitowe AND wartości expr1 i expr2.
and 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.
between 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.
exists 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.
in elem [not] in (expr1[, ...]) Zwraca wartość true , jeśli elem wartość nie jest równa dowolnej exprNwartości .
in 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 prawdziwe expr is [not] true Sprawdza, czy expr jest (nie) true.
like str [not] like (pattern[ESCAPE escape]) Zwraca true, jeśli str (nie) jest zgodny z pattern przy użyciu escape.
like 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.
not not expr Zwraca wartość logiczną NOT wyrażenia logicznego.
or 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ń

Precedence Operator
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

Function Description
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(expr) Konwertuje expr na podstawowy ciąg 64.
bin(expr) Zwraca binarną reprezentację elementu expr.
binary(expr) Rzutuje wartość expr na BINARY.
bit_length(expr) Zwraca bitową długość danych ciągu lub liczbę bitów danych binarnych.
bitmap_count(expr) 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(expr) Zwraca znak odpowiadający podanemu punktowi kodu UTF-16.
char_length(expr) Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych.
character_length(expr) 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(expr) 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(expr) 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.
find_in_set(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żenie, fmt) Formaty expr takie jak fmt.
format_string(strfmt[, obj1 [, ...]]) Zwraca sformatowany ciąg znaków według wzorca formatowania printf.
hex(expr) Konwertuje expr na szesnastkowy.
str ilike (wzorzec[ESCAPE escape]) Zwraca wartość true, jeśli str odpowiada pattern przy escape ignorowaniu wielkości liter.
initcap(expr) 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(expr) Zwraca expr z wszystkimi znakami zmienionymi na małe litery.
left(str, len) Zwraca najbardziej lewe znaki len z str.
len(expr) Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych.
length(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(expr) Zwraca sumę kontrolną MD5 o długości 128 bitów dla expr jako ciąg szesnastkowy.
octet_length(expr) 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(length) 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]) # funkcja zamieniająca część tekstu w stringu 'str' na inny tekst, jeśli określono 'replace' Zamienia wszystkie wystąpienia elementu search na replace.
reverse(expr) 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(expr) Zwraca wartość skrótu sha1 jako szesnastkowy ciąg expr.
sha1(expr) 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(expr) Zwraca kod soundex ciągu tekstowego.
space(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(expr) 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) Konwertuje ciąg do formatu application/x-www-form-urlencoded i zwraca NULL w przypadku błędu.
try_zstd_decompress(value) Zwraca wartość dekompresowaną przy użyciu kompresji Zstandard lub NULL jeśli dane wejściowe są nieprawidłowe.
ucase(expr) Zwraca expr ze wszystkimi znakami zamienionymi na wielkie litery.
unbase64(expr) Zwraca zdekodowany ciąg base64 jako binarny.
unhex(expr) Konwertuje szesnastkowe expr na BINARY.
upper(expr) Zwraca expr ze wszystkimi znakami zamienionymi na wielkie litery.
url_decode(str) Tłumaczy ciąg z formatu application/x-www-form-urlencoded z powrotem.
url_encode(str) Tłumaczy ciąg na format application/x-www-form-urlencoded .
zstd_compress (wartość[,poziom[,tryb_strumieniowania]]) Zwraca wartość skompresowaną za pomocą Zstandard.
zstd_decompress(value) Zwraca wartość dekompresowaną przy użyciu kompresji Zstandard.

Funkcje skalarne liczbowe

Function Description
~ 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(expr) Zwraca wartość bezwzględną wartości liczbowej w pliku expr.
acos(expr) Zwraca odwrotny cosinus (arcus cosinus) wartości expr.
acosh(expr) Zwraca odwrotny cosinus hiperboliczny expr.
asin(expr) Zwraca odwrotny sinus (arcsinus) wartości expr.
asinh(expr) Zwraca odwrotny sinus hiperboliczny expr.
atan(expr) 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(expr) Zwraca odwrotny tangens hiperboliczny liczby expr.
bigint(expr) Rzutuje wartość expr na BIGINT.
bit_count(expr) Zwraca liczbę bitów ustawionych w argumencie.
bit_get(wyrażenie, pos) Zwraca wartość bitu w binarnej reprezentacji całkowitej liczbowej.
bit_reverse(expr) Zwraca wartość uzyskaną przez odwrócenie kolejności bitów w argumencie.
bitmap_bit_position(expr) Zwraca pozycję bitową rozpoczynającą się od zera danej BIGINT liczby w segmencie.
bitmap_bucket_number(expr) 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(expr) 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[,targetScale]) 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(expr) Zwraca cosinus wartości expr.
cosh(expr) Zwraca cosinus hiperboliczny expr.
cot(expr) Zwraca cotangent wartości expr.
csc(expr) Zwraca kosekans wartości expr.
decimal(expr) Rzutuje wartość expr na DECIMAL.
degrees(expr) Przekształca radiany na stopnie.
dzielnik div dywidenda Zwraca całkowitą część z dzielenia divisor przez dividend.
double(expr) Rzutuje wartość expr na DOUBLE.
e() Zwraca stałą e.
exp(expr) Podnosi e do potęgi expr.
expm1(expr) Zwraca wartość exp(expr) - 1.
factorial(expr) Zwraca współczynnik .expr
float(expr) 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(expr) Rzutuje wartość expr na INTEGER.
isnan(expr) Zwraca wartość true , jeśli expr ma wartość NaN.
kll_sketch_get_n_bigint(szkic) Zwraca liczbę elementów w szkicu KLL dla liczb całkowitych.
kll_sketch_get_n_double(szkic) Zwraca liczbę elementów w podwójnym szkicu KLL.
kll_sketch_get_n_float (szkic) Zwraca liczbę elementów w szkicu KLL zmiennoprzecinkowym.
kll_sketch_get_quantile_bigint (szkic, rang) Szacuje wartość na podstawie danej rangi kwantylu ze szkicu KLL dla wartości całkowitych.
kll_sketch_get_quantile_double (szkic, ranga) Szacuje wartość na danej rangi kwantylu z podwójnego szkicu KLL.
kll_sketch_get_quantile_float(szkic, stopień) Szacuje wartość na danej rangi kwantylu na podstawie szkicu KLL zmiennoprzecinkowego.
kll_sketch_get_rank_bigint(szkic, wartość) Szacuje znormalizowany ranking wartości w całkowitoliczbowym szkicu KLL.
kll_sketch_get_rank_double(szkic, wartość) Szacuje znormalizowaną rangę wartości w podwójnym szkicu KLL.
kll_sketch_get_rank_float(szkic, wartość) Szacuje znormalizowaną rangę wartości w szkicu KLL zmiennoprzecinkowym.
kll_sketch_merge_bigint (szkic1, szkic2) Łączy dwa zgodne szkice KLL dla liczb całkowitych.
kll_sketch_merge_double(szkic1, szkic2) Łączy dwa zgodne podwójne szkice KLL.
kll_sketch_merge_float (szkic1, szkic2) Łączy dwa kompatybilne szkice float KLL.
kll_sketch_to_string_bigint(szkic) Zwraca czytelną dla człowieka reprezentację ciągu całkowitego szkicu KLL.
kll_sketch_to_string_double (szkic) Zwraca czytelną dla człowieka reprezentację ciągu podwójnego szkicu KLL.
kll_sketch_to_string_float(sketch) Zwraca czytelną dla człowieka reprezentację ciągu zmiennoprzecinkowego szkicu KLL.
ln(expr) Zwraca logarytm naturalny (podstawa e) wartości expr.
log([base,] expr) Zwraca logarytm elementu expr z wartością base.
log1p(expr) Zwraca wartość log(1 + expr).
log2(expr) Zwraca logarytm expr o podstawie 2.
log10(expr) Zwraca logarytm expr o podstawie 10.
mod(dzielna, dzielnik) Zwraca resztę po dividend / divisor.
nanvl(expr1, expr2) Zwraca expr1, jeśli nie jest NaN, lub expr2 w przeciwnym razie.
negative(expr) 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(expr) Zwraca wartość expr.
pow(wyrażenie1, wyrażenie2) Podnosi expr1 do potęgi expr2.
power(expr1, expr2) Podnosi expr1 do potęgi expr2.
radians(expr) 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(expr) Zwraca zaokrąglone expr do liczby całkowitej jako DOUBLE.
round(expr[,targetScale]) Zwraca zaokrąglony expr przy użyciu trybu zaokrąglania HALF_UP.
sec(expr) Zwraca sekans wartości expr.
shiftleft(wyrażenie, n) Zwraca wartość bitową przesuniętą w lewo o n bitów.
shiftright(expr, 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.
sign(expr) Zwraca wartość -1.0, 0.0 lub 1.0, jak expr ma wartość ujemną, 0 lub dodatnią.
signum(expr) Zwraca wartość -1.0, 0.0 lub 1.0, jak expr ma wartość ujemną, 0 lub dodatnią.
sin(expr) Zwraca sinus expr.
sinh(expr) Zwraca sinus hiperboliczny wartości expr.
smallint(expr) Rzutuje wartość expr na SMALLINT.
sqrt(expr) Zwraca pierwiastek kwadratowy elementu expr.
tan(expr) Zwraca tangens liczby expr.
tanh(expr) Zwraca wartość tangensa hiperbolicznego dla expr.
tinyint(expr) 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

Function Description
any(expr) Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie ma wartość true.
any_value(expr[,ignoreNull]) Zwraca pewną wartość expr dla grupy wierszy.
approx_count_distinct(expr[,relativeSD]) Zwraca szacowaną liczbę unikatowych wartości w expr grupie.
approx_percentile(expr,percentage[,accuracy]) Zwraca przybliżony percentyl expr w grupie.
approx_top_k(expr[,k[,maxItemsTracked]]) Zwraca k najczęściej występujące wartości elementów w expr oraz ich przybliżone liczby wystąpień.
array_agg(expr) 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(expr) Zwraca bitowo AND wszystkich wartości wejściowych w grupie.
bit_or(expr) Zwraca bitowo OR wszystkich wartości wejściowych w grupie.
bit_xor(expr) Zwraca bitowo XOR wszystkich wartości wejściowych w grupie.
bitmap_and_agg(expr) Zwraca wynik operacji bitowej AND dla wszystkich wartości wejściowych typu BINARY w grupie.
bitmap_construct_agg(expr) Zwraca bitowe OR wartości pozycji wszystkich bitów w grupie. od 0 do 32767 w grupie jako BINARY.
bitmap_or_agg(expr) Zwraca wynik operacji bitowej OR dla wszystkich wartości wejściowych typu BINARY w grupie.
bool_and(expr) Zwraca wartość true, jeśli wszystkie wartości w expr grupie mają wartość true.
bool_or(expr) Zwraca wartość true, jeśli co najmniej jedna wartość w elemencie expr jest prawdziwa w grupie.
collect_list(expr) Zwraca tablicę składającą się ze wszystkich wartości w expr grupie.
collect_set(expr) 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.
count(expr[, ...]) Zwraca liczbę wierszy w grupie, dla której wszystkie podane wyrażenia nie mają wartości null.
count_if(expr) Zwraca liczbę wartości True dla grupy w expr.
count_min_sketch(column,epsilon,confidence,seed) Zwraca szkic Count-Min wszystkich wartości w grupie w column z epsilon, confidence i seed.
covar_pop(expr1,expr2) Zwraca kowariancję populacji par liczbowych w grupie.
covar_samp(expr1,expr2) Zwraca współczynnik kowariancji dla próbki par liczb w grupie.
every(expr) 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(expr[,ignoreNull]) Zwraca pierwszą wartość expr dla grupy wierszy.
histogram_numeric(expr,numBins) Oblicza histogram z exprnumBins pojemnikami, zwracając tablicę par reprezentujących centra bin.
hll_sketch_agg(expr[,lgConfigK]) Zwraca szkic HyperLogLog używany do oszacowania liczby unikatowych wartości.
hll_union_agg(expr[,allowDifferentLgConfigK]) Agreguje szkice funkcji HyperLogLog dla grupy wierszy.
kll_sketch_agg_bigint(wyrażenie[, k]) Zwraca szkic KLL umożliwiający przybliżenie rozkładu wartości całkowitych w grupie.
kll_sketch_agg_double(wyrażenie[, k]) Zwraca szkic KLL umożliwiający przybliżenie rozkładu podwójnych wartości w grupie.
kll_sketch_agg_float(expr[, k]) Zwraca szkic KLL umożliwiający przybliżenie rozkładu wartości zmiennoprzecinkowych w grupie.
kurtosis(expr) Zwraca wartość kurtozy obliczoną na podstawie wartości z danej grupy.
last(expr[,ignoreNull]) Zwraca ostatnią wartość expr dla grupy wierszy.
last_value(expr[,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(expr) Zwraca maksymalną wartość expr w grupie.
max_by(expr1,expr2) Zwraca wartość elementu skojarzonego z maksymalną wartością expr1 w grupie.
mean(expr) Zwraca średnią obliczoną na podstawie wartości grupy.
measure(measure_column) Zwraca miarę widoku metryki obliczonego na podstawie wartości grupy.
median(expr) 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.
mode(wyrażenie [,deterministyczne]) 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(expr,percentage[,accuracy]) 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.
skewness(expr) Zwraca wartość niesymetryczności obliczoną na podstawie wartości grupy.
some(expr) Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie to true.
std(expr) Zwraca odchylenie standardowe próbki obliczone z wartości w grupie.
stddev(expr) Zwraca odchylenie standardowe próbki obliczone z wartości w grupie.
stddev_pop(expr) Zwraca odchylenie standardowe populacji obliczone z wartości grupy.
stddev_samp(expr) 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(expr) Zwraca sumę obliczaną na podstawie wartości grupy.
try_avg(expr) Zwraca średnią obliczoną na podstawie wartości grupy, NULL jeśli występuje przepełnienie.
try_sum(expr) Zwraca sumę obliczoną na podstawie wartości grupy, NULL jeśli istnieje przepełnienie.
var_pop(expr) Zwraca wariancję populacji obliczoną na podstawie wartości grupy.
var_samp(expr) Zwraca wariancję próbki obliczoną na podstawie wartości grupy.
variance(expr) Zwraca wariancję próbki obliczoną na podstawie wartości grupy.

Funkcje okna klasyfikacji

Function Description
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.
percent_rank() 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

Function Description
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

Function Description
arrayExpr[indexExpr] Zwraca element na pozycji indexExpr w TABLICY arrayExpr.
aggregate(expr,start,merge[,finish]) Agreguje elementy w tablicy przy użyciu niestandardowego agregatora.
array([wyrażenie [, ...]]) Zwraca tablicę z elementami w expr.
array_append(array, elem) Zwraca array z dodatkiem elem.
array_compact(array) Usuwa wartości NULL z arrayelementu .
array_contains(array,value) Zwraca true, jeśli array zawiera value.
array_distinct(array) Usuwa zduplikowane wartości z array.
array_except(array1,array2) 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(array1,array2) Zwraca tablicę elementów znajdujących się w przecięciu array1 i array2.
array_join(array,delimiter[,nullReplacement]) Łączy elementy array.
array_max(array) Zwraca wartość maksymalną w array.
array_min(array) Zwraca wartość minimalną w pliku array.
array_position(array,element) Zwraca pozycję pierwszego wystąpienia element elementu w pliku array.
array_prepend(tablica, elem) Zwraca array poprzedzony przez elem.
array_remove(array,element) Usuwa wszystkie wystąpienia elementu element z .array
array_repeat(element,count) Zwraca tablicę, która zawiera elementcount razy.
array_size(array) Zwraca liczbę elementów w array.
array_sort(array,func) Zwraca array posortowane według func.
array_union(array1,array2) 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.
cardinality(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.
explode(collection) Zwraca wiersze przez anulowanie zagnieżdżania collection.
explode_outer(collection) 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(input) Rozwija tablicę struktur do tabeli z zewnętrznymi semantykami.
posexplode(collection) Zwraca wiersze poprzez od-zagnieżdżanie tablicy wraz z numerowaniem pozycji.
posexplode_outer(collection) 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.
reverse(array) Zwraca odwrócony ciąg lub tablicę z odwrotną kolejnością elementów.
sequence(start,stop,step) 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(expr[,ascendingOrder]) 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

Function Description
mapExpr[keyExpr] Zwraca wartość z pozycji keyExpr w mapie mapExpr.
cardinality(expr) Zwraca rozmiar expr.
element_at(mapExpr, klucz) Zwraca wartość mapExpr dla key.
explode(collection) Zwraca wiersze przez anulowanie zagnieżdżania expr.
explode_outer(collection) 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(map) 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(expr) Tworzy mapę utworzoną na podstawie określonej tablicy wpisów.
map_keys(map) Zwraca nieurządkowaną tablicę zawierającą klucze map.
map_values(map) 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(expr[,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, func) 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.

Function Description
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(expr) 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(days) Tworzy datę z liczby dni od .1970-01-01
date_part(field,expr) Ekstrahuje część daty, znacznika czasowego lub interwału.
date_sub(startDate,numDays) Zwraca datę numDays przed startDate.
date_trunc(unit,expr) 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(expr) Zwraca trzyliterowy akronim angielski dla dnia tygodnia dla danej daty.
dayofmonth(expr) Zwraca dzień miesiąca daty lub znacznika czasu.
dayofweek(expr) Zwraca dzień tygodnia dla podanej daty lub znacznika czasu.
dayofyear(expr) 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(expr,timezone) 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(expr) Zwraca ostatni dzień miesiąca, do którego należy data.
make_date(year,month,day) 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(year,month,day,hour,min,sec[,timezone]) 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(expr) Zwraca składnik minuty znacznika czasu w elemencie expr.
month(expr) Zwraca element miesiąca z znacznika czasu w expr.
months_between(expr1,expr2[,roundOff]) Zwraca liczbę miesięcy, które upłynęły między datami lub znacznikami czasu w expr1 i expr2.
next_day(expr,dayOfWeek) 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(expr) Zwraca numer kwartału roku dla expr w zakresie od 1 do 4.
second(expr) Zwraca drugi składnik znacznika czasu z expr.
session_window (Wyrażenie, gpDuration) Tworzy okno sesji na podstawie wyrażenia ze znacznikiem czasu.
sign(expr) Zwraca wartość -1.0, 0.0 lub 1.0, ponieważ interwał expr jest ujemny, 0 lub dodatni.
signum(expr) 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.
timestamp(expr) Rzutuje expr na TIMESTAMP.
timestamp_micros(expr) Tworzy znacznik czasu w mikrosekundach od epoki UTC.
timestamp_millis(expr) Tworzy znacznik czasu w milisekundach od epoki UTC.
timestamp_seconds(expr) 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(expr[,fmt]) Zwraca expr rzutowanie do daty przy użyciu opcjonalnego formatowania.
to_timestamp(expr[,fmt]) Zwraca expr konwersję na znacznik czasu przy użyciu opcjonalnego formatowania.
to_unix_timestamp(expr[,fmt]) Zwraca znacznik czasu w expr jako znacznik czasu UNIX.
to_utc_timestamp(expr,timezone) 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.
try_to_timestamp(expr[,fmt]) Zwraca expr przekonwertowane na znacznik czasu z opcjonalnym formatowaniem lub NULL, jeśli konwersja zakończyła się niepowodzeniem.
unix_date(expr) Zwraca liczbę dni od 1970-01-01.
unix_micros(expr) Zwraca liczbę mikrosekund od .1970-01-01 00:00:00 UTC
unix_millis(expr) Zwraca liczbę milisekund od .1970-01-01 00:00:00 UTC
unix_seconds(expr) Zwraca liczbę sekund od .1970-01-01 00:00:00 UTC
unix_timestamp([expression[, fmt]]) zwraca znacznik czasu UNIX dla bieżącego lub określonego czasu.
weekday(expr) Zwraca dzień tygodnia expr.
weekofyear(expr) 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(window) Zwraca czas zakończenia inkluzywnego okna przesuwanego generowanego przez funkcje okna lub session_window .

Funkcje geoprzestrzenne H3

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

ST funkcje geoprzestrzenne

Aby uzyskać informacje na temat funkcji geoprzestrzennych st, zobacz Funkcje geoprzestrzenne st.

Funkcje rzutujące i konstruktory

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

Function Description
array([wyrażenie [, ...]]) Zwraca tablicę z elementami w expr.
bigint(expr) Rzutuje wartość expr na BIGINT.
binary(expr) Rzutuje wartość expr na BINARY.
boolean(expr) 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.
decimal(expr) Rzutuje wartość expr na DECIMAL.
double(expr) Rzutuje wartość expr na DOUBLE.
float(expr) Rzutuje wartość expr na FLOAT.
int(expr) Rzutuje wartość expr na INTEGER.
make_date(year,month,day) 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(year,month,day,hour,min,sec[,timezone]) 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(expr) Rzutuje wartość expr na SMALLINT.
string(expr) Rzutuje wartość expr na STRING.
struct(expr1 [, ...]) Tworzy STRUCT z określonymi wartościami pól.
tinyint(expr) Rzutuje expr na TINYINT.
timestamp(expr) Rzutuje expr na TIMESTAMP.
to_char(wyrażenie, fmt) Zwraca expr skonwertowane na STRING z użyciem formatowania fmt.
to_date(expr[,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(expr[,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

Function Description
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(wyrażenie[, opcje]) Zwraca ciąg CSV z określoną wartością struktury.

Funkcje JSON

Function Description
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[, opcje]) Zwraca połączony schemat ciągów JSON w grupie w formacie DDL.
to_json(wyrażenie[, opcje]) Zwraca ciąg JSON z wartością STRUCT lub VARIANT określoną w pliku expr.

Funkcje VARIANT

Function Description
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(wyrażenie[, opcje]) Zwraca ciąg JSON z wartością STRUCT lub VARIANT określoną w pliku expr.
to_variant_object(wyrażenie) Konwertuje wyrażenie złożone (ARRAY, MAP, STRUCT) na obiekt, w VARIANT którym mapy i struktury są konwertowane na obiekty wariantów.
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(input) Zwraca zestaw wierszy przez rozpakowywanie input.
variant_explode_outer(input) 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

Function Description
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

Function Description
ai_analyze_sentiment(content) 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(content) Poprawia błędy gramatyczne w danym tekście.
ai_forecast (obserwowane, time_col) Ekstrapoluje dane szeregów czasowych w przyszłość.
ai_gen(content) 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

Function Description
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 jednego lub więcej strumieni Kinesis.
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(path) 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.
remote_query(connectionName [, connectorOptionKey => connectorOptionValue] [...]) Zwraca tabelaryczny wynik zapytania wykonanego w zdalnym silniku bazy danych.

Różne funkcje

Function Description
assert_true(expr) 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.
collations() 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(key) 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(expr) 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(group) Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie konta.
is_member(group) Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie obszaru roboczego.
isnull(expr) Zwraca wartość true , jeśli expr ma wartość NULL.
isnotnull(expr) 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 test 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(expr) 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(expr) 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.