Funkcje wbudowane
Dotyczy: Databricks SQL 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 expr1 expr2 . |
* | multiplier * multiplicand |
Zwraca wartość multiplier pomnożona przez multiplicand wartość . |
!= | 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 indexExpr drugi element elementu .ARRAY arrayExpr |
[ ] | mapExpr [ keyExpr ] |
Zwraca wartość z keyExpr wartości .MAP mapExpr |
^ | 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 type danych . |
?:: | 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 dividend divisor wartoś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 expr2 się , lub false w inny sposób. |
= | expr1 = expr2 |
Zwraca wartość true , jeśli expr1 równa expr2 się , 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 exprN wartoś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 NULL argumenty 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ą NULL wartoś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 expr1 expr2 . |
% | dividend % divisor |
Zwraca resztę po dividend / divisor . |
|| | expr1 \|\| expr2 |
Zwraca łączenie elementów expr1 i expr2 . |
| | expr1 \| expr2 |
Zwraca bitowe OR wartości expr1 i expr2 . |
+ | expr1 + expr2 |
Zwraca sumę wartości expr1 i expr2 . |
regexp | str [not] regexp regex |
Zwraca wartość true, jeśli str wartość nie jest zgodna regex z wartością . |
regexp_like | str [not] regexp_like regex |
Zwraca wartość true, jeśli str wartość nie jest zgodna regex z wartością . |
rlike | str [not] rlike regex |
Zwraca wartość true, jeśli str wartość nie jest zgodna regex z 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 , regexp ilike , , 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 expr STRING element lub BINARY zawiera subExpr wartość . |
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 charSet zestawu 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 expr STRING 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 pattern escape 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. |
|
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 str regexp pasują do wyrażenia i odpowiada indeksowi regex grupy. |
regexp_instr(str, regexp) | Zwraca pozycję pierwszego podciągu w str tym dopasowaniu regexp elementu . |
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 regexp parametrem . |
repeat(wyrażenie, n) | Zwraca ciąg, który powtarza się razy expr n . |
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 expr szesnastkowy . |
sha1(wyrażenie) | Zwraca wartość skrótu sha1 jako ciąg expr szesnastkowy . |
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 expr STRING 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 fmt podstawie 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 fmt elementu 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 multiplicand wartość . |
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_NTZ sourceTs 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 divisor dividend wartoś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 NaN ma 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 divisor wartość , 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 multiplicand wartość 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 NULL jest 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 epsilon i confidence 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 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 expr numBins 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 percentage elementu . |
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 yExpr xExpr 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 yExpr xExpr 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 yExpr xExpr 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 elem element . |
array_compact(tablica) | Usuwa wartości NULL z array elementu . |
array_contains(tablica,wartość) | Zwraca wartość true, jeśli array zawiera value wartość . |
array_distinct(tablica) | Usuwa zduplikowane wartości z array elementu . |
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ą element count 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 array1 array2 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. |
|
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 index lub NULL , jeśli index jest poza granicą. |
zip_with(wyrażenie1, wyrażenie2, func) | Scala tablice w expr1 elementach i , expr2 w jedną tablicę przy użyciu polecenia func . |
Funkcje mapy
Function | opis |
---|---|
mapExpr[keyExpr] | Zwraca wartość na mapie keyExpr mapExpr . |
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 key wartość , 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 multiplicand wartość . |
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 value unit element do znacznika expr czasu . |
date_diff(jednostka, uruchamianie, zatrzymywanie) | Zwraca różnicę między dwoma znacznikami czasu mierzonymi w unit s. |
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 value unit element do znacznika expr czasu . |
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 unit s. |
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 divisor dividend . |
extract(pole ZE źródła) | Zwraca wartość field source . |
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 year pól , month i day . |
make_dt_interval([dni[, godziny[, min[, s]]]]) | Tworzy interwał dnia z days wartości , hours mins i secs . |
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) | Przestarzałe: tworzy interwał z years wartości , , months weeks , days , hours mins i secs . |
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,strefa czasowa]) | Tworzy znacznik czasu na podstawie year pól , , month day hour min , sec i .timezone |
make_ym_interval([lata[, miesiące]]) | Tworzy interwał roku na podstawie years wartoś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 expr1 expr2 . |
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 unit s. |
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 value unit element do znacznika expr czasu . |
timestampdiff(jednostka, uruchamianie, zatrzymywanie) | Zwraca różnicę między dwoma znacznikami czasu mierzonymi w unit s. |
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 fmt formatu . |
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 divisor wartość , lub NULL, jeśli divisor ma wartość 0. |
try_multiply(mnożnik, mnożenie) | Zwraca wartość multiplier pomnożona przez multiplicand wartość 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 type danych . |
wyrażenie :: typ | Rzutuje wartość expr na docelowy typ type danych . |
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 year pól , month i day . |
make_dt_interval([dni[, godziny[, min[, s]]]]) | Tworzy interwał dnia z days wartości , hours mins i secs . |
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) | Tworzy interwał na podstawie years wartości , , months , weeks days , hours mins i secs . |
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,strefa czasowa]) | Tworzy znacznik czasu na podstawie year pól , , month day hour min , sec i .timezone |
make_ym_interval([lata[, miesiące]]) | Tworzy interwał roku na podstawie years wartoś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 DECIMA L 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 path obiektu . |
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 VARIANT NULL w 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. |
|
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 variantExpr klasy , 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 xml z 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 , ROLLUP lub 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 NULL ma 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 expr2 się , 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 NULL ma 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. |