Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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, zobacz Precedencja operatorów.
Obsługujący | Składnia | opis |
---|---|---|
& | expr1 & expr2 |
Zwraca bitowe AND wartości expr1 i expr2 . |
i | expr1 and expr2 |
Zwraca wartość logiczną AND , oraz expr1 i expr2 . |
* | multiplier * multiplicand |
Zwraca multiplier pomnożone przez multiplicand . |
!= | expr1 != expr2 |
Zwraca wartość true, jeśli expr1 nie jest równa expr2 , lub false w przeciwnym razie. |
! | !expr |
Zwraca wartość logiczną NOT wyrażenia logicznego. |
między | expr1 [not] between expr2 and expr2 |
Sprawdza, czy expr1 jest większa lub równa expr2 oraz mniejsza lub równa expr3 . |
[] | arrayExpr [ indexExpr ] |
Zwraca indexExpr drugi element ARRAY arrayExpr . |
[] | mapExpr [ keyExpr ] |
Zwraca wartość w keyExpr z 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 danych type . |
?:: | expr ?:: type |
Rzutuje wartość expr na docelowy typ danych type , jeśli to możliwe, zwraca NULL w przeciwnym wypadku. |
Div | dividend div divisor |
Zwraca całkowitą część z dzielenia dividend przez divisor . |
. | mapExpr . keyIdentifier |
MAP Zwraca wartość według keyIdentifier . |
. | structExpr . fieldIdentifier |
STRUCT Zwraca pole według fieldIdentifier . |
== | expr1 == expr2 |
Zwraca true , jeśli expr1 równa się expr2 , lub false w przeciwnym razie. |
= | expr1 = expr2 |
Zwraca true , jeśli expr1 równa się expr2 , lub false w przeciwnym razie. |
>= | expr1 >= expr2 |
Zwraca true , jeśli expr1 jest większe lub równe expr2 , lub false w przeciwnym razie. |
> | expr1 > expr2 |
Zwraca wartość true , jeśli expr1 jest większa niż expr2 , lub false w przeciwnym razie. |
Istnieje | exists(query) |
Zwraca true, jeśli query zwraca co najmniej jeden wiersz, lub false w przeciwnym razie. |
ilike | str [not] ilike (pattern[ESCAPE escape]) |
Zwraca wartość true, jeśli str (nie) jest zgodna pattern z escape bez uwzględniania wielkości liter. |
ilike | str [not] ilike {ANY\|SOME\|ALL}([pattern[, ...]]) |
Zwraca wartość true, jeśli str (nie) pasuje do żadnego/wszystkich wzorców bez uwzględniania wielkości liter. |
w | elem [not] in (expr1[, ...]) |
Zwraca wartość true , jeśli elem wartość nie jest równa dowolnej exprN wartości . |
w | elem [not] in (query) |
Zwraca true , jeśli elem jest (nie) równe z żadnym wierszem w query . |
jest odrębna | expr1 is [not] distinct from expr2 |
Sprawdza, czy argumenty mają różne wartości, gdzie NULL są uznawane za porównywalne wartości. |
jest fałszywy | expr is [not] false |
Sprawdza, czy expr jest (nie) false . |
ma wartość null | expr is [not] null |
Zwraca true , jeśli expr (nie) jest NULL . |
jest prawda | expr is [not] true |
Sprawdza, czy expr jest (nie) true . |
lubić | str [not] like (pattern[ESCAPE escape]) |
Zwraca true, jeśli str (nie) jest zgodny z pattern przy użyciu escape . |
lubić | str [not] like {ANY\|SOME\|ALL}([pattern[, ...]]) |
Zwraca wartość true, jeśli str nie jest zgodna z żadnym/wszystkimi wzorcami. |
<=> | expr1 <=> expr2 |
Zwraca ten sam wynik co EQUAL(=) dla wartości innych niż null, ale zwraca true jeśli oba są NULL wartościami, false jeśli jeden z nich to NULL . |
<= | expr1 <= expr2 |
Zwraca true , jeśli expr1 jest mniejsze lub równe expr2 , lub false w przeciwnym razie. |
<> | expr1 <> expr2 |
Zwraca wartość true , jeśli expr1 nie jest równa expr2 , lub false w inny sposób. |
< | expr1 < expr2 |
Zwraca true , jeśli expr1 jest mniejsza niż expr2 , lub false w przeciwnym razie. |
- | expr1 - expr2 |
Zwraca różnicę wartości expr2 od expr1 . |
nie | not expr |
Zwraca wartość logiczną NOT wyrażenia logicznego. |
lub | expr1 or expr2 |
Zwraca wartość logiczną OR , oraz expr1 i expr2 . |
% | dividend % divisor |
Zwraca resztę po dividend / divisor . |
|| | expr1 \|\| expr2 |
Zwraca łączenie elementów expr1 i expr2 . |
| | expr1 \| expr2 |
Zwraca bitowe OR wartości expr1 i expr2 . |
+ | expr1 + expr2 |
Zwraca sumę wartości expr1 i expr2 . |
regexp | str [not] regexp regex |
Zwraca wartość true, jeśli str (nie) jest zgodny z regex . |
regexp_like | str [not] regexp_like regex |
Zwraca wartość true, jeśli str (nie) jest zgodny z regex . |
rlike | str [not] rlike regex |
Zwraca wartość true, jeśli str (nie) jest zgodny z regex . |
/ | dividend / divisor |
Zwraca wartość dividend podzieloną przez divisor . |
~ | ~ expr |
Zwraca wynik bitowy NOT z expr . |
Kolejność wykonywania działań
Pierwszeństwo | Obsługujący |
---|---|
1 |
: , , :: , , ?:: [ ] |
2 |
- (jednoargumentowy), + (jednoargumentowy), ~ |
3 |
* , , / , , % div |
4 |
+ , , - \|\| |
5 | & |
6 | ^ |
7 | \| |
8 |
= , == , , <=> , <> != , < , , <= > >= |
9 |
not , exists |
10 |
between , in , , rlike , regexp ilike , , like , , is [not] [NULL, true, false] is [not] distinct from |
11 | and |
12 | or |
Funkcje ciągowe i binarne
Funkcja | opis |
---|---|
wyrażenie1 || wyrażenie2 | Zwraca łączenie elementów expr1 i expr2 . |
aes_decrypt(wyrazenie, klucz[, tryb[, wypełnienie[, aad]]]) | Odszyfrowuje dane binarne expr przy użyciu szyfrowania AES. |
aes_encrypt(wyrażenie, klucz[, tryb[, wypełnienie[, iv[, aad]]]) | Szyfruje dane binarne expr przy użyciu szyfrowania AES. |
ascii(str) | Zwraca punkt kodu ASCII pierwszego znaku str . |
base64(wyrażenie) | Konwertuje expr na podstawowy ciąg 64. |
bin(wyrażenie) | Zwraca binarną reprezentację elementu expr . |
binary(expr) | Rzutuje wartość expr na BINARY . |
bit_length (wyrażenie) | Zwraca bitową długość danych ciągu lub liczbę bitów danych binarnych. |
bitmap_count (wyrażenie) | Zwraca liczbę bitów ustawionych w ciągu BINARY reprezentującym mapę bitową. |
btrim(str [, trimStr]) | Zwraca str z usuniętymi znakami wiodącymi i końcowymi. |
char(wyrażenie) | Zwraca znak odpowiadający podanemu punktowi kodu UTF-16. |
char_length(wyrażenie) | Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych. |
character_length(wyrażenie) | Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych. |
charindex(substr, str[, pos]) | Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos . |
chr(wyrażenie) | Zwraca znak odpowiadający podanemu punktowi kodu UTF-16. |
strExpr collationName | Dołącza jawne sortowanie collationName do strExpr . |
kojarzenie [dla] (strExpr) | Zwraca ustawienia porządkowania przypisane do strExpr . |
concat(expr1, expr2[, ...]) | Zwraca konkatenację argumentów. |
concat_ws(sep[, expr1[, ...]]) | Zwraca ciągi łączenia oddzielone ciągami sep . |
contains(expr, subExpr) | Zwraca true , jeśli expr STRING lub BINARY zawiera subExpr . |
crc32(wyrażenie) | Zwraca cykliczną wartość sprawdzania nadmiarowości .expr |
decode(expr, charSet) | Tłumaczy binarny expr na łańcuch znaków przy użyciu kodowania zbioru znaków charSet . |
encode(expr, charSet) | Zwraca binarną reprezentację ciągu przy użyciu charSet kodowania znaków. |
endswith(wyrażenie, endExpr) | Zwraca true jeśli expr STRING lub BINARY kończy się ciągiem endExpr . |
znajdź_w_zestawie(searchExpr, sourceExpr) | Zwraca położenie ciągu w rozdzielanej przecinkami liście ciągów. |
format_number (wyrażenie, skala) | Formaty takie jak expr , podobne do #,###,###.## , zaokrąglone do scale miejsc dziesiętnych. |
format_number(wyraż., fmt) | Formaty expr takie jak fmt . |
format_string(strfmt[, obj1 [, ...]]) | Zwraca sformatowany ciąg znaków według wzorca formatowania printf. |
hex(wyrażenie) | Konwertuje expr na szesnastkowy. |
str ilike (wzorzec[ESCAPE escape]) | Zwraca wartość true, jeśli str odpowiada pattern przy escape ignorowaniu wielkości liter. |
initcap(wyrażenie) | Zwraca expr z pierwszą literą każdego wyrazu zapisaną wielką literą. |
instr(str, substr) | Zwraca indeks (zaczynający się od 1) pierwszego wystąpienia substr w str . |
lcase(wyrażenie) | Zwraca expr z wszystkimi znakami zmienionymi na małe litery. |
left(str, len) | Zwraca najbardziej lewe znaki len z str . |
len(wyrażenie) | Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych. |
długość(expr) | Zwraca długość znaków danych ciągu lub liczbę bajtów danych binarnych. |
levenshtein(str1, str2) | Zwraca odległość Levenshtein między ciągami str1 i str2 . |
str like (wzorzec[ESCAPE escape]) | Zwraca wartość true, jeśli str jest zgodny z pattern z escape . |
locate(substr, str[, pos]) | Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos . |
lower(expr) | Zwraca expr z wszystkimi znakami zmienionymi na małe litery. |
lpad(wyrażenie, len[, pad]) | Zwraca expr , uzupełnione z lewej strony pad do długości len . |
ltrim([trimstr,] str) | Zwraca str z usuniętymi wiodącymi znakami w obrębie trimStr . |
mask(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]]) | Zwraca maskowaną wersję danych wejściowych str . |
md5(wyrażenie) | Zwraca sumę kontrolną MD5 o długości 128 bitów dla expr jako ciąg szesnastkowy. |
octet_length(wyrażenie) | Zwraca długość bajtów danych ciągu lub liczbę bajtów danych binarnych. |
nakładka(input PLACING replace FROM pos [FOR len]) | Zastępuje input na replace , który zaczyna się na pos i ma długość len . |
nakładka(input PLACING replace FROM pos [FOR len]) | Zastępuje input na replace , który zaczyna się na pos i ma długość len . |
parse_url(url, partToExtract[, key]) | Wyodrębnia fragment z elementu url . |
position(subtekst, str[, pos]) | Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos . |
position(podtr IN str) | Zwraca pozycję pierwszego wystąpienia substr w str po pozycji pos . |
printf(strfmt[, obj1 [, ...]]) | Zwraca sformatowany ciąg znaków według wzorca formatowania printf. |
randstr(długość) | Zwraca losowy ciąg znaków alfanumerycznych length . |
regexp regex | Zwraca wartość true, jeśli str pasuje do regex . |
str regexp_like regex | Zwraca wartość true, jeśli str pasuje do regex . |
regexp_count(str, regexp) | Zwraca liczbę razy str zgodną ze wzorcem regexp . |
regexp_extract(str, regexp[, idx]) | Wyodrębnia pierwszy ciąg w str , który pasuje do wyrażenia regexp i odpowiada indeksowi grupy regex . |
regexp_extract_all(str, regexp[, idx]) | Wyodrębnia wszystkie ciągi w str , które pasują do wyrażenia regexp i odpowiadają indeksowi grupy regex . |
regexp_instr(str, regexp) | Zwraca pozycję pierwszego podciągu w str , który pasuje do regexp . |
regexp_replace(str, regexp, rep[, position]) | Zamienia wszystkie podciągi str dopasowujące się do regexp na rep . |
regexp_substr(str, regexp) | Zwraca pierwszy podciąg w str , który pasuje do regexp . |
repeat(wyrażenie, n) | Zwraca ciąg, który powtarza się razy expr n . |
replace(str, search [, replace]) | Zamienia wszystkie wystąpienia elementu search na replace . |
odwróć(wyrażenie) | Zwraca odwrócony ciąg lub tablicę z odwrotną kolejnością elementów. |
right(str, len) | Zwraca najbardziej prawe len znaki z ciągu str . |
str rlike regex | Zwraca wartość true, jeśli str pasuje do regex . |
rpad(wyrażenie, długość[, wypełnienie]) | Zwraca expr , dopełniony z prawej strony elementem pad do długości len . |
rtrim([trimStr,] str) | Zwraca str ze usuniętymi znakami końcowymi. |
zdania(str[, lang, country]) |
str Dzieli się na tablicę wyrazów. |
sha(wyrażenie) | Zwraca wartość skrótu sha1 jako szesnastkowy ciąg expr . |
sha1(wyrażenie) | Zwraca wartość skrótu sha1 jako szesnastkowy ciąg expr . |
sha2(wyrażenie, bitLength) | Zwraca sumę kontrolną rodziny SHA-2 jako ciąg szesnastkowy expr . |
soundex(wyrażenie) | Zwraca kod soundex ciągu tekstowego. |
przestrzeń(n) | Zwraca ciąg składający się ze spacji n . |
split(str, regex[, limit]) |
str Dzieli wokół wystąpień zgodnych z regex i zwraca tablicę o maksymalnej długości limit . |
split_part(str, delim, partNum) | Dzieli str wokół wystąpień delim i zwraca część partNum . |
startswith(wyrażenie, startExpr) | Zwraca true jeśli 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(expr, ogranicznik, liczba) | Zwraca podciąg expr przed count wystąpieniem ogranicznika delim . |
to_binary(wyrażenie[, fmt]) | Zwraca expr , rzutowany do postaci binarnej na podstawie fmt . |
to_char(numExpr, fmt) | Zwraca numExpr skonwertowane na STRING z użyciem formatowania fmt . |
to_varchar(numExpr, fmt) | Zwraca numExpr skonwertowane na STRING z użyciem formatowania fmt . |
translate(wyrażenie, od, do) | Zwraca expr , w którym wszystkie znaki from zostały zamienione na znaki w to . |
trim([[OBYDWA | POCZĄTKOWY | KOŃCOWY] [trimStr] FROM] str) | Przycinanie znaków z ciągu. |
try_aes_decrypt(expr, klucz[, tryb[, dopełnienie[, aad]]]) | Odszyfrowuje dane binarne expr przy użyciu szyfrowania AES i zwraca NULL wartość w przypadku błędu. |
try_to_binary(wyrażenie [, fmt]) | Zwraca expr , rzutując na BINARY na podstawie fmt , lub NULL , jeśli dane wejściowe są nieprawidłowe. |
try_url_decode(str) | Tłumaczy ciąg z powrotem z formatu application/x-www-form-urlencoded i w przypadku błędu zwraca NULL . |
try_zstd_decompress(wartość) | Zwraca wartość dekompresowaną przy użyciu kompresji Zstandard lub NULL jeśli dane wejściowe są nieprawidłowe. |
ucase(wyrażenie) | Zwraca expr ze wszystkimi znakami zamienionymi na wielkie litery. |
unbase64(wyrażenie) | Zwraca zdekodowany ciąg base64 jako binarny. |
unhex(wyrażenie) | Konwertuje szesnastkowe expr na BINARY . |
upper(expr) | Zwraca expr ze wszystkimi znakami zamienionymi na wielkie litery. |
url_decode(str) | Tłumaczy z powrotem ciąg z formatu application/x-www-form-urlencoded. |
url_encode(str) | Tłumaczy ciąg do formatu application/x-www-form-urlencoded. |
zstd_compress (wartość[,poziom[,streaming_mode]]) | Zwraca wartość skompresowaną za pomocą Zstandard. |
zstd_decompress(wartość) | Zwraca wartość dekompresowaną przy użyciu kompresji Zstandard. |
Funkcje skalarne liczbowe
Funkcja | opis |
---|---|
~ wyrażenie | Zwraca wynik bitowy NOT z expr . |
dywidenda / dzielnik | Zwraca wartość dividend podzieloną przez divisor . |
wyrażenie1 | wyrażenie2 | Zwraca bitowe OR wartości expr1 i expr2 . |
— wyrażenie | Zwraca przeciwną wartość expr . |
expr1 — expr2 | Zwraca różnicę wartości expr2 od expr1 . |
+ wyrażenie | Zwraca wartość expr . |
expr1 + expr2 | Zwraca sumę wartości expr1 i expr2 . |
dywidenda % dzielnik | Zwraca resztę po dividend / divisor . |
expr1 ^ expr2 | Zwraca bitowe wartości wykluczające OR (XOR) wartości expr1 i expr2 . |
expr1 i expr2 | Zwraca bitowe AND wartości expr1 i expr2 . |
mnożnik * mnożna | Zwraca multiplier pomnożone przez multiplicand . |
abs(wyrażenie) | Zwraca wartość bezwzględną wartości liczbowej w pliku expr . |
acos(wyrażenie) | Zwraca odwrotny cosinus (arcus cosinus) wartości expr . |
acosh(wyrażenie) | Zwraca odwrotny cosinus hiperboliczny expr . |
asin(wyrażenie) | Zwraca odwrotny sinus (arcsinus) wartości expr . |
asinh(argument) | Zwraca odwrotny sinus hiperboliczny expr . |
atan(wyrażenie) | Zwraca odwrotny tangens (arctangent) wartości expr . |
atan2(exprY, exprX) | Zwraca kąt w radianach między dodatnią osią x płaszczyzny a punktem określonym przez współrzędne (exprX , exprY ). |
atanh(wyrażenie) | Zwraca odwrotny tangens hiperboliczny liczby expr . |
bigint(wyrażenie) | Rzutuje wartość expr na BIGINT . |
bit_count(wyrażenie) | Zwraca liczbę bitów ustawionych w argumencie. |
bit_get(wyrażenie, pos) | Zwraca wartość bitu w binarnej reprezentacji całkowitej liczbowej. |
bit_reverse(wyrażenie) | Zwraca wartość uzyskaną przez odwrócenie kolejności bitów w argumencie. |
bitmap_bit_position(wyrażenie) | Zwraca pozycję bitową rozpoczynającą się od zera danej BIGINT liczby w segmencie. |
bitmap_bucket_number(wyrażenie) | Zwraca numer zasobnika mapy bitowej dla danej BIGINT liczby. |
bround(expr[,targetScale]) | Zwraca zaokrąglony expr przy użyciu trybu zaokrąglania HALF_EVEN . |
cbrt(argument) | Zwraca pierwiastek modułu .expr |
ceil(expr[,targetScale]) | Zwraca najmniejszą liczbę nie mniejszą niż expr , zaokrągloną w górę do targetScale miejsc po przecinku. |
ceiling(expr[,docelowaSkala]) | Zwraca najmniejszą liczbę nie mniejszą niż expr , zaokrągloną w górę do targetScale miejsc po przecinku. |
conv(num, fromBase, toBase) | Konwertuje num z fromBase na toBase . |
convert_timezone([sourceTz, ]targetTz, sourceTs) | Konwertuje element TIMESTAMP_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 kosekans wartości expr . |
dziesiętne (wyrażenie) | Rzutuje wartość expr na DECIMAL . |
stopnie(wyrażenie) | Przekształca radiany na stopnie. |
dzielnik div dywidenda | Zwraca całkowitą część z dzielenia divisor przez dividend . |
double(wyrażenie) | Rzutuje wartość expr na DOUBLE . |
e() | Zwraca stałą e . |
exp(wyrażenie) | Podnosi e do potęgi expr . |
expm1(wyrażenie) | Zwraca wartość exp(expr) - 1 . |
factorial(wyrażenie) | Zwraca współczynnik .expr |
float(wyrażenie) | Rzutuje wartość expr na FLOAT . |
floor(expr[,targetScale]) | Zwraca największą liczbę nie mniejszą niż expr , zaokrąglaną w dół do targetScale cyfr względem przecinka dziesiętnego. |
getbit(expr, pos) | Zwraca wartość bitu w binarnej reprezentacji całkowitej liczbowej. |
hypot(expr1, expr2) | Zwraca wartość sqrt(expr1 * expr1 + expr2 * expr2) . |
int(wyrażenie) | Rzutuje wartość expr na INTEGER . |
isnan(wyrażenie) | Zwraca wartość true , jeśli expr ma wartość NaN . |
ln(wyrażenie) | Zwraca logarytm naturalny (podstawa e ) wartości expr . |
log([base,] expr) | Zwraca logarytm elementu expr z wartością base . |
log1p(wyrażenie) | Zwraca wartość log(1 + expr) . |
log2(wyrażenie) | Zwraca logarytm expr o podstawie 2 . |
log10(wyrażenie) | Zwraca logarytm expr o podstawie 10 . |
mod(dywidenda, dzielnik) | Zwraca resztę po dividend / divisor . |
nanvl(expr1, expr2) | Zwraca expr1 , jeśli nie jest NaN , lub expr2 w przeciwnym razie. |
negative(wyrażenie) | Zwraca przeciwną wartość expr . |
"nullifzero(expr)" | Zwraca wartość expr , jeśli nie jest równa zero lub NULL w przeciwnym razie. |
pi() | Zwraca wartość pi. |
pmod(dywidenda, dzielnik) | Zwraca dodatnią resztę po dividend / divisor . |
positive(wyrażenie) | Zwraca wartość expr . |
pow(wyrażenie1, wyrażenie2) | Podnosi expr1 do potęgi expr2 . |
power(expr1, expr2) | Podnosi expr1 do potęgi expr2 . |
radiany (wyrażenie) | Konwertuje expr w stopniach na radiany. |
rand([seed]) | Zwraca losową wartość z zakresu od 0 do 1. |
randn([seed]) | Zwraca wartość losową ze standardowego rozkładu normalnego. |
random([seed]) | Zwraca losową wartość z zakresu od 0 do 1. |
rint(wyrażenie) | Zwraca zaokrąglone expr do liczby całkowitej jako DOUBLE . |
round(expr[,skalaDocelowa]) | Zwraca zaokrąglony expr przy użyciu trybu zaokrąglania HALF_UP . |
sek(wyrażenie) | Zwraca sekans wartości expr . |
shiftleft(wyrażenie, n) | Zwraca wartość bitową przesuniętą w lewo o n bitów. |
shiftright(wyrażenie, n) | Zwraca bitową liczbę całkowitą ze znakiem przesuniętą w prawo o n bitów. |
shiftrightunsigned(wyrażenie, n) | Zwraca bitową niepodpisaną liczbę całkowitą w prawo przesuniętą według n bitów. |
znak(wyrażenie) | Zwraca wartość -1.0, 0.0 lub 1.0, jak expr ma wartość ujemną, 0 lub dodatnią. |
signum(wyrażenie) | Zwraca wartość -1.0, 0.0 lub 1.0, jak expr ma wartość ujemną, 0 lub dodatnią. |
sin(wyrażenie) | Zwraca sinus expr . |
sinh(wyrażenie) | Zwraca sinus hiperboliczny wartości expr . |
smallint(wyrażenie) | Rzutuje wartość expr na SMALLINT . |
sqrt(wyrażenie) | Zwraca pierwiastek kwadratowy elementu expr . |
tan(arg) | Zwraca tangens liczby expr . |
tanh(wyrażenie) | Zwraca wartość tangensa hiperbolicznego dla expr . |
tinyint(wyrażenie) | Rzutuje expr na TINYINT . |
to_number(expr, fmt) | Zwraca expr przekonwertowane do DECIMAL z formatowaniem fmt . |
try_add(wyrażenie1, wyrażenie2) | Zwraca sumę expr1 i expr2 lub NULL w przypadku błędu. |
try_divide(dzielna, dzielnik) | Zwraca dividend podzielone przez divisor , lub NULL , jeśli divisor wynosi 0. |
try_mod(dzielna, dzielnik) | Zwraca resztę po dividend / divisor , lub NULL , jeśli divisor ma wartość 0.. |
try_multiply(mnożnik, mnożenie) | Zwraca multiplier pomnożony przez multiplicand , albo NULL przy przepełnieniu. |
try_subtract(wyrażenie1, wyrażenie2) | Zwraca różnicę wartości expr2 od expr1 , albo NULL w przypadku przepełnienia. |
try_to_number(wyrażenie, fmt ) | Zwraca expr przekształcenie na DECIMAL przy użyciu formatu fmt , lub NULL jeśli expr nie jest zgodne z formatem. |
uniform(expr1, expr2 [,seed]) | Zwraca wartość losową z niezależnymi i identycznymi wartościami rozproszonymi w określonym zakresie liczb. |
width_bucket(wyrażenie, minExpr, maxExpr, numBuckets) | Zwraca liczbę zasobnika dla wartości w histogramie o szerokości równej. |
"zeroifnull(expr)" | Zwraca expr , jeśli nie NULL , lub 0 w przeciwnym razie. |
Funkcje agregujące
Funkcja | opis |
---|---|
any(wyrażenie) | Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie ma wartość true. |
any_value(wyrażenie[,ignorujNull]) | Zwraca pewną wartość expr dla grupy wierszy. |
approx_count_distinct(wyrażenie[,względneSD]) | Zwraca szacowaną liczbę unikatowych wartości w expr grupie. |
approx_percentile(wyrażenie,procent[,dokładność]) | Zwraca przybliżony percentyl expr w grupie. |
przybliżony_top_k(wyrażenie[,k[,maksLiczbaŚledzonychElementów]]) | Zwraca k najczęściej występujące wartości elementów w expr oraz ich przybliżone liczby wystąpień. |
array_agg(wyrażenie) | Zwraca tablicę składającą się ze wszystkich wartości w expr grupie. |
avg(expr) | Zwraca średnią obliczoną na podstawie wartości grupy. |
bit_and (wyrażenie) | Zwraca bitowo AND wszystkich wartości wejściowych w grupie. |
bit_or(wyrażenie) | Zwraca bitowo OR wszystkich wartości wejściowych w grupie. |
bit_xor(wyrażenie) | Zwraca bitowo XOR wszystkich wartości wejściowych w grupie. |
bitmap_construct_agg(wyrażenie) | Zwraca bitowe OR wartości pozycji wszystkich bitów w grupie. od 0 do 32767 w grupie jako BINARY . |
bitmap_or_agg(wyrażenie) | Zwraca wynik operacji bitowej OR dla wszystkich wartości wejściowych typu BINARY w grupie. |
bool_and(wyrażenie) | Zwraca wartość true, jeśli wszystkie wartości w expr grupie mają wartość true. |
bool_or(wyrażenie) | Zwraca wartość true, jeśli co najmniej jedna wartość w elemencie expr jest prawdziwa w grupie. |
collect_list(wyrażenie) | Zwraca tablicę składającą się ze wszystkich wartości w expr grupie. |
collect_set(wyrażenie) | Zwraca tablicę składającą się ze wszystkich unikatowych wartości w expr w grupie. |
corr(expr1,expr2) | Zwraca współczynnik Pearson korelacji między grupą par liczbowych. |
count(*) | Zwraca łączną liczbę pobranych wierszy w grupie, w tym wierszy zawierających wartość null. |
licz(wyrażenie[, ...]) | Zwraca liczbę wierszy w grupie, dla której wszystkie podane wyrażenia nie mają wartości null. |
count_if (wyrażenie) | Zwraca liczbę wartości True dla grupy w expr . |
count_min_sketch(kolumna,epsilon,ufność,nasion) | Zwraca szkic Count-Min wszystkich wartości w grupie w column z epsilon , confidence i seed . |
covar_pop(wyrażenie1,wyrażenie2) | Zwraca kowariancję populacji par liczbowych w grupie. |
covar_samp(wyrażenie1,wyrażenie2) | Zwraca współczynnik kowariancji dla próbki par liczb w grupie. |
każde(wyrażenie) | Zwraca wartość true, jeśli wszystkie wartości expr w grupie mają wartość true. |
first(expr[,ignoreNull]) | Zwraca pierwszą wartość expr dla grupy wierszy. |
first_value(wyrażenie[,ignorujNul]) | Zwraca pierwszą wartość expr dla grupy wierszy. |
histogram_numeric(wyrażenie,numBins) | Oblicza histogram z expr numBins pojemnikami, zwracając tablicę par reprezentujących centra bin. |
hll_sketch_agg(wyrażenie[,lgConfigK]) | Zwraca szkic HyperLogLog używany do oszacowania liczby unikatowych wartości. |
hll_union_agg(wyrażenie[,allowDifferentLgConfigK]) | Agreguje szkice funkcji HyperLogLog dla grupy wierszy. |
kurtosis(wyrażenie) | Zwraca wartość kurtozy obliczoną na podstawie wartości z danej grupy. |
last(expr[,ignoreNull]) | Zwraca ostatnią wartość expr dla grupy wierszy. |
last_value(wyrażenie[,ignoreNull]) | Zwraca ostatnią wartość expr dla grupy wierszy. |
listagg(expr[,delim]) [W GRUPIE (ORDER BY klucz [,...])] | Zwraca wartość połączoną STRING lub BINARY wszystkich wartości w expr grupie rozdzielonych wartościami delim . |
max(wyrażenie) | Zwraca maksymalną wartość expr w grupie. |
max_by(wyrażenie1,wyrażenie2) | Zwraca wartość elementu skojarzonego z maksymalną wartością expr1 w grupie. |
mean(expr) | Zwraca średnią obliczoną na podstawie wartości grupy. |
miara(kolumna_miara) | Zwraca miarę widoku metryki obliczonego na podstawie wartości grupy. |
median(wyrażenie) | Zwraca medianę obliczaną na podstawie wartości grupy. |
min(expr) | Zwraca minimalną wartość expr w grupie. |
min_by(wyrażenie1, wyrażenie2) | Zwraca wartość expr1 skojarzona z minimalną wartością expr2 w grupie. |
tryb(wyrażenie [,deterministyczny]) | Zwraca najczęstszą wartość NULL , a nie expr , w grupie. |
percentyl(wyrażenie, procent [,częstotliwość]) | Zwraca dokładną wartość percentyla expr przy określonym percentage . |
percentile_approx(wyrażenie,procent[,dokładność]) | Zwraca przybliżony percentyl expr w grupie. |
percentile_cont(pct) WITHIN GROUP (kluczORDER BY) | Zwraca interpolowany percentyl wartości key w grupie. |
percentile_disc(pct) W GRUPIE (kluczORDER BY) | Zwraca percentyl dyskretny dla key wewnątrz grupy. |
regr_avgx(yExpr, xExpr) | Zwraca średnią z xExpr , obliczoną z wartości grupy, gdzie xExpr i yExpr są równe NOT NULL . |
regr_avgy(yExpr, xExpr) | Zwraca średnią z yExpr , obliczoną z wartości grupy, gdzie xExpr i yExpr są równe NOT NULL . |
regr_count(yExpr, xExpr) | Zwraca liczbę par 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 wartości niebędących nullem yExpr , xExpr w grupie. |
regr_sxx(yExpr, xExpr) | Zwraca sumę kwadratów wartości z grupy, w której xExpr i xExpr nie są NULL. |
regr_sxy(yExpr, xExpr) | Zwraca sumę produktów yExpr i xExpr obliczonych na podstawie wartości grupy, w której xExpr i yExpr są NOT NULL . |
regr_syy(yExpr, xExpr) | Zwraca sumę kwadratów wartości z grupy, w której yExpr i xExpr nie są NULL. |
schema_of_json_agg(json[, opcje]) | Zwraca połączony schemat ciągów JSON w grupie w formacie DDL. |
schema_of_variant_agg(variantExpr) | Zwraca połączony schemat wszystkich VARIANT wartości w grupie w formacie DDL. |
skośność(expr) | Zwraca wartość niesymetryczności obliczoną na podstawie wartości grupy. |
some(wyrażenie) | Zwraca wartość true, jeśli co najmniej jedna wartość expr w grupie to true . |
std(wyrażenie) | Zwraca odchylenie standardowe próbki obliczone z wartości w grupie. |
stddev(wyrażenie) | Zwraca odchylenie standardowe próbki obliczone z wartości w grupie. |
stddev_pop (wyrażenie) | Zwraca odchylenie standardowe populacji obliczone z wartości grupy. |
stddev_samp(wyrażenie) | Zwraca odchylenie standardowe próbki obliczone z wartości grupy. |
string_agg(wyrażenie[,delim]) [WITHIN GROUP (ORDER BY klucz [,...])] | Zwraca wartość połączoną STRING lub BINARY wszystkich wartości w expr grupie rozdzielonych wartościami delim . |
sum(wyrażenie) | Zwraca sumę obliczaną na podstawie wartości grupy. |
try_avg(wyrażenie) | Zwraca średnią obliczoną na podstawie wartości grupy, NULL jeśli występuje przepełnienie. |
try_sum(wyrażenie) | Zwraca sumę obliczoną na podstawie wartości grupy, NULL jeśli istnieje przepełnienie. |
var_pop(wyrażenie) | Zwraca wariancję populacji obliczoną na podstawie wartości grupy. |
var_samp(wyrażenie) | Zwraca wariancję próbki obliczoną na podstawie wartości grupy. |
wariancja(expr) | Zwraca wariancję próbki obliczoną na podstawie wartości grupy. |
Funkcje okna klasyfikacji
Funkcja | opis |
---|---|
dense_rank() | Zwraca rangę wartości w porównaniu ze wszystkimi wartościami w partycji. |
ntile(n) | Dzieli wiersze dla każdej partycji okna na n przedziałów w zakresie od 1 do maksymalnie n . |
stopień_procentowy() | Oblicza procentową klasyfikację wartości w partycji. |
rank() | Zwraca rangę wartości w porównaniu ze wszystkimi wartościami w partycji. |
row_number() | Przypisuje unikatową, sekwencyjną liczbę do każdego wiersza, zaczynając od jednego, zgodnie z kolejnością wierszy w partycji okna. |
Funkcje okna analitycznego
Funkcja | opis |
---|---|
cume_dist() | Zwraca położenie wartości względem wszystkich wartości w partycji. |
lag(expr[,offset[,default]]) | Zwraca wartość expr z poprzedniego wiersza wewnątrz partycji. |
lead(expr[,offset[,default]]) | Zwraca wartość expr z kolejnego wiersza w partycji. |
nth_value(wyrażenie, przesunięcie[, ignoruj_zerowe_wartości]) | Zwraca wartość expr w określonym offset w oknie. |
Funkcje tablicy
Funkcja | opis |
---|---|
arrayExpr[indexExpr] | Zwraca element na pozycji indexExpr w TABLICY arrayExpr . |
agregat(expr,start,merge[,finish]) | Agreguje elementy w tablicy przy użyciu niestandardowego agregatora. |
array([wyrażenie [, ...]]) | Zwraca tablicę z elementami w expr . |
array_append(tablica, elem) | Zwraca array z dodatkiem elem . |
array_compact(tablica) | Usuwa wartości NULL z array elementu . |
array_contains(tablica,wartość) | Zwraca true, jeśli array zawiera value . |
array_distinct(tablica) | Usuwa zduplikowane wartości z array . |
array_except(tablica1, tablica2) | Zwraca tablicę elementów, które znajdują się w array1 , ale nie w array2 . |
array_insert(tablica, indeks, elem) | Zwraca rozszerzony array , w którym elem jest wstawiany na pozycji index . |
array_intersect(tablica1,tablica2) | Zwraca tablicę elementów znajdujących się w przecięciu array1 i array2 . |
array_join(tablica,ogranicznik[,nullReplacement]) | Łączy elementy array . |
array_max(tablica) | Zwraca wartość maksymalną w array . |
array_min(tablica) | Zwraca wartość minimalną w pliku array . |
array_position(tablica,element) | Zwraca pozycję pierwszego wystąpienia element elementu w pliku array . |
array_prepend(tablica, element) | Zwraca array poprzedzony przez elem . |
array_remove(tablica,element) | Usuwa wszystkie wystąpienia elementu element z .array |
array_repeat(element,count) - funkcja powtarzająca element określoną liczbę razy. | Zwraca tablicę, która zawiera element count razy. |
array_size(tablica) | Zwraca liczbę elementów w array . |
array_sort(array, func) | Zwraca array posortowane według func . |
array_union(tablica1, tablica2) | Zwraca tablicę elementów w zbiorze array1 oraz array2 bez duplikatów. |
arrays_overlap(tablica1, tablica2) | Zwraca wartość true, jeśli przecięcie array1 i array2 nie jest puste. |
arrays_zip(array1 [, ...]) | Zwraca scaloną tablicę struktur, gdzie n-ta struktura zawiera wszystkie n-te wartości z tablic wejściowych. |
kardynalność(expr) | Zwraca rozmiar expr . |
concat(expr1, expr2 [, ...]) | Zwraca konkatenację argumentów. |
element_at(arrayExpr, index) | Zwraca element arrayExpr pod index . |
exists(expr, pred) | Zwraca wartość true, jeśli pred ma wartość true dla dowolnego elementu w pliku expr . |
eksploduj(kolekcja) | Zwraca wiersze przez anulowanie zagnieżdżania collection . |
explode_outer(kolekcja) | Zwraca wiersze przez anulowanie zagnieżdżania collection przy użyciu semantyki zewnętrznej. |
filter(expr,func) | Filtruje tablicę w expr używając funkcji func . |
flatten(arrayOfArrays) | Przekształca tablice tablic w pojedynczą tablicę. |
forall(expr, predFunc) | Sprawdza, czy predFunc spełnia warunki dla wszystkich elementów w tablicy. |
get(arrayExpr, index) | Zwraca element arrayExpr znajdujący się na index , zaczynający się od 0 . |
inline(input) | Eksploduje tablicę struktur w tabeli. |
inline_outer(dane wejściowe) | Rozwija tablicę struktur do tabeli z zewnętrznymi semantykami. |
posexplode(kolekcja) | Zwraca wiersze poprzez od-zagnieżdżanie tablicy wraz z numerowaniem pozycji. |
posexplode_outer(kolekcja) | Zwraca wiersze przez usunięcie zagnieżdżenia tablicy i numerowanie pozycji zgodnie z semantyką OUTER . |
reduce(expr,start,merge[,finish]) | Agreguje elementy w tablicy przy użyciu niestandardowego agregatora. |
odwróć(tablica) | Zwraca odwrócony ciąg lub tablicę z odwrotną kolejnością elementów. |
sekwencja(start,stop,krok) | Generuje tablicę elementów od start do stop (włącznie), z przyrostem o step . |
shuffle(array) | Zwraca losową permutację tablicy w expr . |
size(expr) | Zwraca kardynalność wartości expr . |
slice(expr,start,length) | Zwraca podzbiór tablicy. |
sort_array(wyrażenie[,rosnąco]) | Zwraca tablicę w expr kolejności posortowanej. |
transform(expr, func) | Przekształca elementy w tablicy expr przy użyciu funkcji func . |
try_element_at(arrayExpr, index) | Zwraca element arrayExpr w index , lub NULL , jeśli index jest poza granicą. |
zip_with(wyrażenie1, wyrażenie2, funkcja) | Łączy tablice w expr1 i expr2 element po elemencie w jedną tablicę za pomocą func . |
Funkcje mapy
Funkcja | opis |
---|---|
mapExpr[keyExpr] | Zwraca wartość z pozycji keyExpr w mapie mapExpr . |
kardynalność(expr) | Zwraca rozmiar expr . |
element_at(mapExpr, klucz) | Zwraca wartość mapExpr dla key . |
eksploduj(kolekcja) | Zwraca wiersze przez anulowanie zagnieżdżania expr . |
explode_outer(kolekcja) | Zwraca wiersze przez anulowanie zagnieżdżania expr przy użyciu semantyki zewnętrznej. |
map([{key1, wartość1}[, ...]]) | Tworzy mapę z określonymi parami klucz-wartość. |
map_concat([expr1 [, ...]]) | Zwraca połączenie wszystkich expr wyrażeń mapy. |
map_contains_key (mapa, klucz) | Zwraca true , jeśli map zawiera key , w przeciwnym razie false . |
map_entries(mapa) | Zwraca nieuporządkowaną tablicę wszystkich wpisów w map . |
map_filter(wyrażenie, funkcja) | Filtruje wpisy na mapie w expr przy użyciu funkcji func . |
map_from_arrays(klucze, wartości) | Tworzy mapę z pary tablic keys i values . |
map_from_entries(wyrażenie) | Tworzy mapę utworzoną na podstawie określonej tablicy wpisów. |
map_keys(mapa) | Zwraca nieurządkowaną tablicę zawierającą klucze map . |
map_values(mapa) | Zwraca nieurządkowaną tablicę zawierającą wartości map . |
map_zip_with(map1, map2, func) | Łączy map1 i map2 w jedną mapę. |
size(expr) | Zwraca kardynalność wartości expr . |
str_to_map(wyrażenie[,pairDelim[,keyValueDelim]]) | Zwraca mapę po podzieleniu expr na pary klucz-wartość przy użyciu ograniczników. |
transform_keys(wyrażenie, func) | Przekształca klucze na mapie expr przy użyciu funkcji func . |
transform_values(wyrażenie, funkcja) | Przekształca wartości na mapie expr przy użyciu funkcji func . |
try_element_at(mapExpr, klucz) | Zwraca wartość parametru mapExpr dla key , lub NULL jeśli key nie istnieje. |
Funkcje daty, znacznika czasu i interwału
Aby uzyskać informacje na temat formatów daty i znacznika czasu, zobacz Wzorce daty i godziny.
Funkcja | opis |
---|---|
intervalExpr/dzielnik | Zwraca interwał podzielony przez divisor . |
- intervalExpr | Zwraca przeciwną wartość intervalExpr . |
intervalExpr1 — intervalExpr2 | Zwraca różnicę wartości intervalExpr2 od intervalExpr1 . |
datetimeExpr1 — datetimeExpr2 | Zwraca różnicę wartości datetimeExpr2 od datetimeExpr1 . |
+ interwałExpr | Zwraca wartość intervalExpr . |
intervalExpr1 + intervalExpr2 | Zwraca sumę wartości intervalExpr1 i intervalExpr2 . |
intervalExpr * multiplicand | Zwraca intervalExpr pomnożone przez multiplicand . |
abs(wyrażenie) | Zwraca wartość bezwzględną wartości interwału w pliku expr . |
add_months(startDate,numMonths) | Zwraca datę, która jest późniejsza numMonths niż startDate . |
curdate() | Zwraca bieżącą datę na początku oceny zapytania. |
current_date() | Zwraca bieżącą datę na początku oceny zapytania. |
current_timestamp() | Zwraca bieżący znacznik czasu na początku oceny zapytania. |
current_timezone() | Zwraca lokalną strefę czasową bieżącej sesji. |
date(expr) | Rzutuje wartość expr na DATE. |
date_add(startDate,numDays) | Zwraca datę numDays po startDate . |
date_add(jednostka, wartość, wyrażenie) | Dodaje value unit elementy do znacznika czasu expr . |
date_diff(jednostka, początek, koniec) | Zwraca różnicę między dwoma znacznikami czasu mierzonymi w unit s. |
date_format(expr, fmt) | Konwertuje znacznik czasu na ciąg w formacie fmt . |
date_from_unix_date (dni) | Tworzy datę z liczby dni od .1970-01-01 |
date_part(pole, wyrażenie) | Ekstrahuje część daty, znacznika czasowego lub interwału. |
date_sub(startDate,numDays) | Zwraca datę numDays przed startDate . |
date_trunc(jednostka, wyrażenie) | Zwraca znacznik czasu skrócony do jednostki określonej w unit . |
dateadd(startDate,numDays) | Zwraca datę numDays po startDate . |
dateadd(jednostka, wartość, expr) | Dodaje value unit elementy do znacznika czasu expr . |
datediff(endDate,startDate) | Zwraca liczbę dni z startDate do endDate . |
datediff(jednostka, początek, zatrzymywanie) | Zwraca różnicę między dwoma znacznikami czasu mierzonymi w unit s. |
day(expr) | Zwraca dzień miesiąca daty lub znacznika czasu. |
dayname(wyrażenie) | Zwraca trzyliterowy akronim angielski dla dnia tygodnia dla danej daty. |
dayofmonth(wyrażenie) | Zwraca dzień miesiąca daty lub znacznika czasu. |
dayofweek(wyrażenie) | Zwraca dzień tygodnia dla podanej daty lub znacznika czasu. |
dayofyear(wyrażenie) | Zwraca dzień roku daty lub znacznika czasu. |
dzielnik div dywidenda | Zwraca część całkowitą wyniku dzielenia interwału divisor przez interwał dividend . |
extract(pole z źródła) | Zwraca field z source . |
from_unixtime(unixTime,fmt) | Zwraca wartość unixTime w pliku fmt . |
from_utc_timestamp(wyrażenie,strefa czasowa) | Zwraca znacznik czasu przy UTC dla znacznika czasu expr przy timeZone . |
getdate() | Zwraca bieżący znacznik czasu na początku oceny zapytania. |
hour(expr) | Zwraca część godzinową znacznika czasu. |
last_day(wyrażenie) | Zwraca ostatni dzień miesiąca, do którego należy data. |
make_date (rok, miesiąc,dzień) | Tworzy datę z pól year , month i day . |
make_dt_interval([dni[, godziny[, min[, s]]]]) | Tworzy przedział czasowy z days , hours , mins i secs . |
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) | Przestarzała funkcja: tworzy interwał z years , months , weeks , days , hours , mins i secs . |
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,strefa czasowa]) | Tworzy znacznik czasu na podstawie pól year , month , day , hour , min , sec i timezone . |
make_ym_interval([lata[, miesiące]]) | Tworzy interwał roku i miesiąca na podstawie years oraz months . |
minute(wyrażenie) | Zwraca składnik minuty znacznika czasu w elemencie expr . |
month(expr) | Zwraca element miesiąca z znacznika czasu w expr . |
months_between(wyrażenie1,wyrażenie2[,zaokrąglenie]) | Zwraca liczbę miesięcy, które upłynęły między datami lub znacznikami czasu w expr1 i expr2 . |
next_day(wyrażenie,dzieńTygodnia) | Zwraca pierwszą datę, która jest późniejsza niż expr i nazywa się jak dayOfWeek . |
now() | Zwraca bieżący znacznik czasu na początku oceny zapytania. |
quarter(wyrażenie) | Zwraca numer kwartału roku dla expr w zakresie od 1 do 4. |
drugi(wyrażenie) | Zwraca drugi składnik znacznika czasu z expr . |
session_window(wyrażenie, gpDuration) | Tworzy okno sesji na podstawie wyrażenia ze znacznikiem czasu. |
znak(wyrażenie) | Zwraca wartość -1.0, 0.0 lub 1.0, ponieważ interwał expr jest ujemny, 0 lub dodatni. |
signum(wyrażenie) | Zwraca wartość -1.0, 0.0 lub 1.0, ponieważ interwał expr jest ujemny, 0 lub dodatni. |
timediff(jednostka, uruchamianie, zatrzymywanie) | Zwraca różnicę między dwoma znacznikami czasu mierzonymi w unit s. |
znacznikCzasu(wyrażenie) | Rzutuje expr na TIMESTAMP . |
timestamp_micros(wyrażenie) | Tworzy znacznik czasu w mikrosekundach od epoki UTC. |
timestamp_millis (wyrażenie) | Tworzy znacznik czasu w milisekundach od epoki UTC. |
timestamp_seconds(wyrażenie) | Tworzy znacznik czasu od epoki UTC w sekundach. |
timestampadd(jednostka, wartość, wyrażenie) | Dodaje value unit elementy do znacznika czasu expr . |
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 konwersję na znacznik czasu przy użyciu opcjonalnego formatowania. |
to_unix_timestamp(wyrażenie[,fmt]) | Zwraca znacznik czasu w expr jako znacznik czasu UNIX. |
to_utc_timestamp(wyrażenie, strefa_czasowa) | Zwraca znacznik czasu przy UTC dla znacznika czasu expr przy timezone . |
trunc(wyrażenie, fmt) | Zwraca datę, której część została skrócona do jednostki określonej przez format modelu fmt . |
try_add(wyrażenie1, wyrażenie2) | Zwraca sumę expr1 i expr2 , lub NULL w przypadku błędu. |
try_divide(dzielna, dzielnik) | Zwraca wartość dividend podzieloną przez divisor wartość , lub NULL, jeśli divisor ma wartość 0. |
try_multiply(mnożnik, mnożenie) | Zwraca multiplier pomnożony przez multiplicand , albo NULL przy przepełnieniu. |
try_subtract(wyrażenie1, wyrażenie2) | Zwraca różnicę wartości expr2 od expr1 , albo NULL w przypadku przepełnienia. |
spróbuj_przekonwertować_na_znacznik_czasu(wyrażenie[,fmt]) | Zwraca expr przekonwertowane na znacznik czasu z opcjonalnym formatowaniem lub NULL , jeśli konwersja zakończyła się niepowodzeniem. |
unix_date (wyrażenie) | Zwraca liczbę dni od 1970-01-01 . |
unix_micros(wyrażenie) | Zwraca liczbę mikrosekund od .1970-01-01 00:00:00 UTC |
unix_millis(wyrażenie) | Zwraca liczbę milisekund od .1970-01-01 00:00:00 UTC |
unix_seconds (wyrażenie) | Zwraca liczbę sekund od .1970-01-01 00:00:00 UTC |
unix_timestamp([wyrażenie[, fmt]]) | zwraca znacznik czasu UNIX dla bieżącego lub określonego czasu. |
dzień powszedni (wyrażenie) | Zwraca dzień tygodnia expr . |
weekofyear(wyrażenie) | Zwraca tydzień roku expr . |
year(expr) | Zwraca składnik roku expr . |
window(expr, width[, step[, start]]) | Tworzy okno przesuwne oparte na przeskokach w wyrażeniu czasowym. |
window_time(okno) | Zwraca końcowy czas inkluzywny okna przesuwanego generowanego przez funkcje window lub session_window. |
Funkcje geoprzestrzenne H3
Aby uzyskać informacje o funkcjach geoprzestrzennych H3, zobacz Funkcje geoprzestrzenne H3.
Funkcje rzutujące i konstruktory
Aby uzyskać więcej informacji o rzutowaniu między typami, zobacz funkcja cast
i funkcja try_cast
.
Funkcja | opis |
---|---|
array([wyrażenie [, ...]]) | Zwraca tablicę z elementami w expr . |
bigint(wyrażenie) | Rzutuje wartość expr na BIGINT . |
binary(expr) | Rzutuje wartość expr na BINARY . |
boolean(wyrażenie) | Rzutuje expr na BOOLEAN . |
cast(expr AS type) | Rzutuje wartość expr na docelowy typ danych type . |
wyrażenie :: typ | Rzutuje wartość expr na docelowy typ danych type . |
date(expr) | Rzutuje wartość expr na DATE . |
dziesiętne (wyrażenie) | Rzutuje wartość expr na DECIMAL . |
double(wyrażenie) | Rzutuje wartość expr na DOUBLE . |
float(wyrażenie) | Rzutuje wartość expr na FLOAT . |
int(wyrażenie) | Rzutuje wartość expr na INTEGER . |
make_date (rok, miesiąc,dzień) | Tworzy datę z pól year , month i day . |
make_dt_interval([dni[, godziny[, min[, s]]]]) | Tworzy przedział czasowy z days , hours , mins i secs . |
make_interval (lata, miesiące, tygodnie, dni, godziny, min, sek.) | Tworzy interwał na podstawie years , months , weeks , days , hours , mins i secs . |
make_timestamp(rok,miesiąc,dzień,godzina,min,s[,strefa czasowa]) | Tworzy znacznik czasu na podstawie pól year , month , day , hour , min , sec i timezone . |
make_ym_interval([lata[, miesiące]]) | Tworzy interwał roku i miesiąca na podstawie years oraz months . |
map([{key1, wartość1} [, ...]]) | Tworzy mapę z określonymi parami klucz-wartość. |
named_struct({name1, val1} [, ...]) | Tworzy strukturę z określonymi nazwami i wartościami pól. |
smallint(wyrażenie) | Rzutuje wartość expr na SMALLINT . |
string(wyrażenie) | Rzutuje wartość expr na STRING . |
struct(expr1 [, ...]) | Tworzy STRUCT z określonymi wartościami pól. |
tinyint(wyrażenie) | Rzutuje expr na TINYINT . |
znacznikCzasu(wyrażenie) | Rzutuje expr na TIMESTAMP . |
to_char(wyrażenie, fmt) | Zwraca expr skonwertowane na STRING z użyciem formatowania fmt . |
to_date(wyrażenie[,fmt]) | Zwraca expr rzutowanie do daty przy użyciu opcjonalnego formatowania. |
to_number(wyrażenie, fmt) | Zwraca expr przekonwertowane na DECIMA L przy użyciu formatowania fmt . |
to_timestamp(wyrażenie[,fmt]) | Zwraca expr konwersję na znacznik czasu przy użyciu opcjonalnego formatowania. |
to_varchar(wyrażenie, fmt) | Zwraca expr skonwertowane na STRING z użyciem formatowania fmt . |
try_cast(expr AS typ) | Bezpiecznie przekształca wartość expr do docelowego typu danych type . |
try_to_number(wyrażenie, fmt) | Zwraca expr rzutowany do DECIMAL z użyciem formatowania fmt , lub NULL , jeśli expr nie jest prawidłowy. |
Funkcje CSV i Avro
Funkcja | opis |
---|---|
from_avro(avroBin, jsonSchema[, opcje]) | Zwraca wartość struktury na podstawie wartości avroBin i jsonSchema . |
from_csv(csvStr, schema[, options]) | Zwraca wartość struktury z wartościami csvStr i schema . |
schema_of_csv(csv[, opcje]) | Zwraca schemat ciągu CSV w formacie DDL. |
to_avro(wyrażenie[, opcje]) | Zwraca wartość binarną Avro z podaną wartością struktury. |
to_csv(expr[, opcje]) | Zwraca ciąg CSV z określoną wartością struktury. |
Funkcje JSON
Funkcja | opis |
---|---|
jsonStr: jsonPath | Zwraca pola wyodrębnione z obiektu jsonStr . |
from_json(jsonStr, schema[, options]) | Zwraca wartość struktury z wartościami jsonStr i schema . |
get_json_object(wyrażenie, ścieżka) | Wyodrębnia JSON obiekt z path obiektu . |
json_array_length(jsonArray) | Zwraca liczbę elementów w najbardziej zewnętrznej tablicy JSON . |
json_object_keys(jsonObject) | Zwraca wszystkie klucze najbardziej zewnętrznego obiektu JSON jako tablicę. |
json_tuple(jsonStr, path1 [, ...]) | Zwraca wiele JSON obiektów jako krotkę. |
parse_json(jsonStr) | Zwraca VARIANT wartość z jsonStr . |
schema_of_json(jsonStr[, options]) | Zwraca schemat ciągu JSON w formacie DDL. |
schema_of_json_agg(jsonStr[, options]) | Zwraca połączony schemat ciągów JSON w grupie w formacie DDL. |
to_json(expr[, opcje]) | Zwraca ciąg JSON z wartością STRUCT lub VARIANT określoną w pliku expr . |
Funkcje VARIANT
Funkcja | opis |
---|---|
variantExpr: jsonPath | Zwraca pola wyodrębnione z variantExpr za pomocą ścieżki JSON. |
is_variant_null(variantExpr) | Sprawdza, czy variantExpr jest zakodowany jako VARIANT -format NULL . |
parse_json(jsonStr) | Zwraca VARIANT wartość z jsonStr . |
schema_of_variant(variantExpr) | Zwraca schemat wyrażenia VARIANT w formacie DDL. |
schema_of_variant_agg(variantExpr) | Zwraca połączony schemat wszystkich VARIANT wartości w grupie w formacie DDL. |
to_json(expr[, opcje]) | Zwraca ciąg JSON z wartością STRUCT lub VARIANT określoną w pliku expr . |
try_parse_json(jsonStr) | Zwraca wartość VARIANT z jsonStr , jeśli to możliwe. Jeśli nie jest to możliwe, NULL zostanie zwrócony. |
try_variant_get(variantExpr,path,type) | Wyodrębnia wartość typu type z wartości variantExpr , określonego przez path , lub NULL jeśli rzutowanie do typu docelowego nie jest możliwe. |
variant_explode(dane wejściowe) | Zwraca zestaw wierszy przez rozpakowywanie input . |
variant_explode_outer(dane wejściowe) | Zwraca zestaw wierszy przez anulowanie zagnieżdżania input przy użyciu semantyki zewnętrznej. |
variant_get(variantExpr,path,type) | Wyodrębnia wartość typu type z klasy variantExpr , określoną przez path . |
Funkcje XPath i XML
Funkcja | opis |
---|---|
from_xml(xmlStr, schema[, options]) | Zwraca wartość struktury przeanalizowaną z xmlStr przy użyciu schema . |
schema_of_xml(xmlStr[, opcje]) | Zwraca schemat ciągu XML w formacie DDL. |
xpath(xml, xpath) | Zwraca wartości w węzłach xml , które są zgodne z xpath . |
xpath_boolean(xml, xpath) | Zwraca true , jeśli wyrażenie xpath zostanie ocenione jako true lub jeśli zostanie znaleziony pasujący węzeł w xml . |
xpath_double(xml, xpath) |
DOUBLE Zwraca wartość z dokumentu XML. |
xpath_float(xml, xpath) |
FLOAT Zwraca wartość z dokumentu XML. |
xpath_int(xml, xpath) |
INTEGER Zwraca wartość z dokumentu XML. |
xpath_long(xml, xpath) |
BIGINT Zwraca wartość z dokumentu XML. |
xpath_number(xml, xpath) |
DOUBLE Zwraca wartość z dokumentu XML. |
xpath_short(xml, xpath) |
SHORT Zwraca wartość z dokumentu XML. |
xpath_string(xml, xpath) | Zwraca zawartość pierwszego węzła XML zgodnego z wyrażeniem XPath. |
Funkcje sztucznej inteligencji
Funkcja | opis |
---|---|
ai_analyze_sentiment(zawartość) | Zwraca nastrój tekstu. |
ai_classify(zawartość, etykiety) | Klasyfikuje podaną zawartość w jednej z podanych etykiet. |
ai_extract (zawartość, etykiety) | Wyodrębnia jednostki określone przez etykiety z danego tekstu. |
ai_fix_grammar(zawartość) | Poprawia błędy gramatyczne w danym tekście. |
ai_forecast(obserwowane, kolumna_czasu) | Ekstrapoluje dane szeregów czasowych w przyszłość. |
ai_gen(zawartość) | Wywołuje najnowocześniejszy model generatywny sztucznej inteligencji z API modeli Fundacji Databricks, aby odpowiedzieć na monit dostarczony przez użytkownika. |
ai_generate_text(prompt, modelName[, param1, value1] [...]) | Przestarzałe: Zwraca tekst wygenerowany przez wybrany duży model językowy (LLM) na podstawie polecenia. |
ai_mask(zawartość, etykiety) | Maskuje określone jednostki w danym tekście. |
ai_query(endpointName, request, returnType) | Wywołuje istniejący punkt końcowy obsługi modeli AI Mosaic, analizuje otrzymaną odpowiedź i ją zwraca. |
ai_similarity(strExpr1, strExpr2) | Porównuje dwa ciągi i oblicza wynik podobieństwa semantycznego. |
ai_summarize(zawartość[, max_words]) | Generuje podsumowanie danego tekstu. |
ai_translate(zawartość, to_lang) | Tłumaczy tekst na określony język docelowy. |
vector_search(indeks, zapytanie, num_results) | Wykonywanie zapytań do indeksu Wyszukiwania Wektorowego Mosaic AI za pomocą SQL. |
Funkcje odczytu
Funkcja | opis |
---|---|
read_files(path, [optionKey => optionValue] [, ...]) | Odczytuje pliki danych w magazynie w chmurze i zwraca je w formacie tabelarycznym. |
read_kafka([optionKey => optionValue] [, ...]) | Odczytuje rekordy z klastra platformy Apache Kafka i zwraca je w formacie tabelarycznym. |
read_kinesis({parameter => wartość} [, ...]) | Zwraca tabelę z rekordami odczytanymi z Kinesis z co najmniej jednego strumienia. |
read_pubsub([parametr => wartość] [, ...]) | Funkcja zwracająca tabelę do odczytywania rekordów z Pub/Sub z tematu. |
read_pulsar({optionKey => optionValue} [, ...]) | Zwraca tabelę z rekordami odczytanymi z pulsaru. |
read_state_metadata(ścieżka) | Zwraca tabelę zawierającą wiersze, które przedstawiają metadane stanu zapytania strumieniowego. |
read_statestore(ścieżka [, option_key => option_value] [...]) | Zwraca rekordy z repozytorium stanów dla zapytań przesyłanych strumieniowo. |
Różne funkcje
Funkcja | opis |
---|---|
assert_true(wyrażenie) | Zwraca błąd, jeśli expr nie ma wartości true. |
Wyrażenie CASE { PO WYBRANIU OPCJI 1 NASTĘPNIE res1 } [...] [ELSE def] KONIEC | Zwraca resN wartość dla pierwszego optN , który jest równy expr lub def jeśli żaden z nich nie pasuje. |
CASE { WHEN cond1 THEN res1 } [...] [ELSE def] KONIEC | Zwraca resN dla pierwszego condN , który daje wartość true, lub def , jeśli żadna nie zostanie znaleziona. |
cloud_files_state( { TABLE(tabela) | punkt kontrolny } ) | Zwraca stan pliku źródłowego autoloadera cloud_files . |
coalesce(wyrażenie1, wyrażenie2 [, ...]) | Zwraca pierwszy argument inny niż null. |
kolacje() | Zwraca listę dostępnych kolacji. |
cube (wyrażenie1 [, ...]) | Tworzy wielowymiarową kostkę przy użyciu określonych kolumn wyrażeń. |
current_catalog() | Zwraca bieżący wykaz. |
current_database() | Zwraca bieżący schemat. |
current_metastore() | Zwraca bieżący identyfikator Unity Catalog Metastore. |
current_recipient(klucz) | Zwraca właściwość bieżącego adresata w widoku udostępnionym przez Delta Sharing. |
current_schema() | Zwraca bieżący schemat. |
current_user() | Zwraca użytkownika wykonującego instrukcję . |
current_version() | Zwraca bieżącą wersję usługi Azure Databricks. |
decode(expr, { key, value } [, ...] [,defValue]) | Zwraca wartość odpowiadającą kluczowi. |
elt(index, expr1 [, ...] ) | Zwraca n-te wyrażenie. |
equal_null(wyrażenie1, wyrażenie2) | Zwraca true , jeśli expr1 jest równe expr2 lub oba wyrażenia są NULL , lub false w przeciwnym razie. |
event_log( { TABLE(tabela) | pipeline_id } ) | Zwraca tabelę historii aktualizacji dla zmaterializowanego widoku, tabeli przesyłania strumieniowego lub potoku. |
greatest(expr1, expr2 [, ...]) | Zwraca największą wartość wszystkich argumentów, pomijając wartości null. |
grouping(col) | Wskazuje, czy określona kolumna w GROUPING SET , ROLLUP lub CUBE reprezentuje sumę częściową. |
grouping_id([col1 [, ...]]) | Zwraca poziom grupowania dla zestawu kolumn. |
hash(expr1 [, ...]) | Zwraca skonstruowaną wartość argumentów. |
hll_sketch_estimate(wyrażenie) | Szacuje liczbę unikalnych wartości zebranych w szkicu HyperLogLog. |
hll_union(wyrażenie1, wyrażenie2 [,allowDifferentLgConfigK]) | Łączy dwa szkice danych HyperLogLog. |
http_request({parm => expr} [, ...]) | Wysyła żądanie HTTP przy użyciu zdefiniowanego połączenia HTTP. |
java_method(klasa, metoda[, arg1 [, ...]]) | Wywołuje metodę przy użyciu refleksji. |
if(cond, expr1, expr2) | Zwraca expr1 jeśli cond jest true , lub expr2 w przeciwnym razie. |
iff(cond, expr1, expr2) | Zwraca expr1 jeśli cond jest true , lub expr2 w przeciwnym razie. |
ifnull(expr1, expr2) | Zwraca expr2 jeśli expr1 jest NULL , lub expr1 w przeciwnym razie. |
input_file_block_length() | Zwraca długość w bajtach odczytywanego bloku. |
input_file_block_start() | Zwraca przesunięcie początkowe w bajtach odczytywanego bloku. |
input_file_name() | Zwraca nazwę odczytywanego pliku lub pusty ciąg, jeśli nie jest dostępny. |
is_account_group_member(grupa) | Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie konta. |
is_member(grupa) | Zwraca wartość true, jeśli bieżący użytkownik jest członkiem grupy na poziomie obszaru roboczego. |
isnull(wyrażenie) | Zwraca wartość true , jeśli expr ma wartość NULL . |
isnotnull(wyrażenie) | Zwraca true , jeśli expr nie jest NULL . |
least(wyrażenie1, wyrażenie2 [, ...]) | Zwraca najmniejszą wartość wszystkich argumentów, pomijając wartości null. |
list_secrets([scopeStr]) | Zwraca klucze w jednym lub wszystkich zakresach, które użytkownik jest autoryzowany do zobaczenia z usługi tajemnic Databricks. |
luhn_check(numStr) | Zwraca true , jeśli numStr przechodzi sprawdzian algorytmu Luhn. |
monotonically_increasing_id() | Zwraca monotonicznie rosnące 64-bitowe liczby całkowite. |
nullif(expr1, expr2) | Zwraca NULL , jeśli expr1 równa się expr2 , lub expr1 w przeciwnym razie. |
nvl(wyrażenie1, wyrażenie2) | Zwraca expr2 jeśli expr1 jest NULL , lub expr1 w przeciwnym razie. |
nvl2(expr1, expr2, expr3) | Zwraca expr2 , jeśli expr1 nie jest NULL , w przeciwnym razie zwraca expr3 . |
raise_error (wyrażenie) | Zgłasza wyjątek z komunikatem expr . |
range(end) | Zwraca tabelę wartości w określonym zakresie. |
range(start, end [, step [, numParts]]) | Zwraca tabelę wartości w określonym zakresie. |
reflect(klasa, metoda[, arg1 [, ...]]) | Wywołuje metodę przy użyciu refleksji. |
secret(scope, key) | Wyodrębnia tajną wartość z daną scope i key z usługi tajnych danych Databricks. |
session_user() | Zwraca użytkownika połączonego z usługą Azure Databricks. |
spark_partition_id() | Zwraca bieżący identyfikator partycji. |
sql_keywords() | Zwraca zestaw słów kluczowych SQL w usłudze Azure Databricks. |
stack(numRows, expr1 [, ...]) | Oddziela expr1 , ..., exprN na numRows wiersze. |
table_changes(table_str, start [, end]) | Zwraca dziennik zmian w tabeli Delta Lake z włączonym kanałem danych o zmianach. |
try_reflect(klasa, metoda[, arg1 [, ...]]) | Wywołuje metodę z odbiciem, zwracając NULL , jeśli metoda nie powiedzie się. |
try_secret(zakres, klucz) | Wyodrębnia wartość tajną z podanymi scope i key z usługi wpisów tajnych Databricks, lub zwraca NULL jeśli nie można odzyskać klucza. |
typeof(wyrażenie) | Zwraca ciąg znaków w formacie DDL dla typu danych expr . |
user() | Zwraca użytkownika wykonującego instrukcję . |
uuid() | Zwraca ciąg uniwersalnego unikatowego identyfikatora (UUID). |
window(expr, width[, step [, start]]) | Tworzy okno przesuwne oparte na przeskokach w wyrażeniu czasowym. |
xxhash64(wyrażenie1 [, ...]) | Zwraca 64-bitowy skrót wartości argumentów. |
version() | Zwraca wersję platformy Apache Spark. |