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

Operator Składnia opis
& expr1 & expr2 Zwraca bitowe AND wartości expr1 i expr2.
and expr1 and expr2 Zwraca wartość logiczną AND i expr1expr2 .
* multiplier * multiplicand Zwraca wartość multiplier pomnożona przez multiplicandwartość .
!= 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 wartość jest większa, czy równa i mniejsza, expr2 czy równa expr3.
[ ] arrayExpr [ indexExpr ] Zwraca indexExprdrugi element elementu .ARRAYarrayExpr
[ ] mapExpr [ keyExpr ] Zwraca wartość z keyExpr wartości .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 typedanych .
?:: expr ?:: type Rzutuje wartość expr na docelowy typ type danych, jeśli to możliwe, zwraca NULL w przeciwnym razie.
div dividend div divisor Zwraca integralną część dzielenia według dividenddivisorwartości .
. mapExpr . keyIdentifier MAP Zwraca wartość według keyIdentifier.
. structExpr . fieldIdentifier STRUCT Zwraca pole według fieldIdentifier.
== expr1 == expr2 Zwraca wartość true , jeśli expr1 równa expr2się , lub false w inny sposób.
= expr1 = expr2 Zwraca wartość true , jeśli expr1 równa expr2się , lub false w inny sposób.
>= expr1 >= expr2 Zwraca wartość true , jeśli expr1 wartość jest większa lub równa expr2, lub false w inny sposób.
> expr1 > expr2 Zwraca wartość true , jeśli expr1 jest większa niż expr2, lub false w przeciwnym razie.
Istnieje exists(query) Zwraca wartość true, jeśli query zwraca co najmniej jeden wiersz lub wartość false.
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 wartość true if elem (not) equal any row in query.
jest odrębna expr1 is [not] distinct from expr2 Sprawdza się, czy argumenty (nie) mają różnic w valueswhereNULLi są uznawane za porównywalne values.
ma wartość false expr is [not] false Sprawdza, czy expr wartość to (nie) false.
ma wartość null expr is [not] null Zwraca wartość true , jeśli expr wartość to (nie) NULL.
ma wartość true expr is [not] true Sprawdza, czy expr wartość to (nie) true.
lubić str [not] like (pattern[ESCAPE escape]) Zwraca wartość true, jeśli str wartość nie jest zgodna pattern z wartością 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 argument dla argumentów operandów innych niż EQUAL(=) null, ale zwraca true wartość , jeśli oba są NULLwartościami , false jeśli jeden z nich to NULL.
<= expr1 <= expr2 Zwraca wartość true , jeśli expr1 wartość jest mniejsza niż lub równa expr2, lub false w inny sposób.
<> expr1 <> expr2 Zwraca wartość true , jeśli expr1 nie jest równa expr2, lub false w inny sposób.
< expr1 < expr2 Zwraca wartość true , jeśli expr1 wartość jest mniejsza niż expr2, lub false w inny sposób.
- expr1 - expr2 Zwraca odejmowanie wartości expr2 z .expr1
nie not expr Zwraca wartość logiczną NOT wyrażenia logicznego.
or expr1 or expr2 Zwraca wartość logiczną OR i expr1expr2 .
% 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 wartość nie jest zgodna regexz wartością .
regexp_like str [not] regexp_like regex Zwraca wartość true, jeśli str wartość nie jest zgodna regexz wartością .
rlike str [not] rlike regex Zwraca wartość true, jeśli str wartość nie jest zgodna regexz wartością .
/ dividend / divisor Zwraca wartość dividend podzieloną przez divisor.
~ ~ expr Zwraca bitowy ciąg NOT .expr

Kolejność wykonywania działań

Pierwszeństwo Operator
1 :, , ::, , ?::[ ]
2 -(jednoargumentowy), (jednoargumentowy), +~
3 *, , /, , %div
100 +, , -\|\|
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 opis
expr1 || wyrażenie2 Zwraca łączenie elementów expr1 i expr2.
aes_decrypt(wyrażenie, 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 set w ciągu BINARY reprezentującym mapę bitową.
btrim(str [, trimStr]) Zwraca z str usuniętymi znakami wiodącymi i końcowymi.
char(wyrażenie) Zwraca znak w podanym punkcie 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 elementu w str pozycji po pozycji pos.
chr(wyrażenie) Zwraca znak w podanym punkcie kodu UTF-16.
strExpr collationName Dołącza jawne sortowanie collationName do strExpr.
sortowanie [for] (strExpr) Zwraca ustawienia porządkowania przypisane do strExpr.
concat(expr1, expr2[, ...]) Zwraca łączenie argumentów.
concat_ws(sep[, expr1[, ...]]) Zwraca ciągi łączenia oddzielone ciągami sep.
contains(expr, subExpr) Zwraca wartość true , jeśli exprSTRING element lub BINARY zawiera subExprwartość .
crc32(wyrażenie) Zwraca cykliczną wartość sprawdzania nadmiarowości .expr
decode(expr, charSet) Tłumaczy binarne expr na ciąg znaków przy użyciu kodowania setcharSet.
encode(expr, charSet) Zwraca binarną reprezentację ciągu przy użyciu charSet kodowania znaków.
endswith(wyrażenie, endExpr) Zwraca wartość true if exprSTRING lub BINARY kończy się ciągiem endExpr.
find_in_set(searchExpr, sourceExpr) Zwraca pozycję ciągu w liście ciągów rozdzielonej przecinkami list.
format_number (wyrażenie, skala) Formaty, expr takie jak #,###,###.##, 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 z ciągów w formacie printf.
szesnastkowy (wyrażenie) Konwertuje na szesnastkowe expr .
str ilike (wzorzec[escape]) Zwraca wartość true, jeśli str nie patternescape jest uwzględniana wielkość liter.
initcap(wyrażenie) Zwraca expr pierwszą literę każdego wyrazu w wielkiej litery.
instr(str, substr) Zwraca indeks (oparty na 1) pierwszym wystąpieniu substr elementu w pliku str.
lcase(wyrażenie) Zwraca z expr wszystkimi znakami zmienionymi na małe litery.
left(str, len) Zwraca znaki z lewej strony len z str.
len(wyrażenie) 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]) Zwraca wartość true, jeśli str jest zgodna pattern z .escape
locate(substr, str[, pos]) Zwraca pozycję pierwszego wystąpienia substr elementu w str pozycji po pozycji pos.
lower(expr) Zwraca z expr wszystkimi znakami zmienionymi na małe litery.
lpad(wyrażenie, len[, pad]) Zwraca wartość expr, z lewej dopełnionej pad długością len.
ltrim([trimstr,] str) Zwraca znaki str wiodące w obrębie usuniętych trimStr znaków.
mask(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]]) Zwraca maskowaną wersję danych wejściowych str.
md5(wyrażenie) Zwraca 128-bitową sumę expr kontrolną MD5 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]) input Zastępuje element , replace który zaczyna się od pos i ma długość len.
nakładka(input PLACING replace FROM pos [FOR len]) input Zastępuje element , replace który zaczyna się od pos i ma długość len.
parse_url(url, partToExtract[, key]) Wyodrębnia część z elementu url.
position(podciąg, str[, pos]) Zwraca pozycję pierwszego wystąpienia substr elementu w str pozycji po pozycji pos.
position(podtr IN str) Zwraca pozycję pierwszego wystąpienia substr elementu w str pozycji po pozycji pos.
printf(strfmt[, obj1 [, ...]]) Zwraca sformatowany ciąg z ciągów w formacie 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, str który odpowiada wyrażeniu regexp i odpowiada indeksowi regex grupy.
regexp_extract_all(str, regexp[, idx]) Wyodrębnia wszystkie ciągi, które strregexp pasują do wyrażenia i odpowiada indeksowi regex grupy.
regexp_instr(str, regexp) Zwraca pozycję pierwszego podciągu w str tym dopasowaniu regexpelementu .
regexp_replace(str, regexp, rep[, position]) Zamienia wszystkie podciągy str tego dopasowania regexp na rep.
regexp_substr(str, regexp) Zwraca pierwszy podciąg w str tym elemecie zgodnym z regexpparametrem .
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.
reverse(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, len[, pad]) Zwraca element expr, dopełniony prawym przyciskiem pad do długości len.
rtrim([trimStr,] str) Zwraca z str 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 ciąg exprszesnastkowy .
sha1(wyrażenie) Zwraca wartość skrótu sha1 jako ciąg exprszesnastkowy .
sha2(wyrażenie, bitLength) Zwraca sumę kontrolną rodziny SHA-2 jako ciąg szesnastkowy .expr
soundex(wyrażenie) Zwraca kod soundex ciągu.
spacja(n) Zwraca ciąg składający się ze spacji n .
split(str, regex[, limit]) str Dzieli się wokół wystąpień, które są zgodne regex i zwraca tablicę o długości co najwyżej limit.
split_part(str, delim, partNum) str Dzieli się wokół wystąpień delim i zwraca partNum część.
startswith(wyrażenie, startExpr) Zwraca wartość true if 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(wyrażenie, ogranicznik, liczba) Zwraca podciąg expr przed count wystąpieniami ogranicznika delim.
to_binary(wyrażenie[, fmt]) Zwraca expr rzutowanie do pliku binarnego na fmtpodstawie elementu .
to_char(numExpr, fmt) Zwraca numExpr rzutowanie do STRING przy użyciu formatowania fmt."
to_varchar(numExpr, fmt) Zwraca numExpr rzutowanie do STRING przy użyciu formatowania fmt."
translate(wyrażenie, od, do) Zwraca exprwhere wszystkie znaki w from zostały zastąpione tymi w to.
trim([[OBA | WIODĄCY | KOŃCOWY] [trimStr] FROM] str) Przycinanie znaków z ciągu.
try_aes_decrypt(wyrażenie, 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 rzutowanie na BINARY podstawie fmtelementu 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 zwraca NULL wartość w przypadku błędu.
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 z expr wszystkimi znakami zmienionymi na wielkie litery.
unbase64(wyrażenie) Zwraca zdekodowany ciąg base64 jako binarny.
unhex(wyrażenie) Konwertuje szesnastkowe expr na BINARY.
upper(expr) Zwraca z expr wszystkimi znakami zmienionymi na wielkie litery.
url_decode(str) Tłumaczy ciąg z powrotem z formatu application/x-www-form-urlencoded .
url_encode(str) Tłumaczy ciąg na format application/x-www-form-urlencoded .
zstd_compress (wartość[,poziom[,streaming_mode]]) Zwraca wartość skompresowaną z kompresją Zstandard.
zstd_decompress(wartość) Zwraca wartość dekompresowaną przy użyciu kompresji Zstandard.

Funkcje skalarne liczbowe

Function opis
~ wyrażenie Zwraca bitowy ciąg NOT .expr
dywidenda /dzielnika Zwraca wartość dividend podzieloną przez divisor.
expr1 | wyrażenie2 Zwraca bitowe OR wartości expr1 i expr2.
— wyrażenie Zwraca negowaną wartość .expr
expr1 — wyrażenie2 Zwraca odejmowanie wartości expr2 z .expr1
+ wyrażenie Zwraca wartość expr.
expr1 + expr2 Zwraca sumę wartości expr1 i expr2.
dzielnika w % dywidendy 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żnik * mnożenie Zwraca wartość multiplier pomnożona przez multiplicandwartość .
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(wyrażenie) 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 set 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 położenie 0 bitów danej BIGINT liczby w zasobniku.
bitmap_bucket_number(wyrażenie) Zwraca numer zasobnika mapy bitowej dla danej BIGINT liczby.
bround(expr[,targetScale]) Zwraca zaokrąglony expr tryb zaokrąglania przy użyciu HALF_EVEN trybu zaokrąglania.
cbrt(wyrażenie) Zwraca pierwiastek modułu .expr
ceil(expr[,targetScale]) Zwraca najmniejszą liczbę nie mniejszą niż expr zaokrąglona w górę do targetScale cyfr względem separatora dziesiętnego.
ceiling(expr[,targetScale]) Zwraca najmniejszą liczbę nie mniejszą niż expr zaokrąglona w górę do targetScale cyfr względem separatora dziesiętnego.
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 cosecant wartości expr.
dziesiętne (wyrażenie) Rzutuje wartość expr na DECIMAL.
degrees(expr) Konwertuje radiany na stopnie.
dywidenda divisor div Zwraca integralną część dzielenia według divisordividendwartości .
double(wyrażenie) Rzutuje wartość expr na DOUBLE.
e() Zwraca stałą e.
exp(wyrażenie) Wraca 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ąglona w dół do targetScale cyfr względem separatora 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 wartości expr z wartością base 2.
log10(wyrażenie) Zwraca logarytm wartości expr z wartością base 10.
mod(dywidenda, dzielnica) Zwraca resztę po dividend / divisor.
nanvl(expr1, expr2) Zwraca wartość expr1 , jeśli nie NaNma wartości , lub expr2 w inny sposób.
negative(wyrażenie) Zwraca negowaną 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, dzielnica) Zwraca dodatnią resztę po .dividend / divisor
positive(wyrażenie) Zwraca wartość expr.
pow(wyrażenie1, wyrażenie2) expr1 Podnosi do potęgi .expr2
power(expr1, expr2) expr1 Podnosi 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[,targetScale]) Zwraca zaokrąglony expr tryb zaokrąglania przy użyciu HALF_UP trybu zaokrąglania.
s(wyrażenie) Zwraca sektę wartości expr.
shiftleft(wyrażenie, n) Zwraca bitową lewo przesuniętą przez n bity.
shiftright(wyrażenie, n) Zwraca cyfrę całkowitą ze znakiem bitowym w prawo przesuniętą według n bitów.
shiftrightunsigned(wyrażenie, n) Zwraca bitową niepodpisaną liczbę całkowitą w prawo przesuniętą według n bitów.
sign(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(wyrażenie) Zwraca tangens liczby expr.
tanh(wyrażenie) Zwraca tangens hiperboliczny wartości expr.
tinyint(wyrażenie) Rzutuje expr na TINYINT.
to_number(wyrażenie, fmt ) Zwraca expr rzutowanie do DECIMAL przy użyciu formatowania fmt.
try_add(wyrażenie1, wyrażenie2) Zwraca sumę expr1 wartości i expr2, lub NULL w przypadku błędu.
try_divide (dywidenda, dzielnica) Zwraca wartość dividend podzieloną przez divisorwartość , lub NULL wartość divisor 0.
try_mod (dywidenda, dzielnica) Zwraca resztę po dividend / divisor, lub NULL , jeśli divisor ma wartość 0..
try_multiply(mnożnik, mnożenie) Zwraca wartość multiplier pomnożona przez multiplicandwartość lub NULL przy przepełnieniu.
try_subtract(wyrażenie1, wyrażenie2) Zwraca odejmowanie expr2 wartości z expr1, lub NULL na przepełnieniu.
try_to_number(wyrażenie, fmt ) Zwraca expr rzutowanie do DECIMAL przy użyciu formatowania fmt, lub NULL jeśli expr nie jest zgodne z formatem.
uniform(expr1, expr2 [,seed]) Zwraca losową wartość o niezależnym i identycznym rozkładzie values w określonym przedziale liczbowym.
width_bucket(wyrażenie, minExpr, maxExpr, numBuckets) Zwraca liczbę zasobnika dla wartości w histogramie o szerokości równej.
"zeroifnull(expr)" Zwraca wartość expr , jeśli nie NULLjest to , lub 0 w inny sposób.

Funkcje agregujące

Function opis
any(wyrażenie) Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie ma wartość true.
any_value(wyrażenie[,ignoreNull]) Zwraca pewną wartość expr dla grupy wierszy.
approx_count_distinct(wyrażenie[,względneSD]) Zwraca szacowaną liczbę różnych values w expr w grupie.
approx_percentile(wyrażenie,procent[,dokładność]) Zwraca przybliżony percentyl expr w grupie.
approx_top_k(wyrażenie[,k[,maxItemsTracked]]) Zwraca najczęściej występujące k elementy values w expr wraz z ich przybliżoną liczbą wystąpień.
array_agg(wyrażenie) Zwraca tablicę zawierającą wszystkie elementy values w expr w ramach grupy.
avg(expr) Zwraca średnią obliczoną z values grupy.
bit_and (wyrażenie) Zwraca bitową AND dla wszystkich danych wejściowych values w grupie.
bit_or(wyrażenie) Zwraca wynik bitowego OR dla wszystkich values wejściowych w grupie.
bit_xor(wyrażenie) Zwraca wartość bitową XOR wszystkich elementów values wejściowych w grupie.
bitmap_construct_agg(wyrażenie) Zwraca bitowe OR wszystkich pozycji bitowych values w grupie. od 0 do 32767 w grupie jako BINARY.
bitmap_or_agg(wyrażenie) Zwraca bitowe OR wszystkich wejściowych BINARYvalues w grupie.
bool_and(wyrażenie) Zwraca wartość true, jeśli wszystkie values w expr są prawdziwe w ramach grupy.
bool_or(wyrażenie) Zwraca wartość true, jeśli co najmniej jedna wartość w expr elemecie ma wartość true w grupie.
collect_list(wyrażenie) Zwraca tablicę składającą się ze wszystkich values w expr w grupie.
collect_set(wyrażenie) Zwraca tablicę składającą się ze wszystkich unikalnych values w expr w ramach grupy.
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(wyrażenie[, ...]) Zwraca liczbę wierszy w grupie, dla której podane wyrażenia są inne niż null.
count_if (wyrażenie) Zwraca liczbę true values dla grupy w expr.
count_min_sketch(column,epsilon,przewidywalność,ziarno) Zwraca szkic zliczająco-minimalny wszystkich values w grupie column przy użyciu epsilon, confidence i seed.
covar_pop(wyrażenie1,wyrażenie2) Zwraca kowariancję populacji par liczbowych w grupie.
covar_samp(wyrażenie1,wyrażenie2) Zwraca wariancję przykładowej liczby par w grupie.
every(wyrażenie) Zwraca wartość true, jeśli wszystkie valuesexpr w grupie są prawdziwe.
first(expr[,ignoreNull]) Zwraca pierwszą wartość expr dla grupy wierszy.
first_value(wyrażenie[,ignoreNull]) 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 schemat HyperLogLog używany do przybliżania liczby różnych elementów values.
hll_union_agg(wyrażenie[,allowDifferentLgConfigK]) Agreguje szkice funkcji HyperLogLog dla grupy wierszy.
kurtosis(wyrażenie) Zwraca wartość kurtozy obliczoną z values grupy.
last(expr[,ignoreNull]) Zwraca ostatnią wartość expr dla grupy wierszy.
last_value(wyrażenie[,ignoreNull]) Zwraca ostatnią wartość expr dla grupy wierszy.
max(wyrażenie) Zwraca maksymalną wartość expr w grupie.
max_by(wyrażenie1,wyrażenie2) Zwraca wartość skojarzonej expr1 z maksymalną wartością expr2 w grupie.
mean(expr) Zwraca średnią obliczoną z values grupy.
median(wyrażenie) Zwraca medianę obliczoną z values grupy.
min(wyrażenie) 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ęściejszą wartość , a nie NULL, w expr grupie.
percentyl(wyrażenie, procent [,frequency]) Zwraca dokładną wartość percentyla dla expr określonego percentageelementu .
percentile_approx(wyrażenie,procent[,dokładność]) Zwraca przybliżony percentyl expr w grupie.
percentile_cont(pct) WITHIN GROUP (kluczORDER BY) Zwraca interpolowany percentyl key wewnątrz grupy.
percentile_disc(pct) W GRUPIE (kluczORDER BY) Zwraca dyskretny percentyl key wewnątrz grupy.
regr_avgx(yExpr, xExpr) Zwraca średnią xExpr obliczoną na podstawie values w grupie wherexExpr, a yExprNOT NULL.
regr_avgy(yExpr, xExpr) Zwraca średnią yExpr, obliczoną na podstawie values dla grupy wherezxExpr, gdzie yExprNOT 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 wherexExpr grupy i yExpr nie mają wartości NULL.
regr_r2(yExpr, xExpr) Zwraca współczynnik determinacji z grupy values, gdy where,xExpr i yExpr nie mają wartości NULL.
regr_slope(yExpr, xExpr) Zwraca nachylenie linii regresji liniowej par yExprxExpr wartości innych niż null w grupie.
regr_sxx(yExpr, xExpr) Zwraca sumę kwadratów xExprvalues grupy wherexExpr i yExpr nie mają wartości NULL.
regr_sxy(yExpr, xExpr) Zwraca sumę iloczynów yExpr i xExpr, obliczonych na podstawie values, z grupy wherexExpr, gdzie yExprNOT NULL.
regr_syy(yExpr, xExpr) Zwraca sumę kwadratów yExprvalues z grupy, gdzie wherexExpr i yExpr nie są NULL.
schema_of_json_agg(json[, opcje]) Zwraca połączone ciągi schema i JSON w grupie w formacie DDL.
schema_of_variant_agg(variantExpr) Zwraca połączone schema wszystkich VARIANTvalues w grupie w formacie DDL.
niesymetryczność (wyrażenie) Zwraca wartość niesymetryczności obliczoną z values 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 values w grupie.
stddev(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z values w grupie.
stddev_pop (wyrażenie) Zwraca odchylenie standardowe populacji obliczone z values grupy.
stddev_samp(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z values grupy.
sum(wyrażenie) Zwraca sumę obliczoną z values grupy.
try_avg (wyrażenie) Zwraca średnią obliczoną z values grupy, NULL, jeśli występuje przepełnienie.
try_sum(wyrażenie) Zwraca sumę obliczoną na podstawie values grupy, NULL, jeśli występuje przepełnienie.
var_pop(wyrażenie) Zwraca wariancję populacji obliczoną z values grupy.
var_samp(wyrażenie) Zwraca wariancję próbki obliczoną z values grupy.
wariancja (wyrażenie) Zwraca wariancję próbki obliczoną z values grupy.

Funkcje rankingowe window

Function opis
dense_rank() Zwraca rangę wartości względem wszystkich values w partition.
ntile(n) Dzieli wiersze dla każdego windowpartition na n przegródek od 1 do maksymalnie n.
percent_rank() Oblicza klasyfikację procentową wartości w partition.
rank() Zwraca klasyfikację wartości w porównaniu ze wszystkimi values w partition.
row_number() Przypisuje unikatową, sekwencyjną liczbę do każdego wiersza, zaczynając od jednego, zgodnie z kolejnością wierszy w windowpartition.

Funkcje analityczne window

Function opis
cume_dist() Zwraca pozycję wartości względem wszystkich values w partition.
lag(wyrażenie[,offset[,domyślne]]) Zwraca wartość expr z poprzedniego wiersza w ramach partition.
lead(expr[,offset[,default]]) Zwraca wartość expr z kolejnego wiersza wewnątrz partition.
nth_value(wyrażenie, offset[, ignoreNulls]) Zwraca wartość expr w określonym offset w window.

Funkcje tablicy

Function opis
arrayExpr[indexExpr] Zwraca element na pozycji indexExpr ARRAY arrayExpr.
aggregate(expr,start,merge[,finish]) Agreguje elementy w tablicy przy użyciu niestandardowego agregatora.
array([wyrażenie [, ...]]) Zwraca tablicę z elementami w elem.expr
array_append(tablica, elem) Zwraca array wartość dołączona przez elemelement .
array_compact(tablica) Usuwa NULL values z array.
array_contains(tablica,wartość) Zwraca wartość true, jeśli array zawiera valuewartość .
array_distinct(tablica) Usuwa zduplikowane values z array.
array_except(tablica1,tablica2) Zwraca tablicę elementów w array1 elemecie , ale nie w .array2
array_insert(tablica, indeks, elem) Zwraca rozwinięty arraywhereelem, który jest wstawiany na pozycji index.
array_intersect(tablica1,tablica2) Zwraca tablicę elementów we przecięciu elementów array1 i array2.
array_join(tablica,ogranicznik[,nullReplacement]) Łączy elementy elementu array.
array_max(tablica) Zwraca wartość maksymalną w elem.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, elem) Zwraca array wartość poprzedzoną ciągami elem.
array_remove(tablica,element) Usuwa wszystkie wystąpienia elementu element z .array
array_repeat(element,count) Zwraca tablicę zawierającą elementcount godziny.
array_size(tablica) Zwraca liczbę elementów w elem.array
array_sort(tablica,func) Zwraca array posortowane według func.
array_union(tablica1,tablica2) Zwraca tablicę elementów w unii i array1array2 bez duplikatów.
arrays_overlap(tablica1, tablica2) Zwraca wartość true, jeśli przecięcie elementu array1 i array2 nie jest puste.
arrays_zip(tablica1 [, ...]) Zwraca scaloną tablicę struktur, z których każda n-ta struktura zawiera wszystkie n-te elementy values z tablic wejściowych.
kardynalność (wyrażenie) Zwraca rozmiar expr.
concat(expr1, expr2 [, ...]) Zwraca łączenie argumentów.
element_at(arrayExpr, index) Zwraca element elementu arrayExpr at 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ę przy expr użyciu funkcji func.
flatten(arrayOfArrays) Przekształca tablicę tablic w jedną tablicę.
forall(expr, predFunc) Sprawdza, czy predFunc są przechowywane wszystkie elementy w tablicy.
get(arrayExpr, index) Zwraca element elementu arrayExpr na index, rozpoczynający się od 0.
inline(input) Eksploduje tablicę struktur w table.
inline_outer(input) Eksploduje tablicę struktur w table z semantykami zewnętrznymi.
posexplode(collection) Zwraca wiersze, usuwając zagnieżdżanie tablicy z numerowaniem pozycji.
posexplode_outer(kolekcja) Zwraca wiersze, usuwając zagnieżdżanie tablicy z numerowaniem pozycji przy użyciu OUTER semantyki.
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 z start do stop (włącznie), zwiększa się przez step.
shuffle(array) Zwraca losową permutację tablicy w elem expr.
size(expr) Zwraca kardynalność wartości expr.
slice(expr,start,length) Zwraca podzbiór tablicy.
sort_array(wyrażenie[,rosnącoorder]) 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 typu arrayExpr at indexlub NULL , jeśli index jest poza granicą.
zip_with(wyrażenie1, wyrażenie2, func) Scala tablice w expr1 elementach i , expr2w jedną tablicę przy użyciu polecenia func.

Funkcje mapy

Function opis
mapExpr[keyExpr] Zwraca wartość na mapie keyExprmapExpr.
kardynalność (wyrażenie) 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([wyrażenie1 [, ...]]) Zwraca połączenie wszystkich expr wyrażeń mapy.
map_contains_key (mapa, klucz) Zwraca wartość true , jeśli map element zawiera keywartość , false w przeciwnym razie.
map_entries(mapa) Zwraca nieurządkowaną tablicę wszystkich wpisów w obiekcie map.
map_filter(wyrażenie, func) Filtruje wpisy na mapie przy expr użyciu funkcji func.
map_from_arrays(klucze, values) Tworzy mapę z parą keys tablic 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ą valuesmap.
map_zip_with(map1, map2, func) Scala 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, func) Przekształca values na mapie w 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 opis
intervalExpr/dzielnika Zwraca interwał podzielony przez divisor.
- intervalExpr Zwraca negowaną wartość .intervalExpr
intervalExpr1 — intervalExpr2 Zwraca odejmowanie wartości intervalExpr2 z .intervalExpr1
datetimeExpr1 — datetimeExpr2 Zwraca odejmowanie wartości datetimeExpr2 z .datetimeExpr1
+ interwałExpr Zwraca wartość intervalExpr.
intervalExpr1 + intervalExpr2 Zwraca sumę wartości intervalExpr1 i intervalExpr2.
intervalExpr * multiplicand Zwraca wartość intervalExpr pomnożona przez multiplicandwartość .
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 bieżącą sesję lokalną timezone.
date(expr) Rzutuje wartość expr na DATE.
date_add(startDate,numDays) Zwraca datę numDays po startDate.
date_add(jednostka, wartość, wyrażenie) Dodaje valueunitelement do znacznika exprczasu .
date_diff(jednostka, uruchamianie, zatrzymywanie) Zwraca różnicę między dwoma znacznikami czasu mierzonymi w units.
date_format(wyrażenie,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) Wyodrębnia część daty, znacznika czasu lub interwału.
date_sub(startDate,numDays) Zwraca datę numDays przed startDate.
date_trunc(jednostka,wyrażenie) Zwraca znacznik czasu obcięty do jednostki określonej w unit.
dateadd(startDate,numDays) Zwraca datę numDays po startDate.
dateadd(jednostka, wartość, wyrażenie) Dodaje valueunitelement do znacznika exprczasu .
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(wyrażenie) Zwraca dzień miesiąca daty lub znacznika czasu.
dayofweek(wyrażenie) Zwraca dzień tygodnia daty lub znacznika czasu.
dayofyear(wyrażenie) Zwraca dzień roku daty lub znacznika czasu.
dywidenda divisor div Zwraca integralną część dzielenia interwału według interwału divisordividend.
extract(pole ZE źródła) Zwraca wartość fieldsource.
from_unixtime(unixTime,fmt) Zwraca wartość unixTime w pliku fmt.
from_utc_timestamp(expr,timezone) Zwraca znacznik czasu dla UTC znacznika expr czasu o wartości timeZone.
getdate() Zwraca bieżący znacznik czasu na początku oceny zapytania.
hour(expr) Zwraca składnik godziny 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 yearpól , monthi day .
make_dt_interval([dni[, godziny[, min[, s]]]]) Tworzy interwał dnia z dayswartości , hoursmins i secs.
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) Przestarzałe: tworzy interwał z yearswartości , , monthsweeks, days, hoursminsi secs.
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,timezone]) Tworzy znacznik czasu na podstawie yearpól , , monthdayhourmin, seci .timezone
make_ym_interval([lata[, miesiące]]) Tworzy interwał roku na podstawie yearswartości i months.
minute(wyrażenie) Zwraca składnik minuty znacznika czasu w elemencie expr.
month(expr) Zwraca składnik miesiąca znacznika czasu w elemencie expr.
months_between(wyrażenie1,wyrażenie2[,roundOff]) Zwraca liczbę miesięcy, które upłynęły między datami lub znacznikami czasu w i expr1expr2.
next_day(wyrażenie,dayOfWeek) Zwraca pierwszą datę, która jest późniejsza niż expr i nazwana jako w pliku dayOfWeek.
now() Zwraca bieżący znacznik czasu na początku oceny zapytania.
quarter(wyrażenie) Zwraca kwartał roku dla expr zakresu od 1 do 4.
second(wyrażenie) Zwraca drugi składnik znacznika czasu w elemencie expr.
session_window (wyrażenie, gpDuration) Tworzy sesję-window na podstawie wyrażenia znacznika czasu.
sign(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.
sygnatura czasowa (wyrażenie) Rzutuje expr na TIMESTAMP.
timestamp_micros(wyrażenie) Tworzy mikrosekundy expr znacznika czasu od epoki UTC.
timestamp_millis (wyrażenie) Tworzy znacznik expr czasu milisekund od epoki UTC.
timestamp_seconds(wyrażenie) Tworzy znacznik expr czasu sekund od epoki UTC.
timestampadd(jednostka, wartość, wyrażenie) Dodaje valueunitelement do znacznika exprczasu .
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 rzutowanie do znacznika czasu przy użyciu opcjonalnego formatowania.
to_unix_timestamp(wyrażenie[,fmt]) Zwraca znacznik czasu w expr pliku jako sygnaturę czasową systemu UNIX.
to_utc_timestamp(wyrażenie,timezone) Zwraca znacznik czasu dla UTC znacznika expr czasu o wartości timezone.
trunc(wyrażenie, fmt) Zwraca datę z częścią daty obciętą do jednostki określonej przez model fmtformatu .
try_add(wyrażenie1, wyrażenie2) Zwraca sumę expr1 wartości i expr2, lub NULL w przypadku błędu.
try_divide (dywidenda, dzielnica) Zwraca wartość dividend podzieloną przez divisorwartość , lub NULL, jeśli divisor ma wartość 0.
try_multiply(mnożnik, mnożenie) Zwraca wartość multiplier pomnożona przez multiplicandwartość lub NULL przy przepełnieniu.
try_subtract(wyrażenie1, wyrażenie2) Zwraca odejmowanie expr2 wartości z expr1, lub NULL na przepełnieniu.
try_to_timestamp(wyrażenie[,fmt]) Zwraca expr rzutowanie do znacznika czasu przy użyciu opcjonalnego formatowania lub NULL jeśli rzutowanie zakończy 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]]) wywraca znacznik czasu systemu UNIX 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(wyrażenie, szerokość[, krok[, początek]]) Tworzy mechanizm przesuwania bazujący na przeskokach —window w wyrażeniu znacznika czasu.
window_time(window) Zwraca czas zakończenia inkluzywnego przesuwaniawindow generowanego przez funkcje window lub session_window.

Funkcje geoprzestrzenne H3

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

Rzutowanie funkcji i konstruktorów

Aby uzyskać informacje o rzutowaniu między typami, zobacz funkcja rzutu i funkcja try_cast.

Function opis
array([wyrażenie [, ...]]) Zwraca tablicę z elementami w elem.expr
bigint(wyrażenie) Rzutuje wartość expr na BIGINT.
binary(expr) Rzutuje wartość expr na BINARY.
wartość logiczna (wyrażenie) Rzutuje expr na BOOLEAN.
cast(expr AS type) Rzutuje wartość expr na docelowy typ typedanych .
wyrażenie :: typ Rzutuje wartość expr na docelowy typ typedanych .
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 yearpól , monthi day .
make_dt_interval([dni[, godziny[, min[, s]]]]) Tworzy interwał dnia z dayswartości , hoursmins i secs.
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) Tworzy interwał na podstawie yearswartości , , months, weeksdays, hoursmins i secs.
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,timezone]) Tworzy znacznik czasu na podstawie yearpól , , monthdayhourmin, seci .timezone
make_ym_interval([lata[, miesiące]]) Tworzy interwał roku na podstawie yearswartości i months.
map([{key1, wartość1} [, ...]]) Tworzy mapę z określonymi parami klucz-wartość.
named_struct({name1, val1} [, ...]) Tworzy strukturę z określonymi nazwami pól i values.
smallint(wyrażenie) Rzutuje wartość expr na SMALLINT.
string(wyrażenie) Rzutuje wartość expr na STRING.
struct(expr1 [, ...]) Tworzy STRUCT z określonym polem values.
tinyint(wyrażenie) Rzutuje expr na TINYINT.
sygnatura czasowa (wyrażenie) Rzutuje expr na TIMESTAMP.
to_char(wyrażenie, fmt) Zwraca expr rzutowanie do STRING przy użyciu formatowania fmt."
to_date(wyrażenie[,fmt]) Zwraca expr rzutowanie do daty przy użyciu opcjonalnego formatowania.
to_number(wyrażenie, fmt) Zwraca expr rzutowanie do DECIMAL przy użyciu formatowania fmt.
to_timestamp(wyrażenie[,fmt]) Zwraca expr rzutowanie do znacznika czasu przy użyciu opcjonalnego formatowania.
to_varchar (wyrażenie, fmt) Zwraca expr rzutowanie do STRING przy użyciu formatowania fmt."
try_cast (typ wyrażenie AS) Bezpiecznie rzutuje wartość expr na docelowy typ type danych.
try_to_number(wyrażenie, fmt) Zwraca expr rzutowanie do DECIMAL przy użyciu formatowania fmt, lub NULL jeśli expr nie jest prawidłowe.

Funkcje CSV i Avro

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

Funkcje JSON

Function opis
jsonStr: jsonPath Zwraca pola wyodrębnione z obiektu jsonStr.
from_json(jsonStr, schema[, opcje]) 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 tablicy najbardziej zewnętrznej JSON .
json_object_keys(jsonObject) Zwraca wszystkie klucze obiektu najbardziej zewnętrznego JSON jako tablicę.
json_tuple(jsonStr, path1 [, ...]) Zwraca wiele JSON obiektów jako krotkę.
parse_json(jsonStr) VARIANT Zwraca wartość z .jsonStr
schema_of_json(jsonStr[, options]) Zwraca schema ciągu JSON w formacie DDL.
schema_of_json_agg(jsonStr[, options]) Zwraca połączone schema 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 opis
variantExpr: jsonPath Zwraca pola wyodrębnione ze ścieżki variantExpr JSON.
is_variant_null(variantExpr) Sprawdza, czy variantExpr element jest zakodowany VARIANTNULLw formacie .
parse_json(jsonStr) VARIANT Zwraca wartość z .jsonStr
schema_of_variant(variantExpr) Zwraca schema wyrażenia VARIANT w formacie DDL.
schema_of_variant_agg(variantExpr) Zwraca połączone schema wszystkich VARIANTvalues 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.
try_parse_json(jsonStr) VARIANT Zwraca wartość 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ść type typu z variantExpr, określonej przez path, lub NULL jeśli nie jest możliwe rzutowanie do typu docelowego.
variant_explode(input) Zwraca set wierszy przez wyodrębnienie input.
variant_explode_outer(dane wejściowe) Zwraca set wierszy przez rozgnieżdżanie input z użyciem semantyki zewnętrznej.
variant_get(variantExpr,path,type) Wyodrębnia wartość type typu z variantExprklasy , określoną przez path.

Funkcje XPath i XML

Function opis
from_xml(xmlStr, schema[, opcje]) Zwraca wartość struktury przeanalizowaną z xmlStr metody using schema.
schema_of_xml(xmlStr[, opcje]) Zwraca schema ciągu XML w formacie DDL.
xpath(xml, xpath) Zwraca values w węzłach xml, które są zgodne z xpath.
xpath_boolean(xml, xpath) Zwraca wartość true , jeśli xpath wyrażenie zwróci wartość true, lub jeśli zostanie znaleziony pasujący węzeł 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 opis
ai_analyze_sentiment(zawartość) Zwraca tonację 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, time_col) Extropolates dane szeregów czasowych do przyszłości.
ai_gen(zawartość) Wywołuje najnowocześniejsze model generowania sztucznej inteligencji z interfejsów API modelu usługi Databricks Foundation, 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) z monitem.
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 modelu sztucznej inteligencji mozaiki i analizuje i zwraca jego odpowiedź.
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ń względem indeksu wyszukiwania wektora sztucznej inteligencji mozaiki przy użyciu języka SQL.

Funkcje odczytu

Function opis
read_files(ścieżka, [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({parametr => wartość} [, ...]) Zwraca table z rekordami odczytanymi z Kinesis z jednego lub kilku strumieni.
read_pubsub([parametr => wartość] [, ...]) Funkcja o wartości table do odczytywania rekordów z Pub/Sub z topicu.
read_pulsar({optionKey => optionValue} [, ...]) Zwraca table z rekordami odczytanymi z pulsaru.
read_state_metadata(ścieżka) Zwraca table z wierszami reprezentującymi metadane dotyczące stanu zapytania przesyłania strumieniowego.
read_statestore(ścieżka [, option_key => option_value] [...]) Zwraca rekordy z magazynu stanów zapytań przesyłanych strumieniowo.

Różne funkcje

Function 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 wartość dla pierwszej condN wartości, która daje wartość true lub def jeśli nie zostanie znaleziona żadna.
cloud_files_state( { TABLE(table) | punkt kontrolny } ) Zwraca stan na poziomie pliku źródła autoloadera cloud_files .
coalesce(wyrażenie1, wyrażenie2 [, ...]) Zwraca pierwszy argument inny niż null.
sortowania() Zwraca list dostępnych sortowań.
cube (wyrażenie1 [, ...]) Tworzy wielowymiarową kostkę przy użyciu określonego wyrażenia columns.
current_catalog() Zwraca bieżący catalog.
current_database() Zwraca bieżący schema.
current_metastore() Zwraca bieżący identyfikator magazynu metadanych Catalog Unity.
current_recipient(klucz) Zwraca właściwość bieżącego adresata w widoku udostępnionym do udostępniania różnicowego.
current_schema() Zwraca bieżący schema.
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 wyrażenie nth.
equal_null(wyrażenie1, wyrażenie2) Zwraca wartość true , jeśli expr1 wyrażenia są równe expr2 lub oba wyrażenia to NULL, lub false w inny sposób.
event_log( { TABLE(table) | pipeline_id } ) Zwraca table z historii refresh dla zmaterializowanego widoku, przesyłania strumieniowego tablelub potoku DLT.
greatest(expr1, expr2 [, ...]) Zwraca największą wartość wszystkich argumentów, pomijając wartość null values.
grouping(col) Wskazuje, czy określona column w GROUPING SET, ROLLUPlub CUBE reprezentuje sumę częściową.
grouping_id([col1 [, ...]]) Zwraca poziom grupowania dla setcolumns.
hash(expr1 [, ...]) Zwraca wartość skrótu argumentów.
hll_sketch_estimate(wyrażenie) Szacuje liczbę unikatowych values zebranych w szkicu HyperLogLog.
hll_union(wyrażenie1, wyrażenie2 [,allowDifferentLgConfigK]) Łączy dwa szkice funkcji HyperLogLog.
java_method(klasa, metoda[, arg1 [, ...]]) Wywołuje metodę z odbiciem.
if(cond, expr1, expr2) Zwraca wartość expr1 , jeśli cond ma wartość true, lub expr2 w inny sposób.
iff(cond, expr1, expr2) Zwraca wartość expr1 , jeśli cond ma wartość true, lub expr2 w inny sposób.
ifnull(expr1, expr2) Zwraca wartość expr2 , jeśli expr1 ma wartość NULL, lub expr1 w inny sposób.
input_file_block_length() Zwraca długość w bajtach odczytywanego bloku.
input_file_block_start() Zwraca początek offset 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 wartość true , jeśli expr nie NULLma wartości .
least(wyrażenie1, wyrażenie2 [, ...]) Zwraca najmniejszą wartość wszystkich argumentów, pomijając wartość null values.
list_secrets([scopeStr]) Zwraca klucze we wszystkich lub jednym zakresie, który użytkownik ma autoryzację do wyświetlenia z usługi wpisów tajnych usługi Databricks.
luhn_check(numStr) Zwraca wartość true , jeśli numStr przekazuje sprawdzanie algorytmu Luhn.
monotonically_increasing_id() Zwraca monotonicznie zwiększające 64-bitowe liczby całkowite.
nullif(expr1, expr2) Zwraca wartość NULL , jeśli expr1 równa expr2się , lub expr1 w inny sposób.
nvl(wyrażenie1, wyrażenie2) Zwraca wartość expr2 , jeśli expr1 ma wartość NULL, lub expr1 w inny sposób.
nvl2(expr1, expr2, expr3) Zwraca wartość expr2 , jeśli expr1 nie NULLma wartości , lub expr3 w inny sposób.
raise_error (wyrażenie) Zgłasza wyjątek jako expr komunikat.
range(end) Zwraca wartość table z values w określonym zakresie.
range(start, end [, step [, numParts]]) Zwraca table z values w określonym zakresie.
reflect(klasa, metoda[, arg1 [, ...]]) Wywołuje metodę z odbiciem.
secret(scope, key) Wyodrębnia wartość wpisu tajnego z daną scope i key z usługi wpisów tajnych usługi Databricks.
session_user() Zwraca użytkownika połączonego z usługą Azure Databricks.
spark_partition_id() Zwraca bieżący identyfikator partition.
sql_keywords() Zwraca set 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 rejestr zmian w Delta Lake table z włączoną funkcją śledzenia zmian danych.
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ść wpisu tajnego z daną scope i key z usługi wpisów tajnych usługi Databricks lub NULL jeśli nie można pobrać klucza.
typeof(wyrażenie) Zwraca ciąg typu w formacie DDL dla typu danych .expr
user() Zwraca użytkownika wykonującego instrukcję .
uuid() Zwraca uniwersalnie unikatowy ciąg znaków identifier (uniwersalny identyfikator unikalny, UUID).
window(wyrażenie, szerokość[, krok [, początek]]) Tworzy mechanizm "ślizgania" oparty na przeskokach w wyrażeniu znacznika czasu —window.
xxhash64(wyrażenie1 [, ...]) Zwraca 64-bitową wartość skrótu argumentów.
version() Zwraca wersję platformy Apache Spark.