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, czy argumenty nie mają różnych wartości, w których NULLargumenty są uznawane za porównywalne wartości.
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 ustawionych w ciągu reprezentującym BINARY 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 dane binarne expr na ciąg przy użyciu kodowania charSetzestawu znaków .
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 położenie ciągu w rozdzielanej przecinkami liście ciągów.
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 element, w expr którym wszystkie znaki from zostały zamienione na znaki w pliku 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 ustawionych w argumencie.
bit_get(wyrażenie, pos) Zwraca wartość bitu w binarnej reprezentacji całkowitej liczbowej.
bit_reverse(wyrażenie) Zwraca wartość uzyskaną przez odwrócenie kolejności bitów w argumencie.
bitmap_bit_position(wyrażenie) Zwraca 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 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 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ę unikatowych wartości w expr 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 k występujące wartości elementów w elemencie expr wraz z ich przybliżonymi liczbami.
array_agg(wyrażenie) Zwraca tablicę składającą się ze wszystkich wartości w expr grupie.
avg(expr) Zwraca średnią obliczoną na podstawie wartości grupy.
bit_and (wyrażenie) Zwraca bitowo AND wszystkich wartości wejściowych w grupie.
bit_or(wyrażenie) Zwraca bitowo OR wszystkich wartości wejściowych w grupie.
bit_xor(wyrażenie) Zwraca bitowo XOR wszystkich wartości wejściowych w grupie.
bitmap_construct_agg(wyrażenie) Zwraca bitowe OR wartości pozycji wszystkich bitów w grupie. od 0 do 32767 w grupie jako BINARY.
bitmap_or_agg(wyrażenie) Zwraca bitowo OR wszystkich BINARY wartości wejściowych w grupie.
bool_and(wyrażenie) Zwraca wartość true, jeśli wszystkie wartości w expr grupie mają wartość true.
bool_or(wyrażenie) Zwraca wartość true, jeśli co najmniej jedna wartość w expr elemecie ma wartość true w grupie.
collect_list(wyrażenie) Zwraca tablicę składającą się ze wszystkich wartości w expr grupie.
collect_set(wyrażenie) Zwraca tablicę składającą się ze wszystkich unikatowych wartości w expr 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(wyrażenie[, ...]) Zwraca liczbę wierszy w grupie, dla której podane wyrażenia są inne niż null.
count_if (wyrażenie) Zwraca liczbę wartości true dla grupy w pliku expr.
count_min_sketch(kolumna,epsilon,ufność,nasion) Zwraca minimalny szkic liczby wszystkich wartości w grupie w column liczbie z elementami epsiloni confidenceseed.
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 wartości expr w grupie mają wartość true.
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 szkic funkcji HyperLogLog używany do przybliżonej liczby unikatowych wartości.
hll_union_agg(wyrażenie[,allowDifferentLgConfigK]) Agreguje szkice funkcji HyperLogLog dla grupy wierszy.
kurtosis(wyrażenie) Zwraca wartość kurtozy obliczoną na podstawie wartości 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ą na podstawie wartości grupy.
median(wyrażenie) Zwraca medianę obliczaną na podstawie wartości 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 (ORDER BY key) Zwraca interpolowany percentyl key wewnątrz grupy.
percentile_disc(pct) WITHIN GROUP (ORDER BY key) Zwraca dyskretny percentyl key wewnątrz grupy.
regr_avgx(yExpr, xExpr) Zwraca średnią obliczoną xExpr z wartości grupy, gdzie xExpr i yExpr to NOT NULL.
regr_avgy(yExpr, xExpr) Zwraca średnią obliczoną yExpr z wartości grupy, gdzie xExpr i yExpr to 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 yExprxExpr wartości innych niż null w grupie.
regr_sxx(yExpr, xExpr) Zwraca sumę kwadratów xExpr wartości grupy, gdzie xExpr i yExpr nie mają wartości NULL.
regr_sxy(yExpr, xExpr) Zwraca sumę produktów i yExprxExpr obliczoną na podstawie wartości grupy, gdzie xExpr i yExpr są wartościami NOT NULL.
regr_syy(yExpr, xExpr) Zwraca sumę kwadratów yExpr wartości grupy, gdzie xExpr i yExpr nie mają wartości 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.
niesymetryczność (wyrażenie) Zwraca wartość niesymetryczności obliczoną na podstawie wartości grupy.
some(wyrażenie) Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie to true.
std(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z wartości w grupie.
stddev(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z wartości w grupie.
stddev_pop (wyrażenie) Zwraca odchylenie standardowe populacji obliczone z wartości grupy.
stddev_samp(wyrażenie) Zwraca odchylenie standardowe próbki obliczone z wartości grupy.
sum(wyrażenie) Zwraca sumę obliczaną na podstawie wartości grupy.
try_avg (wyrażenie) Zwraca średnią obliczoną na podstawie wartości grupy, NULL jeśli występuje przepełnienie.
try_sum(wyrażenie) Zwraca sumę obliczoną na podstawie wartości grupy, NULL jeśli istnieje przepełnienie.
var_pop(wyrażenie) Zwraca wariancję populacji obliczoną na podstawie wartości grupy.
var_samp(wyrażenie) Zwraca wariancję próbki obliczoną na podstawie wartości grupy.
wariancja (wyrażenie) Zwraca wariancję próbki obliczoną na podstawie wartości grupy.

Funkcje okna klasyfikacji

Function opis
dense_rank() Zwraca rangę wartości w porównaniu ze wszystkimi wartościami w partycji.
ntile(n) Dzieli wiersze dla każdej partycji okna na n zasobników od 1 do najwyżej 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 opis
cume_dist() Zwraca położenie wartości względem wszystkich wartości w partycji.
lag(expr[,offset[,default]]) Zwraca wartość expr z poprzedniego wiersza w partycji.
lead(expr[,offset[,default]]) Zwraca wartość expr z kolejnego wiersza w partycji.
nth_value(wyrażenie, przesunięcie[, ignorujNulls]) Zwraca wartość expr wartości określonej offset w oknie.

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 wartości NULL z arrayelementu .
array_contains(tablica,wartość) Zwraca wartość true, jeśli array zawiera valuewartość .
array_distinct(tablica) Usuwa zduplikowane wartości z arrayelementu .
array_except(tablica1,tablica2) Zwraca tablicę elementów w array1 elemecie , ale nie w .array2
array_insert(tablica, indeks, elem) Zwraca rozwinięty array obiekt, w którym elem jest wstawiony w index miejscu.
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, w których n., struktura zawiera wszystkie Nth wartości 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 tabeli.
inline_outer(input) Eksploduje tablicę struktur w tabeli 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, wartości) 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ą wartości map.
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 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 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ę lokalnej strefy czasowej.
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(wyrażenie,strefa czasowa) 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[,strefa czasowa]) 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 okno sesji w wyrażeniu 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,strefa czasowa) 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(expr, width[, step[, start]]) Tworzy okno przesuwane na podstawie przeskoku w wyrażeniu znacznika czasu.
window_time(okno) 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.

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[,strefa czasowa]) 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 i wartościami pól.
smallint(wyrażenie) Rzutuje wartość expr na SMALLINT.
string(wyrażenie) Rzutuje wartość expr na STRING.
struct(expr1 [, ...]) Tworzy obiekt STRUCT z określonymi wartościami pól.
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[, 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 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[, 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 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 schemat JSON ciągu w formacie DDL.
schema_of_json_agg(jsonStr[, options]) 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 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 schemat VARIANT wyrażenia 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.
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 zestaw wierszy przez anulowanie zagnieżdżania input.
variant_explode_outer(dane wejściowe) Zwraca zestaw wierszy przez anulowanie zagnieżdżania input przy użyciu semantyki zewnętrznej.
variant_get(variantExpr,path,type) Wyodrębnia wartość type typu z variantExprklasy , określoną przez path.

Funkcje XPath i XML

Function opis
from_xml(xmlStr, schema[, options]) Zwraca wartość struktury przeanalizowaną z xmlStr metody using schema.
schema_of_xml(xmlStr[, opcje]) Zwraca schemat XML ciągu w formacie DDL.
xpath(xml, xpath) Zwraca wartości w węzłach, które są zgodne xmlz xpath parametrem .
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 tabelę z rekordami odczytanymi z kinezy z co najmniej jednego strumienia.
read_pubsub([parametr => wartość] [, ...]) Funkcja z wartością tabeli do odczytywania rekordów z pubu/pod tematu.
read_pulsar({optionKey => optionValue} [, ...]) Zwraca tabelę z rekordami odczytanymi z pulsaru.
read_state_metadata(ścieżka) Zwraca tabelę z wierszami reprezentującymi metadane 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) | checkpoint } ) 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 kolacji.
cube (wyrażenie1 [, ...]) Tworzy wielowymiarowy moduł 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 magazynu metadanych wykazu aparatu 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 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 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 tabelę historii odświeżania dla zmaterializowanego widoku, tabeli przesyłania strumieniowego lub potoku DLT.
greatest(expr1, expr2 [, ...]) Zwraca największą wartość wszystkich argumentów, pomijając wartości null.
grouping(col) Wskazuje, czy określona kolumna w obiekcie GROUPING SET, ROLLUPlub CUBE reprezentuje sumę częściową.
grouping_id([col1 [, ...]]) Zwraca poziom grupowania dla zestawu kolumn.
hash(expr1 [, ...]) Zwraca wartość skrótu argumentów.
hll_sketch_estimate(wyrażenie) Szacuje liczbę unikatowych wartości zebranych w szkicu funkcji 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 przesunięcie początkowe w bajtach odczytywanego bloku.
input_file_name() Zwraca nazwę odczytywanego pliku lub pusty ciąg, jeśli nie jest dostępny.
is_account_group_member(grupa) Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie konta.
is_member(grupa) Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie obszaru roboczego.
isnull(wyrażenie) Zwraca wartość true , jeśli expr ma wartość NULL.
isnotnull(wyrażenie) Zwraca wartość true , jeśli expr nie NULLma wartości .
least(wyrażenie1, wyrażenie2 [, ...]) Zwraca najmniejszą wartość wszystkich argumentów, pomijając wartości null.
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 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ę 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 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 usługi Delta Lake z włączonym zestawieniem danych zmian.
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 ciąg uniwersalnego unikatowego identyfikatora (UUID).
window(expr, width[, step [, start]]) Tworzy okno przesuwane na podstawie przeskoku w wyrażeniu znacznika czasu.
xxhash64(wyrażenie1 [, ...]) Zwraca 64-bitową wartość skrótu argumentów.
version() Zwraca wersję platformy Apache Spark.