الدوال المدمجة
ينطبق على: Databricks SQL Databricks Runtime
تقدم هذه المقالة ارتباطات إلى أوصاف عوامل التشغيل والدالات المضمنة للسلاسل والأنواع الثنائية، والتحجيمات الرقمية، والتجميعات، والنوافذ، والصفائف، والخرائط، والتواريخ والطوابع الزمنية، والصب، وبيانات CSV، وبيانات JSON، ومعالجتها، والدالات المتنوعة الأخرى.
بالنسبة لحالات الاستخدام التي لا تدعمها الدالات المضمنة الموجودة، ضع في اعتبارك تعريف دالة مخصصة. راجع ما هي الوظائف المعرفة من قبل المستخدم (UDFs)؟.
انظر أيضا:
عوامل التشغيل والمسندات
للحصول على معلومات حول كيفية تحليل عوامل التشغيل فيما يتعلق ببعضها البعض، راجع أسبقية عامل التشغيل.
عامل تشغيل | بناء الجملة | الوصف |
---|---|---|
& | expr1 & expr2 |
إرجاع البت AND من expr1 و expr2 . |
و | expr1 and expr2 |
ترجع هذه الدالة المنطقية AND ل expr1 و expr2 . |
* | multiplier * multiplicand |
إرجاع multiplier مضروبا في multiplicand . |
!= | expr1 != expr2 |
إرجاع true إذا expr1 لم يكن يساوي expr2 ، أو false غير ذلك. |
! | !expr |
إرجاع المنطقي NOT لتعبير منطقي. |
between | expr1 [not] between expr2 and expr2 |
يختبر ما إذا كان expr1 أكبر من أو يساوي expr2 وأقل من أو يساوي expr3 . |
[ ] | arrayExpr [ indexExpr ] |
إرجاع indexExpr العنصر الثاني من ARRAY arrayExpr . |
[ ] | mapExpr [ keyExpr ] |
إرجاع قيمة في keyExpr .MAP mapExpr |
^ | expr1 ^ expr2 |
إرجاع البت الخاص OR (XOR) ب expr1 و expr2 . |
: | jsonStr : jsonPath |
إرجاع الحقول المستخرجة jsonStr من . |
:: | expr :: type |
تحويل القيمة expr إلى نوع type البيانات الهدف . |
?:: | expr ?:: type |
تحويل القيمة expr إلى نوع type البيانات الهدف إذا كان ذلك ممكنا، ويرجع NULL خلاف ذلك. |
div | dividend div divisor |
إرجاع الجزء المتكامل من تقسيم حسب dividend divisor . |
. | mapExpr . keyIdentifier |
MAP إرجاع قيمة حسب keyIdentifier . |
. | structExpr . fieldIdentifier |
STRUCT إرجاع حقل بواسطة fieldIdentifier . |
== | expr1 == expr2 |
إرجاع true إذا كان expr1 يساوي expr2 ، أو false غير ذلك. |
= | expr1 = expr2 |
إرجاع true إذا كان expr1 يساوي expr2 ، أو false غير ذلك. |
>= | expr1 >= expr2 |
إرجاع true إذا كان expr1 أكبر من أو يساوي expr2 ، أو false غير ذلك. |
> | expr1 > expr2 |
إرجاع true إذا كان expr1 أكبر من expr2 ، أو false غير ذلك. |
موجود | exists(query) |
إرجاع true إذا كانت query ترجع صفا واحدا على الأقل، أو خطأ بخلاف ذلك. |
ilike | str [not] ilike (pattern[ESCAPE escape]) |
إرجاع true إذا str كان (لا) يتطابق pattern مع escape حالة الأحرف بشكل غير حساس. |
ilike | str [not] ilike {ANY\|SOME\|ALL}([pattern[, ...]]) |
إرجاع true إذا str كان (لا) يتطابق مع أي/كافة الأنماط غير حساسة لحالة الأحرف. |
في | elem [not] in (expr1[, ...]) |
إرجاع true إذا كان elem (لا) يساوي أي exprN . |
في | elem [not] in (query) |
إرجاع true إذا كان elem (لا) يساوي أي صف في query . |
مميز | expr1 is [not] distinct from expr2 |
اختبار ما إذا كانت الوسيطات (لا) لها قيم مختلفة حيث NULL تعتبر s قيما قابلة للمقارنة. |
خطأ | expr is [not] false |
يختبر ما إذا كان expr (ليس) false . |
قيمة خالية | expr is [not] null |
إرجاع true إذا كان expr (ليس) NULL . |
صحيح | expr is [not] true |
يختبر ما إذا كان expr (ليس) true . |
like | str [not] like (pattern[ESCAPE escape]) |
إرجاع true إذا str كان (لا) يتطابق pattern مع escape . |
like | str [not] like {ANY\|SOME\|ALL}([pattern[, ...]]) |
إرجاع true إذا str كان (لا) يتطابق مع أي/كافة الأنماط. |
<=> | expr1 <=> expr2 |
ترجع نفس النتيجة مثل EQUAL(=) المعاملات غير الخالية، ولكن ترجع true إذا كان كلاهما ، NULL false إذا كان أحدهما هو NULL . |
<= | expr1 <= expr2 |
إرجاع true إذا كان expr1 أقل من أو يساوي expr2 ، أو false غير ذلك. |
<> | expr1 <> expr2 |
إرجاع true إذا expr1 لم يساوي expr2 ، أو false غير ذلك. |
< | expr1 < expr2 |
إرجاع true إذا كان expr1 أقل من expr2 ، أو false غير ذلك. |
- | expr1 - expr2 |
إرجاع طرح من expr2 expr1 . |
not | not expr |
إرجاع المنطقي NOT لتعبير منطقي. |
أو | expr1 or expr2 |
ترجع هذه الدالة المنطقية OR ل expr1 و expr2 . |
% | dividend % divisor |
إرجاع الباقي بعد dividend / divisor . |
|| | expr1 \|\| expr2 |
إرجاع سلسلة و expr1 expr2 . |
| | expr1 \| expr2 |
إرجاع البت OR من expr1 و expr2 . |
+ | expr1 + expr2 |
إرجاع مجموع expr1 و expr2 . |
regexp | str [not] regexp regex |
إرجاع true إذا str لم يتطابق (لا) مع regex . |
regexp_like | str [not] regexp_like regex |
إرجاع true إذا str لم يتطابق (لا) مع regex . |
rlike | str [not] rlike regex |
إرجاع true إذا str لم يتطابق (لا) مع regex . |
/ | dividend / divisor |
إرجاع dividend مقسوما على divisor . |
~ | ~ expr |
إرجاع البت NOT ل expr . |
أسبقية عامل التشغيل
الأسبقية | عامل تشغيل |
---|---|
1 | : ، ، :: ، ?:: [ ] |
2 | - (أحادي)، + (أحادي)، ~ |
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 |
السلسلة والدالات الثنائية
الوظيفة | الوصف |
---|---|
expr1 || expr2 | إرجاع سلسلة و expr1 expr2 . |
aes_decrypt(expr, key[, mode[, padding[, aad]]]) | فك تشفير ثنائي expr باستخدام تشفير AES. |
aes_encrypt(expr, key[, mode[, padding[, iv[, aad]]]]) | تشفير ثنائي expr باستخدام تشفير AES. |
ascii (str) | إرجاع نقطة التعليمات البرمجية ASCII للحرف الأول من str . |
base64(expr) | expr تحويل إلى سلسلة 64 أساسية. |
bin(expr) | إرجاع التمثيل الثنائي ل expr . |
ثنائي (expr) | تحويل قيمة expr إلى BINARY . |
bit_length (expr) | إرجاع طول البت لبيانات السلسلة أو عدد بتات البيانات الثنائية. |
bitmap_count (expr) | إرجاع عدد البتات التي تم تعيينها في سلسلة BINARY تمثل صورة نقطية. |
btrim(str [, trimStr]) | إرجاع str مع إزالة الأحرف البادئة واللاحقة. |
char(expr) | إرجاع الحرف عند نقطة التعليمات البرمجية UTF-16 المتوفرة. |
char_length (expr) | إرجاع طول حرف بيانات السلسلة أو عدد وحدات البايت للبيانات الثنائية. |
character_length (expr) | إرجاع طول حرف بيانات السلسلة أو عدد وحدات البايت للبيانات الثنائية. |
charindex(substr, str[, pos]) | إرجاع موضع التكرار الأول ل substr في str بعد الموضع pos . |
chr (expr) | إرجاع الحرف عند نقطة التعليمات البرمجية UTF-16 المتوفرة. |
concat(expr1, expr2[, ...]) | إرجاع سلسلة الوسيطات. |
concat_ws(sep[, expr1[, ...]]) | إرجاع سلاسل السلسلة مفصولة ب sep . |
contains(expr, subExpr) | إرجاع true إذا كان expr STRING أو BINARY يحتوي على subExpr . |
crc32(expr) | إرجاع قيمة فحص التكرار الدوري ل expr . |
decode(expr, charSet) | يترجم ثنائيا expr إلى سلسلة باستخدام ترميز charSet مجموعة الأحرف . |
encode(expr, charSet) | إرجاع التمثيل الثنائي لسلسلة باستخدام ترميز الأحرف charSet . |
endwith(expr, endExpr) | إرجاع true إذا كان expr STRING أو BINARY ينتهي ب endExpr . |
find_in_set(searchExpr, sourceExpr) | إرجاع موضع سلسلة داخل قائمة سلاسل مفصولة بفواصل. |
format_number(expr, scale) | تنسيقات expr مثل #,###,###.## ، مقربة إلى scale المنازل العشرية. |
format_number(expr, fmt) | تنسيقات expr مثل fmt . |
format_string(strfmt[, obj1 [, ...]]) | إرجاع سلسلة منسقة من سلاسل تنسيق نمط الطباعة. |
سداسي (expr) | expr يتحول إلى سداسي عشري. |
str ilike (نمط [ESCAPE escape]) | إرجاع true إذا str تطابق pattern مع escape حالة الأحرف بشكل غير حساس. |
initcap(expr) | إرجاع expr بالحرف الأول من كل كلمة بأحرف كبيرة. |
instr(str, substr) | إرجاع الفهرس (المستند إلى 1) لأول تكرار في substr str . |
lcase(expr) | إرجاع expr مع تغيير كافة الأحرف إلى أحرف صغيرة. |
اليسار (str، len) | إرجاع الأحرف الموجودة في أقصى len اليسار من str . |
len (expr) | إرجاع طول حرف بيانات السلسلة أو عدد وحدات البايت للبيانات الثنائية. |
الطول (expr) | إرجاع طول حرف بيانات السلسلة أو عدد وحدات البايت للبيانات الثنائية. |
levenshtein(str1, str2) | إرجاع مسافة Levenshtein بين السلاسل str1 و str2 . |
str مثل (pattern[ESCAPE escape]) | إرجاع true إذا str تطابق pattern مع escape . |
location(substr, str[, pos]) | إرجاع موضع التكرار الأول ل substr في str بعد الموضع pos . |
أقل (expr) | إرجاع expr مع تغيير كافة الأحرف إلى أحرف صغيرة. |
lpad(expr, len[, pad]) | إرجاع expr ، ومضاف إلى اليسار مع pad إلى طول len . |
ltrim([trimstr,] str) | إرجاع str بأحرف بادئة داخل trimStr تمت إزالتها. |
mask(str[, upperChar[, lowerChar[, digitChar[, otherChar]]]]) | إرجاع إصدار مقنع من الإدخال str . |
md5 (expr) | إرجاع المجموع الاختباري expr MD5 128 بت كسلسلة سداسية. |
octet_length (expr) | إرجاع طول البايت لبيانات السلسلة أو عدد وحدات البايت للبيانات الثنائية. |
تراكب (إدخال وضع استبدال من نقاط البيع [FOR len]) | يستبدل input ب replace الذي يبدأ في pos و بطول len . |
parse_url(url, partToExtract[, key]) | استخراج جزء من url . |
position(substr, str[, pos]) | إرجاع موضع التكرار الأول ل substr في str بعد الموضع pos . |
position(subtr IN str) | إرجاع موضع التكرار الأول ل substr في str بعد الموضع pos . |
printf(strfmt[, obj1 [, ...]]) | إرجاع سلسلة منسقة من سلاسل تنسيق نمط الطباعة. |
str regexp regex | إرجاع true إذا str تطابقت regex . |
str regexp_like regex | إرجاع true إذا str تطابقت regex . |
regexp_count(str, regexp) | إرجاع عدد المرات str التي تطابق regexp النمط. |
regexp_extract(str, regexp[, idx]) | استخراج السلسلة الأولى في str التي تطابق regexp التعبير وتتوافق مع regex فهرس المجموعة. |
regexp_extract_all(str, regexp[, idx]) | استخراج كافة السلاسل في str التي تطابق regexp التعبير وتتوافق مع regex فهرس المجموعة. |
regexp_instr(str, regexp) | إرجاع موضع السلسلة الفرعية الأولى في str تلك المطابقات regexp . |
regexp_replace(str, regexp, rep[, position]) | يستبدل كافة السلاسل الفرعية لتلك المطابقة str regexp ب rep . |
regexp_substr(str, regexp) | إرجاع السلسلة الفرعية الأولى في str التي تطابق regexp . |
repeat(expr, n) | إرجاع السلسلة التي تكرر expr n الأوقات. |
replace(str, search [, replace]) | يستبدل كافة تكرارات ب search replace . |
عكسي (expr) | إرجاع سلسلة معكوسة أو صفيف بترتيب عكسي للعناصر. |
right(str, len) | إرجاع الأحرف الموجودة في أقصى len اليمين من السلسلة str . |
str rlike regex | إرجاع true إذا str تطابقت regex . |
rpad(expr, len[, pad]) | إرجاع expr ، بزر الماوس الأيمن مع pad إلى طول len . |
rtrim([trimStr,] str) | إرجاع str مع إزالة الأحرف اللاحقة. |
الجمل(str[, lang, country]) | ينقسم str إلى صفيف من الكلمات. |
sha (expr) | إرجاع قيمة تجزئة sha1 كسلسلة سداسية عشرية من expr . |
sha1(expr) | إرجاع قيمة تجزئة sha1 كسلسلة سداسية عشرية من expr . |
sha2(expr, bitLength) | إرجاع المجموع الاختباري لعائلة SHA-2 كسلسلة سداسية عشرية ل expr . |
soundex(expr) | إرجاع التعليمات البرمجية soundex للسلسلة. |
space(n) | إرجاع سلسلة تتكون من n مسافات. |
split(str, regex[, limit]) | ينقسم str حول التكرارات التي تطابق regex وترجع صفيفا بطول على الأكثر limit . |
split_part(str, delim, partNum) | تقسيم str حول تكرارات delim الجزء وإرجاعه partNum . |
startswith(expr, startExpr) | إرجاع true إذا كان expr STRING أو BINARY يبدأ ب startExpr . |
سلسلة (expr) | تحويل القيمة expr إلى STRING . |
substr(expr, pos[, len]) | ترجع السلسلة الفرعية expr التي تبدأ من pos و بطول len . |
substr(expr FROM pos[ FOR len]) | ترجع السلسلة الفرعية expr التي تبدأ من pos و بطول len . |
substring(expr, pos[, len]) | ترجع السلسلة الفرعية expr التي تبدأ من pos و بطول len . |
substring(expr FROM pos[ FOR len]) | ترجع السلسلة الفرعية expr التي تبدأ من pos و بطول len . |
substring_index(expr, delim, count) | إرجاع السلسلة الفرعية ل expr قبل count تكرارات المحدد delim . |
to_binary(expr[, fmt]) | إرجاع expr التحويل إلى ثنائي استنادا fmt إلى . |
to_char(numExpr, fmt) | إرجاع numExpr التحويل إلى STRING استخدام التنسيق fmt ." |
to_varchar(numExpr, fmt) | إرجاع numExpr التحويل إلى STRING استخدام التنسيق fmt ." |
ترجمة (expr، من، إلى) | expr إرجاع حيث تم استبدال كافة الأحرف في from بتلك الموجودة في to . |
trim([[BOTH | البادئة | TRAILING] [trimStr] FROM] str) | اقتطاع الأحرف من سلسلة. |
try_aes_decrypt(expr, key[, mode[, padding[, aad]]]) | فك تشفير ثنائي expr باستخدام تشفير AES، والعودة NULL في حالة حدوث خطأ. |
try_to_binary(expr [, fmt]) | إرجاع expr التحويل إلى استنادا إلى fmt BINARY ، أو NULL إذا كان الإدخال غير صالح. |
try_url_decode (سلسلة) | ترجمة سلسلة مرة أخرى من تنسيق application/x-www-form-urlencoded ، وإرجاعها NULL في حالة حدوث خطأ. |
try_zstd_decompress(قيمة) | إرجاع قيمة تم إلغاء ضغطها باستخدام ضغط Zstandard، أو NULL إذا كان الإدخال غير صالح. |
ucase(expr) | إرجاع expr مع تغيير كافة الأحرف إلى أحرف كبيرة. |
unbase64(expr) | إرجاع سلسلة base64 تم فك ترميزها كسلسلة ثنائية. |
unhex(expr) | تحويل سداسي عشري expr إلى BINARY . |
upper(expr) | إرجاع expr مع تغيير كافة الأحرف إلى أحرف كبيرة. |
url_decode (سلسلة) | ترجمة سلسلة مرة أخرى من تنسيق application/x-www-form-urlencoded . |
url_encode (سلسلة) | يترجم سلسلة إلى تنسيق application/x-www-form-urlencoded . |
zstd_compress (value[,level[,streaming_mode]]) | إرجاع القيمة المضغوطة بضغط Zstandard. |
zstd_decompress(قيمة) | إرجاع القيمة التي تم إلغاء ضغطها باستخدام ضغط Zstandard. |
دالات رقمية رقمية
الوظيفة | الوصف |
---|---|
~ expr | إرجاع البت NOT ل expr . |
توزيع الأرباح / عامل القسمة | إرجاع dividend مقسوما على divisor . |
expr1 | expr2 | إرجاع البت OR من expr1 و expr2 . |
- expr | إرجاع القيمة النفي ل expr . |
expr1 - expr2 | إرجاع طرح من expr2 expr1 . |
+ expr | إرجاع قيمة expr . |
expr1 + expr2 | إرجاع مجموع expr1 و expr2 . |
المقسوم على نسبة الأرباح | إرجاع الباقي بعد dividend / divisor . |
expr1 ^ expr2 | إرجاع البت الخاص OR (XOR) ب expr1 و expr2 . |
expr1 وexpr2 | إرجاع البت AND من expr1 و expr2 . |
مضاعف * مضروب | إرجاع multiplier مضروبا في multiplicand . |
abs (expr) | إرجاع القيمة المطلقة للقيمة الرقمية في expr . |
acos (expr) | إرجاع جيب التمام العكسي (arccosine) ل expr . |
acosh(expr) | إرجاع جيب التمام العكسي الزائدي ل expr . |
asin (expr) | إرجاع جيب الزاوية العكسي (arcsine) ل expr . |
asinh(expr) | إرجاع جيب الزاوية العكسي الزائدي ل expr . |
atan (expr) | إرجاع ظل الزاوية العكسي (ظل الزاوية) ل expr . |
atan2(exprY, exprX) | إرجاع الزاوية بالتقدير الدائري بين المحور س الموجب للطائرة والنقطة المحددة بواسطة الإحداثيات (exprX ، exprY ). |
atanh(expr) | إرجاع ظل الزاوية العكسي الزائدي ل expr . |
bigint (expr) | تحويل القيمة expr إلى BIGINT . |
bit_count (expr) | إرجاع عدد البتات التي تم تعيينها في الوسيطة. |
bit_get(expr, pos) | إرجاع قيمة قليلا في تمثيل ثنائي لرقم متكامل. |
bit_reverse (expr) | إرجاع القيمة التي تم الحصول عليها عن طريق عكس ترتيب البتات في الوسيطة . |
bitmap_bit_position (expr) | إرجاع موضع البت المستند إلى 0 لرقم معين BIGINT داخل مستودع. |
bitmap_bucket_number (expr) | إرجاع رقم مستودع الصورة النقطية لرقم معين BIGINT . |
bround(expr[,targetScale]) | إرجاع التقريب expr باستخدام HALF_EVEN وضع التقريب. |
cbrt (expr) | إرجاع جذر المكعب ل expr . |
ceil(expr[,targetScale]) | إرجاع أصغر رقم ليس أصغر من expr تقريبه إلى targetScale أرقام نسبة إلى الفاصلة العشرية. |
ceiling(expr[,targetScale]) | إرجاع أصغر رقم ليس أصغر من expr تقريبه إلى targetScale أرقام نسبة إلى الفاصلة العشرية. |
conv(num, fromBase, toBase) | num تحويل من fromBase إلى toBase . |
convert_timezone([sourceTz, ]targetTz, sourceTs) | TIMESTAMP_NTZ sourceTs تحويل من المنطقة الزمنية sourceTz إلى targetTz . |
cos (expr) | إرجاع جيب التمام ل expr . |
cosh (expr) | إرجاع جيب التمام الزائدي ل expr . |
cot (expr) | إرجاع ظل التمام ل expr . |
csc(expr) | ترجع هذه الدالة تمام التمام ل expr . |
عشري (expr) | تحويل القيمة expr إلى DECIMAL . |
الدرجات (expr) | تحويل التقدير الدائري إلى درجات. |
المقسوم على توزيعات الأسهم | إرجاع الجزء المتكامل من تقسيم حسب divisor dividend . |
مزدوج (expr) | تحويل القيمة expr إلى DOUBLE . |
e() | إرجاع الثابت e . |
exp (expr) | إرجاع e إلى قوة expr . |
expm1(expr) | يُرجِع exp(expr) - 1 . |
عامل (expr) | إرجاع عامل .expr |
float(expr) | تحويل القيمة expr إلى FLOAT . |
floor(expr[,targetScale]) | إرجاع أكبر رقم ليس أصغر من expr تقريبه لأسفل إلى targetScale أرقام نسبة إلى الفاصلة العشرية. |
getbit(expr, pos) | إرجاع قيمة قليلا في تمثيل ثنائي لرقم متكامل. |
hypot(expr1, expr2) | يُرجِع sqrt(expr1 * expr1 + expr2 * expr2) . |
int (expr) | تحويل القيمة expr إلى INTEGER . |
isnan (expr) | إرجاع true إذا كان expr هو NaN . |
ln (expr) | إرجاع اللوغاريتم الطبيعي (الأساس e ) ل expr . |
log([base,] expr) | إرجاع اللوغاريتم الخاص ب expr ب base . |
log1p (expr) | يُرجِع log(1 + expr) . |
log2 (expr) | إرجاع لوغاريتم مع expr قاعدة 2 . |
log10(expr) | إرجاع لوغاريتم مع expr قاعدة 10 . |
mod(المقسوم، المقسوم) | إرجاع الباقي بعد dividend / divisor . |
nanvl(expr1, expr2) | إرجاع expr1 إذا لم يكن NaN ، أو expr2 غير ذلك. |
سالب (expr) | إرجاع القيمة النفي ل expr . |
pi() | إرجاع pi. |
pmod(المقسوم، المقسوم) | إرجاع الباقي الموجب بعد dividend / divisor . |
موجب (expr) | إرجاع قيمة expr . |
pow(expr1, expr2) | expr1 يرفع إلى قوة expr2 . |
power(expr1, expr2) | expr1 يرفع إلى قوة expr2 . |
التقدير الدائري (expr) | expr تحويل بالدرجات إلى تقدير دائري. |
rand([seed]) | إرجاع قيمة عشوائية بين 0 و1. |
randn([seed]) | إرجاع قيمة عشوائية من توزيع عادي قياسي. |
عشوائي([seed]) | إرجاع قيمة عشوائية بين 0 و1. |
rint(expr) | إرجاع expr تقريب إلى رقم كامل ك DOUBLE . |
round(expr[,targetScale]) | إرجاع التقريب expr باستخدام HALF_UP وضع التقريب. |
sec(expr) | إرجاع قاطع المنحنى ل expr . |
shiftleft(expr, n) | إرجاع البت الأيسر المتحول بواسطة n البتات. |
shiftright(expr, n) | إرجاع رقم متكامل موقع ب bitwise تم نقله إلى اليمين بواسطة n وحدات البت. |
shiftrightunsigned(expr, n) | ترجع هذه الدالة رقما متكاملا موقعا غير موقع تم نقله إلى اليمين بواسطة n وحدات البت. |
sign(expr) | إرجاع -1.0 أو 0.0 أو 1.0 كما expr هو سالب أو 0 أو موجب. |
signum(expr) | إرجاع -1.0 أو 0.0 أو 1.0 كما expr هو سالب أو 0 أو موجب. |
sin(expr) | إرجاع جيب الزاوية ل expr . |
sinh(expr) | إرجاع جيب الزاوية الزائدي ل expr . |
smallint(expr) | تحويل القيمة expr إلى SMALLINT . |
sqrt(expr) | يرجع الجذر التربيعي لرقم expr . |
tan (expr) | إرجاع ظل الزاوية ل expr . |
tanh(expr) | إرجاع ظل الزاوية الزائدي ل expr . |
tinyint(expr) | تحويل expr إلى TINYINT . |
to_number(expr, fmt ) | إرجاع expr التحويل إلى DECIMAL استخدام التنسيق fmt . |
try_add(expr1, expr2) | إرجاع مجموع expr1 و expr2 أو NULL في حالة حدوث خطأ. |
try_divide(المقسوم عليه، عامل القسمة) | إرجاع dividend مقسوما على divisor ، أو NULL إذا كان divisor هو 0. |
try_mod(المقسوم عليه، عامل القسمة) | إرجاع الباقي بعد dividend / divisor ، أو NULL إذا كان divisor هو 0.. |
try_multiply (مضاعف، مضروب) | إرجاع multiplier مضروب في multiplicand أو NULL عند تجاوز السعة. |
try_subtract(expr1, expr2) | إرجاع طرح من expr2 expr1 أو NULL عند تجاوز السعة. |
try_to_number(expr, fmt ) | إرجاع expr التحويل إلى DECIMAL استخدام التنسيق fmt ، أو NULL إذا expr لم يتطابق مع التنسيق. |
width_bucket(expr, minExpr, maxExpr, numBuckets) | إرجاع رقم المستودع لقيمة في مدرج تكراري بعرض متساوي. |
دالات التجميع
الوظيفة | الوصف |
---|---|
any(expr) | إرجاع true إذا كانت قيمة واحدة على الأقل من expr في المجموعة صحيحة. |
any_value(expr[,ignoreNull]) | إرجاع قيمة expr لمجموعة من الصفوف. |
approx_count_distinct(expr[,relativeSD]) | إرجاع العدد المقدر للقيم المميزة في expr داخل المجموعة. |
approx_percentile(expr,percentage[,accuracy]) | إرجاع القيمة المئوية التقريبية ل expr داخل المجموعة. |
approx_top_k(expr[,k[,maxItemsTracked]]) | إرجاع أعلى k قيم العناصر الأكثر تكرارا expr في جنبا إلى جنب مع أعدادها التقريبية. |
array_agg (expr) | إرجاع صفيف يتكون من كافة القيم داخل expr المجموعة. |
متوسط (expr) | إرجاع المتوسط المحسوب من قيم مجموعة. |
bit_and (expr) | إرجاع البت AND لكافة قيم الإدخال في المجموعة. |
bit_or (expr) | إرجاع البت OR لكافة قيم الإدخال في المجموعة. |
bit_xor (expr) | إرجاع البت XOR لكافة قيم الإدخال في المجموعة. |
bitmap_construct_agg (expr) | إرجاع البت OR لكافة قيم موضع البت في المجموعة. بين 0 و32767 في مجموعة ك BINARY . |
bitmap_or_agg (expr) | إرجاع البت OR لكافة BINARY قيم الإدخال في المجموعة. |
bool_and (expr) | إرجاع true إذا كانت جميع القيم في expr صحيحة داخل المجموعة. |
bool_or (expr) | إرجاع true إذا كانت قيمة واحدة على الأقل في expr صحيحة داخل المجموعة. |
collect_list (expr) | إرجاع صفيف يتكون من كافة القيم داخل expr المجموعة. |
collect_set (expr) | إرجاع صفيف يتكون من كافة القيم الفريدة في expr داخل المجموعة. |
corr(expr1,expr2) | إرجاع معامل Pearson للارتباط بين مجموعة من أزواج الأرقام. |
count(*) | إرجاع العدد الإجمالي للصفوف المستردة في مجموعة، بما في ذلك الصفوف التي تحتوي على قيمة خالية. |
count(expr[, ...]) | إرجاع عدد الصفوف في مجموعة تكون جميع التعبيرات المتوفرة فيها غير خالية. |
count_if (expr) | إرجاع عدد القيم الحقيقية للمجموعة في expr . |
count_min_sketch(column,epsilon,confidence,seed) | إرجاع مخطط عدد أدنى لكافة القيم في المجموعة في column مع epsilon وconfidence .seed |
covar_pop(expr1,expr2) | إرجاع التباين المشترك للمحتوى لأزواج الأرقام في مجموعة. |
covar_samp(expr1,expr2) | إرجاع التباين المشترك النموذجي لأزواج الأرقام في مجموعة. |
كل (expr) | إرجاع true إذا كانت كافة قيم expr في المجموعة صحيحة. |
first(expr[,ignoreNull]) | إرجاع القيمة expr الأولى لمجموعة من الصفوف. |
first_value(expr[,ignoreNull]) | إرجاع القيمة expr الأولى لمجموعة من الصفوف. |
histogram_numeric(expr,numBins) | يحسب مدرجا تكراريا مع expr numBins سلال، مع إرجاع صفيف من الأزواج التي تمثل مراكز الحاوية. |
hll_sketch_agg(expr[,lgConfigK]) | إرجاع رسم تخطيطي HyperLog يستخدم لتقريب عدد القيم المميزة. |
hll_union_agg(expr[,allowDifferentLgConfigK]) | تجميع مخططات HyperLogLog لمجموعة من الصفوف. |
التفرطح (expr) | إرجاع قيمة التفرطح المحسوبة من قيم مجموعة. |
last(expr[,ignoreNull]) | إرجاع القيمة expr الأخيرة لمجموعة الصفوف. |
last_value(expr[,ignoreNull]) | إرجاع القيمة expr الأخيرة لمجموعة الصفوف. |
الحد الأقصى (expr) | إرجاع القيمة القصوى في expr مجموعة. |
max_by(expr1,expr2) | إرجاع قيمة expr1 مقترنة بالقيمة القصوى في expr2 مجموعة. |
mean(expr) | إرجاع المتوسط المحسوب من قيم مجموعة. |
وسيط (expr) | إرجاع الوسيط المحسوب من قيم مجموعة. |
min(expr) | إرجاع الحد الأدنى لقيمة expr في مجموعة. |
min_by(expr1, expr2) | إرجاع قيمة expr1 مقترنة بالحد الأدنى لقيمة expr2 في مجموعة. |
mode(expr [,deterministic]) | إرجاع القيمة expr الأكثر تكرارا، وليس NULL القيمة في مجموعة. |
percentile(expr, percentage [,frequency]) | إرجاع القيمة المئوية الدقيقة في expr percentage المحدد . |
percentile_approx(expr,percentage[,accuracy]) | إرجاع القيمة المئوية التقريبية ل expr داخل المجموعة. |
percentile_cont (pct) ضمن GROUP (ORDER BY key) | إرجاع القيمة المئوية المستوفية للقيمة ضمن key المجموعة. |
percentile_disc (pct) ضمن GROUP (ORDER BY key) | ترجع هذه الدالة النسب المئوية المنفصلة key من داخل المجموعة. |
regr_avgx(yExpr, xExpr) | ترجع هذه الدالة xExpr متوسط المحسوب من قيم مجموعة حيث xExpr وyExpr .NOT NULL |
regr_avgy(yExpr, xExpr) | ترجع هذه الدالة yExpr متوسط المحسوب من قيم مجموعة حيث xExpr وyExpr .NOT NULL |
regr_count(yExpr, xExpr) | إرجاع عدد أزواج القيم غير الفارغة yExpr ، xExpr في المجموعة. |
regr_intercept(yExpr, xExpr) | إرجاع تقاطع خط الانحدار الخطي uni-variate في مجموعة حيث xExpr و yExpr ليست NULL. |
regr_r2(yExpr, xExpr) | إرجاع معامل التحديد من قيم مجموعة حيث xExpr و yExpr ليست NULL. |
regr_slope(yExpr, xExpr) | إرجاع ميل خط الانحدار الخطي لأزواج yExpr القيم غير الخالية ، xExpr في المجموعة. |
regr_sxx(yExpr, xExpr) | إرجاع مجموع مربعات xExpr قيم مجموعة حيث xExpr و yExpr ليست NULL. |
regr_sxy(yExpr, xExpr) | إرجاع مجموع منتجات yExpr وحسابها xExpr من قيم مجموعة حيث xExpr هي NOT NULL وyExpr . |
regr_syy(yExpr, xExpr) | إرجاع مجموع مربعات yExpr قيم مجموعة حيث xExpr و yExpr ليست NULL. |
schema_of_json_agg(json[, options]) | إرجاع المخطط المدمج للسلاسل JSON في مجموعة بتنسيق DDL. |
schema_of_variant_agg (variantExpr) | إرجاع المخطط المدمج لكافة VARIANT القيم في مجموعة بتنسيق DDL. |
انحراف (expr) | إرجاع قيمة الانحراف المحسوبة من قيم مجموعة. |
بعض (expr) | إرجاع القيمة true إذا كانت قيمة واحدة على الأقل في expr مجموعة هي true . |
std (expr) | إرجاع نموذج الانحراف المعياري المحسوب من القيم داخل المجموعة. |
stddev(expr) | إرجاع نموذج الانحراف المعياري المحسوب من القيم داخل المجموعة. |
stddev_pop (expr) | إرجاع الانحراف المعياري للمحتوى المحسوب من قيم مجموعة. |
stddev_samp (expr) | إرجاع نموذج الانحراف المعياري المحسوب من قيم مجموعة. |
sum(expr) | إرجاع المجموع المحسوب من قيم مجموعة. |
try_avg (expr) | إرجاع المتوسط المحسوب من قيم مجموعة، NULL إذا كان هناك تجاوز. |
try_sum (expr) | إرجاع المجموع المحسوب من قيم مجموعة، NULL إذا كان هناك تجاوز. |
var_pop (expr) | إرجاع تباين المحتوى المحسوب من قيم مجموعة. |
var_samp (expr) | إرجاع التباين النموذجي المحسوب من قيم مجموعة. |
التباين (expr) | إرجاع التباين النموذجي المحسوب من قيم مجموعة. |
دالات نافذة تحديد المرتبة
الوظيفة | الوصف |
---|---|
dense_rank() | إرجاع مرتبة قيمة مقارنة بجميع القيم في القسم. |
ntile(n) | يقسم الصفوف لكل قسم نافذة إلى مستودعات n تتراوح من 1 إلى على الأكثر n . |
percent_rank() | يحسب ترتيب النسبة المئوية لقيمة داخل القسم. |
rank() | إرجاع مرتبة قيمة مقارنة بجميع القيم في القسم. |
row_number() | تعيين رقم تسلسلي فريد لكل صف، بدءا من صف واحد، وفقا لترتيب الصفوف داخل قسم النافذة. |
دوال النافذة التحليلية
الوظيفة | الوصف |
---|---|
cume_dist() | إرجاع موضع قيمة نسبة إلى كافة القيم في القسم. |
lag(expr[,offset[,default]]) | إرجاع قيمة من expr صف سابق داخل القسم. |
lead(expr[,offset[,default]]) | إرجاع قيمة من expr صف لاحق داخل القسم. |
nth_value(expr, offset[, ignoreNulls]) | إرجاع قيمة expr في معين offset في النافذة. |
دوال الصفيف
الوظيفة | الوصف |
---|---|
arrayExpr[indexExpr] | إرجاع العنصر في موضع indexExpr ARRAY arrayExpr . |
aggregate(expr,start,merge[,finish]) | تجميع العناصر في صفيف باستخدام مجمع مخصص. |
array([expr [, ...]]) | إرجاع صفيف مع العناصر في expr . |
array_append(array, elem) | إرجاع array إلحاق بواسطة elem . |
array_compact (صفيف) | إزالة القيم NULL من array . |
array_contains(array,value) | إرجاع true إذا كان array يحتوي على value . |
array_distinct (صفيف) | إزالة القيم المكررة من array . |
array_except(array1,array2) | إرجاع صفيف من العناصر في array1 ولكن ليس في array2 . |
array_insert(array, index, elem) | إرجاع موسع array حيث elem يتم إدراج في index الموضع. |
array_intersect(array1,array2) | إرجاع صفيف من العناصر في تقاطع array1 و array2 . |
array_join(array,delimiter[,nullReplacement]) | تسلسل عناصر array . |
array_max (صفيف) | إرجاع القيمة القصوى في array . |
array_min (صفيف) | إرجاع الحد الأدنى للقيمة في array . |
array_position(array,element) | إرجاع موضع أول تكرار ل element في array . |
array_prepend(array, elem) | إرجاع array prependeded بواسطة elem . |
array_remove(array,element) | إزالة كافة تكرارات من element array . |
array_repeat(عنصر,عدد) | إرجاع صفيف يحتوي على element count أوقات. |
array_size (صفيف) | إرجاع عدد العناصر في array . |
array_sort(array,func) | إرجاع array تم فرزها وفقا ل func . |
array_union(array1,array2) | إرجاع صفيف من العناصر في اتحاد array1 و array2 بدون تكرارات. |
arrays_overlap(array1, array2) | إرجاع true إذا كان تقاطع array1 و array2 غير فارغ. |
arrays_zip(array1 [, ...]) | إرجاع صفيف مدمج من البنيات حيث تحتوي البنية nth على كافة قيم Nth من صفائف الإدخال. |
العلاقة الأساسية (expr) | إرجاع حجم expr . |
concat(expr1, expr2 [, ...]) | إرجاع سلسلة الوسيطات. |
element_at(arrayExpr, index) | إرجاع عنصر arrayExpr في index . |
exists(expr, pred) | إرجاع true إذا كان pred صحيحا لأي عنصر في expr . |
تنفجر (مجموعة) | إرجاع الصفوف عن طريق إلغاء التداخل collection . |
explode_outer (مجموعة) | إرجاع الصفوف عن طريق إلغاء التداخل collection باستخدام الدلالات الخارجية. |
filter(expr,func) | تصفية الصفيف باستخدام expr الدالة func . |
flatten(arrayOfArrays) | تحويل صفيف من الصفائف إلى صفيف واحد. |
forall(expr, predFunc) | اختبار ما إذا كان predFunc يحتفظ لكافة العناصر في الصفيف. |
get(arrayExpr, index) | إرجاع عنصر arrayExpr في index ، بدءا من 0 . |
مضمن (expr) | ينفجر صفيف من البنيات في جدول. |
inline_outer (expr) | ينفجر صفيف من البنيات في جدول مع دلالات خارجية. |
posexplode (expr) | إرجاع الصفوف عن طريق إلغاء تداخل الصفيف مع ترقيم المواضع. |
posexplode_outer (expr) | إرجاع الصفوف عن طريق إلغاء تداخل الصفيف مع ترقيم المواضع باستخدام OUTER الدلالات. |
reduce(expr,start,merge[,finish]) | تجميع العناصر في صفيف باستخدام مجمع مخصص. |
عكسي (صفيف) | إرجاع سلسلة معكوسة أو صفيف بترتيب عكسي للعناصر. |
sequence(start,stop,step) | إنشاء صفيف من العناصر من start إلى stop (شامل)، بزيادة بواسطة step . |
تبديل عشوائي (صفيف) | إرجاع تباديل عشوائي للصفيف في expr . |
size(expr) | إرجاع العلاقة الأساسية ل expr . |
slice(expr,start,length) | إرجاع مجموعة فرعية من صفيف. |
sort_array(expr[,ascendingOrder]) | إرجاع الصفيف بترتيب expr تم فرزه. |
transform(expr, func) | تحويل العناصر في صفيف في expr استخدام الدالة func . |
try_element_at(arrayExpr, index) | إرجاع عنصر arrayExpr في index ، أو NULL إذا كان index خارج الحدود. |
zip_with(expr1, expr2, func) | دمج الصفائف في expr1 و expr2 ، من حيث العنصر، في صفيف واحد باستخدام func . |
دالات المخطط
الوظيفة | الوصف |
---|---|
mapExpr[keyExpr] | إرجاع القيمة في keyExpr MAP mapExpr . |
العلاقة الأساسية (expr) | إرجاع حجم expr . |
element_at(mapExpr, key) | إرجاع قيمة mapExpr ل key . |
(expr) | إرجاع الصفوف عن طريق إلغاء التداخل expr . |
explode_outer (expr) | إرجاع الصفوف عن طريق إلغاء التداخل expr باستخدام الدلالات الخارجية. |
map([{key1, value1}[, ...]]) | إنشاء خريطة مع أزواج قيم المفاتيح المحددة. |
map_concat([expr1 [, ...]]) | إرجاع اتحاد كافة expr تعبيرات الخريطة. |
map_contains_key (خريطة، مفتاح) | إرجاع true إذا كان map يحتوي على key ، false وإلا. |
map_entries (خريطة) | إرجاع صفيف غير مرتب من كافة الإدخالات في map . |
map_filter(expr, func) | تصفية الإدخالات في الخريطة باستخدام expr الدالة func . |
map_from_arrays (مفاتيح، قيم) | إنشاء خريطة مع زوج من keys الصفائف و values . |
map_from_entries (expr) | إنشاء خريطة تم إنشاؤها من الصفيف المحدد من الإدخالات. |
map_keys (خريطة) | إرجاع صفيف غير مرتب يحتوي على مفاتيح map . |
map_values (خريطة) | إرجاع صفيف غير مرتب يحتوي على قيم map . |
map_zip_with(map1, map2, func) | دمج و map1 map2 في خريطة واحدة. |
size(expr) | إرجاع العلاقة الأساسية ل expr . |
str_to_map(expr[,pairDelim[,keyValueDelim]]) | إرجاع خريطة بعد التقسيم expr إلى أزواج قيم المفاتيح باستخدام المحددات. |
transform_keys(expr, func) | تحويل المفاتيح في خريطة expr باستخدام الدالة func . |
transform_values(expr, func) | تحويل القيم في خريطة باستخدام expr الدالة func . |
try_element_at(mapExpr, key) | إرجاع قيمة mapExpr ل أو key NULL إذا key لم تكن موجودة. |
دالات التاريخ والطوابع الزمنية والفاصل الزمني
للحصول على معلومات حول تنسيقات التاريخ والطوابع الزمنية، راجع أنماط التاريخ والوقت.
الوظيفة | الوصف |
---|---|
intervalExpr / عامل القسمة | إرجاع الفاصل الزمني مقسوما على divisor . |
- intervalExpr | إرجاع القيمة النفي ل intervalExpr . |
intervalExpr1 - intervalExpr2 | إرجاع طرح من intervalExpr2 intervalExpr1 . |
datetimeExpr1 - datetimeExpr2 | إرجاع طرح من datetimeExpr2 datetimeExpr1 . |
+ intervalExpr | إرجاع قيمة intervalExpr . |
intervalExpr1 + intervalExpr2 | إرجاع مجموع intervalExpr1 و intervalExpr2 . |
intervalExpr * ضرب | إرجاع intervalExpr مضروبا في multiplicand . |
abs (expr) | إرجاع القيمة المطلقة لقيمة الفاصل الزمني في expr . |
add_months(startDate,numMonths) | إرجاع التاريخ الذي يلي numMonths startDate . |
curdate() | إرجاع التاريخ الحالي في بداية تقييم الاستعلام. |
current_date() | إرجاع التاريخ الحالي في بداية تقييم الاستعلام. |
current_timestamp() | إرجاع الطابع الزمني الحالي في بداية تقييم الاستعلام. |
current_timezone() | إرجاع المنطقة الزمنية المحلية لجلسة العمل الحالية. |
التاريخ (expr) | تحويل القيمة expr إلى DATE. |
date_add(startDate,numDays) | إرجاع التاريخ numDays بعد startDate . |
date_add (وحدة، قيمة، expr) | value unit يضيف s إلى طابع expr زمني . |
date_diff (وحدة، بدء، توقف) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب unit s. |
date_format(expr,fmt) | تحويل طابع زمني إلى سلسلة بالتنسيق fmt . |
date_from_unix_date(أيام) | إنشاء تاريخ من عدد الأيام منذ 1970-01-01 . |
date_part(field,expr) | استخراج جزء من التاريخ أو الطابع الزمني أو الفاصل الزمني. |
date_sub(startDate,numDays) | إرجاع التاريخ numDays قبل startDate . |
date_trunc(unit,expr) | إرجاع الطابع الزمني المقتطع إلى الوحدة المحددة في unit . |
dateadd(startDate,numDays) | إرجاع التاريخ numDays بعد startDate . |
dateadd(unit, value, expr) | value unit يضيف s إلى طابع expr زمني . |
datediff(endDate,startDate) | إرجاع عدد الأيام من startDate إلى endDate . |
datediff(unit, start, stop) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب unit s. |
day(expr) | إرجاع يوم الشهر من التاريخ أو الطابع الزمني. |
dayofmonth(expr) | إرجاع يوم الشهر من التاريخ أو الطابع الزمني. |
dayofweek(expr) | إرجاع يوم الأسبوع من التاريخ أو الطابع الزمني. |
dayofyear(expr) | إرجاع يوم السنة من التاريخ أو الطابع الزمني. |
المقسوم على توزيعات الأسهم | إرجاع الجزء المتكامل من تقسيم الفاصل الزمني divisor حسب الفاصل الزمني dividend . |
extract(field FROM source) | إرجاع field .source |
from_unixtime(unixTime,fmt) | إرجاع unixTime في fmt . |
from_utc_timestamp(expr,timezone) | إرجاع طابع زمني محدد في expr UTC في المنطقة الزمنية timeZone . |
getdate() | إرجاع الطابع الزمني الحالي في بداية تقييم الاستعلام. |
ساعة (expr) | إرجاع مكون الساعة للطوابع الزمنية. |
last_day (expr) | إرجاع اليوم الأخير من الشهر الذي ينتمي إليه التاريخ. |
make_date(year,month,day) | إنشاء تاريخ من year حقول month و و day . |
make_dt_interval([days[, hours[, mins[, secs]]]]) | إنشاء فاصل زمني يومي من days و hours mins و.secs |
make_interval (السنوات والأشهر والأسابيع والأيام والساعات والدقائق والثواني) | مهمل: ينشئ فاصلا زمنيا من years و months و hours mins weeks days .secs |
make_timestamp(year,month,day,hour,min,sec[,timezone]) | إنشاء طابع زمني من year min timezone month day hour sec الحقول و. |
make_ym_interval([years[, months]]) | ينشئ فاصلا زمنيا لمدة شهر من years و.months |
دقيقة (expr) | إرجاع مكون الدقيقة للطوابع الزمنية في expr . |
month(expr) | إرجاع مكون الشهر للطوابع الزمنية في expr . |
months_between(expr1,expr2[,roundOff]) | إرجاع عدد الأشهر المنقضية بين التواريخ أو الطوابع الزمنية في expr1 و expr2 . |
next_day(expr,dayOfWeek) | إرجاع التاريخ الأول الذي يقع بعد expr و المسمى كما في dayOfWeek . |
now() | إرجاع الطابع الزمني الحالي في بداية تقييم الاستعلام. |
ربع السنة (expr) | إرجاع ربع السنة ل expr في النطاق من 1 إلى 4. |
الثانية (expr) | إرجاع المكون الثاني من الطابع الزمني في expr . |
session_window(expr, gpDuration) | إنشاء نافذة جلسة عمل عبر تعبير الطابع الزمني. |
sign(expr) | إرجاع -1.0 أو 0.0 أو 1.0 كفاصل زمني سالب expr أو 0 أو موجب. |
signum(expr) | إرجاع -1.0 أو 0.0 أو 1.0 كفاصل زمني سالب expr أو 0 أو موجب. |
timediff(unit, start, stop) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب unit s. |
الطابع الزمني (expr) | تحويل expr إلى TIMESTAMP . |
timestamp_micros (expr) | إنشاء ميكرو ثانية الطابع expr الزمني منذ فترة التوقيت العالمي المتفق عليه. |
timestamp_millis (expr) | ينشئ طابعا expr زمنيا بالمللي ثانية منذ فترة التوقيت العالمي المتفق عليه. |
timestamp_seconds (expr) | إنشاء ثوان الطابع expr الزمني منذ فترة التوقيت العالمي المتفق عليه. |
timestampadd(unit, value, expr) | value unit يضيف s إلى طابع expr زمني . |
timestampdiff(unit, start, stop) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب unit s. |
to_date(expr[,fmt]) | إرجاع expr التحويل إلى تاريخ باستخدام تنسيق اختياري. |
to_timestamp(expr[,fmt]) | إرجاع expr التحويل إلى طابع زمني باستخدام تنسيق اختياري. |
to_unix_timestamp(expr[,fmt]) | إرجاع الطابع الزمني في expr كطوابع زمنية UNIX. |
to_utc_timestamp(expr,timezone) | إرجاع الطابع الزمني في expr منطقة زمنية مختلفة ك UTC. |
trunc(expr, fmt) | إرجاع تاريخ مع جزء من التاريخ المقتطع إلى الوحدة المحددة بواسطة نموذج fmt التنسيق . |
try_add(expr1, expr2) | إرجاع مجموع expr1 و expr2 أو NULL في حالة حدوث خطأ. |
try_divide(المقسوم عليه، عامل القسمة) | إرجاع dividend مقسوما على divisor ، أو NULL إذا كان divisor هو 0. |
try_multiply (مضاعف، مضروب) | إرجاع multiplier مضروب في multiplicand أو NULL عند تجاوز السعة. |
try_subtract(expr1, expr2) | إرجاع طرح من expr2 expr1 أو NULL عند تجاوز السعة. |
try_to_timestamp(expr[,fmt]) | إرجاع expr التحويل إلى طابع زمني باستخدام تنسيق اختياري، أو NULL إذا فشل الإرسال. |
unix_date (expr) | إرجاع عدد الأيام منذ 1970-01-01 . |
unix_micros (expr) | إرجاع عدد ميكرو ثانية منذ 1970-01-01 00:00:00 UTC . |
unix_millis (expr) | ترجع هذه الدالة عدد المللي ثانية منذ 1970-01-01 00:00:00 UTC . |
unix_seconds (expr) | ترجع هذه الدالة عدد الثوان منذ 1970-01-01 00:00:00 UTC . |
unix_timestamp([expr[, fmt]]) | يقلب الطابع الزمني UNIX للوقت الحالي أو المحدد. |
weekday (expr) | إرجاع يوم الأسبوع من expr . |
weekofyear(expr) | إرجاع أسبوع السنة من expr . |
year(expr) | إرجاع مكون السنة ل expr . |
window(expr, width[, step[, start]]) | إنشاء نافذة منزلقة مستندة إلى القفز عبر تعبير طابع زمني. |
window_time (نافذة) | إرجاع وقت الانتهاء الشامل لنافذة منزلقة تنتجها النافذة أو وظائف session_window . |
الدالات الجغرافية المكانية H3
للحصول على معلومات حول الدالات الجغرافية المكانية H3، راجع الدالات الجغرافية المكانية H3.
دالات التحويل والمنشئات
للحصول على معلومات حول التحويل بين الأنواع، راجع الدالة cast ودالة try_cast.
الوظيفة | الوصف |
---|---|
array([expr [, ...]]) | إرجاع صفيف مع العناصر في expr . |
bigint (expr) | تحويل القيمة expr إلى BIGINT . |
ثنائي (expr) | تحويل قيمة expr إلى BINARY . |
منطقي (expr) | تحويل expr إلى BOOLEAN . |
cast(expr AS type) | تحويل القيمة expr إلى نوع type البيانات الهدف . |
expr :: اكتب | تحويل القيمة expr إلى نوع type البيانات الهدف . |
التاريخ (expr) | تحويل القيمة expr إلى DATE . |
عشري (expr) | تحويل القيمة expr إلى DECIMAL . |
مزدوج (expr) | تحويل القيمة expr إلى DOUBLE . |
float(expr) | تحويل القيمة expr إلى FLOAT . |
int (expr) | تحويل القيمة expr إلى INTEGER . |
make_date(year,month,day) | إنشاء تاريخ من year حقول month و و day . |
make_dt_interval([days[, hours[, mins[, secs]]]]) | إنشاء فاصل زمني يومي من days و hours mins و.secs |
make_interval (السنوات والأشهر والأسابيع والأيام والساعات والدقائق والثواني) | إنشاء فاصل زمني من years و weeks months و mins days hours .secs |
make_timestamp(year,month,day,hour,min,sec[,timezone]) | إنشاء طابع زمني من year min timezone month day hour sec الحقول و. |
make_ym_interval([years[, months]]) | ينشئ فاصلا زمنيا لمدة شهر من years و.months |
map([{key1, value1} [, ...]]) | إنشاء خريطة مع أزواج قيم المفاتيح المحددة. |
named_struct({name1, val1} [, ...]) | إنشاء بنية بأسماء الحقول والقيم المحددة. |
smallint(expr) | تحويل القيمة expr إلى SMALLINT . |
سلسلة (expr) | تحويل القيمة expr إلى STRING . |
struct(expr1 [, ...]) | STRUCT إنشاء بقيم الحقول المحددة. |
tinyint(expr) | تحويل expr إلى TINYINT . |
الطابع الزمني (expr) | تحويل expr إلى TIMESTAMP . |
to_char(expr, fmt) | إرجاع expr التحويل إلى STRING استخدام التنسيق fmt ." |
to_date(expr[,fmt]) | إرجاع expr التحويل إلى تاريخ باستخدام تنسيق اختياري. |
to_number(expr, fmt) | إرجاع expr التحويل إلى DECIMA L باستخدام التنسيق fmt . |
to_timestamp(expr[,fmt]) | إرجاع expr التحويل إلى طابع زمني باستخدام تنسيق اختياري. |
to_varchar(expr, fmt) | إرجاع expr التحويل إلى STRING استخدام التنسيق fmt ." |
try_cast (expr AS type) | تحويل القيمة expr إلى نوع type البيانات الهدف بأمان. |
try_to_number(expr, fmt) | إرجاع expr التحويل إلى DECIMAL استخدام التنسيق fmt ، أو NULL إذا expr لم يكن صالحا. |
دوال CSV
الوظيفة | الوصف |
---|---|
from_csv(csvStr, schema[, options]) | إرجاع قيمة بنية مع csvStr و schema . |
schema_of_csv(csv[, options]) | إرجاع مخطط سلسلة CSV بتنسيق DDL. |
to_csv(expr[, options]) | إرجاع سلسلة CSV بقيمة البنية المحددة. |
وظائف JSON
الوظيفة | الوصف |
---|---|
jsonStr : jsonPath | إرجاع الحقول المستخرجة jsonStr من . |
from_json(jsonStr, schema[, options]) | إرجاع قيمة بنية مع jsonStr و schema . |
get_json_object(expr, path) | استخراج كائن JSON من path . |
json_array_length (jsonArray) | إرجاع عدد العناصر في الصفيف الخارجي JSON . |
json_object_keys (jsonObject) | إرجاع كافة مفاتيح الكائن الخارجي JSON كصفيف. |
json_tuple(jsonStr, path1 [, ...]) | إرجاع كائنات متعددة JSON كمجموعة. |
parse_json (jsonStr) | VARIANT إرجاع قيمة من jsonStr . |
schema_of_json(jsonStr[, options]) | إرجاع مخطط سلسلة JSON بتنسيق DDL. |
schema_of_json_agg(jsonStr[, options]) | إرجاع المخطط المدمج للسلاسل JSON في مجموعة بتنسيق DDL. |
to_json(expr[, options]) | إرجاع سلسلة JSON مع STRUCT أو VARIANT المحددة في expr . |
الدالات VARIANT
الوظيفة | الوصف |
---|---|
variantExpr : jsonPath | إرجاع الحقول المستخرجة variantExpr من مسار JSON باستخدام . |
is_variant_null (variantExpr) | يختبر ما إذا كان variantExpr VARIANT مرمزا - أم لا NULL . |
parse_json (jsonStr) | VARIANT إرجاع قيمة من jsonStr . |
schema_of_variant (variantExpr) | إرجاع مخطط تعبير VARIANT بتنسيق DDL. |
schema_of_variant_agg (variantExpr) | إرجاع المخطط المدمج لكافة VARIANT القيم في مجموعة بتنسيق DDL. |
to_json(expr[, options]) | إرجاع سلسلة JSON مع STRUCT أو VARIANT المحددة في expr . |
try_parse_json (jsonStr) | VARIANT إرجاع قيمة من jsonStr إذا كان ذلك ممكنا. إذا لم يكن ذلك ممكنا، NULL يتم إرجاع. |
try_variant_get(variantExpr,path,type) | استخراج قيمة من type نوع من variantExpr ، محددة بواسطة path ، أو NULL إذا لم يكن من الممكن تحويلها إلى النوع الهدف. |
variant_explode(variantExpr) | إرجاع مجموعة من الصفوف عن طريق إلغاء التداخل variantExpr . |
variant_explode_outer (variantExpr) | إرجاع مجموعة من الصفوف عن طريق إلغاء التداخل variantExpr باستخدام الدلالات الخارجية. |
variant_get(variantExpr,path,type) | استخراج قيمة من type نوع من variantExpr ، محددة بواسطة path . |
دالات XPath وXML
الوظيفة | الوصف |
---|---|
from_xml(xmlStr, schema[, options]) | إرجاع قيمة بنية تم تحليلها من xmlStr باستخدام schema . |
schema_of_xml(xmlStr[, options]) | إرجاع مخطط سلسلة XML بتنسيق DDL. |
xpath(xml, xpath) | إرجاع القيم داخل عقد تلك المطابقة xml xpath . |
xpath_boolean(xml, xpath) | إرجاع true إذا تم xpath تقييم التعبير إلى true ، أو إذا تم العثور على عقدة مطابقة في xml . |
xpath_double(xml, xpath) | DOUBLE إرجاع قيمة من مستند XML. |
xpath_float(xml, xpath) | FLOAT إرجاع قيمة من مستند XML. |
xpath_int(xml, xpath) | INTEGER إرجاع قيمة من مستند XML. |
xpath_long(xml, xpath) | BIGINT إرجاع قيمة من مستند XML. |
xpath_number(xml, xpath) | DOUBLE إرجاع قيمة من مستند XML. |
xpath_short(xml, xpath) | SHORT إرجاع قيمة من مستند XML. |
xpath_string(xml, xpath) | إرجاع محتويات عقدة XML الأولى التي تطابق تعبير XPath. |
الذكاء الاصطناعي الدالات
الوظيفة | الوصف |
---|---|
ai_analyze_sentiment (محتوى) | إرجاع توجه النص. |
ai_classify (المحتوى والتسميات) | تصنيف المحتوى المقدم في إحدى التسميات المتوفرة. |
ai_extract (المحتوى والتسميات) | استخراج الكيانات المحددة بواسطة التسميات من نص معين. |
ai_fix_grammar (محتوى) | تصحيح الأخطاء النحوية في نص معين. |
ai_forecast (لوحظ، time_col) | اكستروبولاتس بيانات السلاسل الزمنية في المستقبل. |
ai_gen (محتوى) | استدعاء نموذج الذكاء الاصطناعي إنشاءي حديث من واجهات برمجة تطبيقات نموذج Databricks Foundation للرد على المطالبة التي يوفرها المستخدم. |
ai_generate_text(prompt, modelName[, param1, value1] [...]) | مهمل: إرجاع النص الذي تم إنشاؤه بواسطة نموذج لغة كبير محدد (LLM) نظرا إلى المطالبة. |
ai_mask (محتوى، تسميات) | إخفاء الكيانات المحددة داخل نص معين. |
ai_query(endpointName, request, returnType) | استدعاء الفسيفساء الموجودة الذكاء الاصطناعي نقطة نهاية خدمة النموذج وتحليلها وإرجاع استجابتها. |
ai_similarity(strExpr1, strExpr2) | يقارن بين سلسلتين ويحسب درجة التشابه الدلالي. |
ai_summarize(content[, max_words]) | إنشاء ملخص لنص معين. |
ai_translate (محتوى، to_lang) | ترجمة النص إلى لغة هدف محددة. |
vector_search (فهرس، استعلام، num_results) | الاستعلام عن فهرس بحث متجهات الذكاء الاصطناعي الفسيفساء باستخدام SQL. |
قراءة الدوال
الوظيفة | الوصف |
---|---|
read_files(path, [optionKey => optionValue] [, ...]) | يقرأ ملفات البيانات على التخزين السحابي ويعيدها بتنسيق جدولي. |
read_kafka([optionKey => optionValue] [, ...]) | قراءة السجلات من مجموعة Apache Kafka وإرجاعها بتنسيق جدولي. |
read_kinesis({parameter => value} [, ...]) | إرجاع جدول يحتوي على سجلات مقروءة من Kinesis من دفق واحد أو أكثر. |
read_pubsub([معلمة => قيمة] [, ...]) | دالة ذات قيمة جدول لقراءة السجلات من Pub/Sub من موضوع. |
read_pulsar({optionKey => optionValue} [, ...]) | إرجاع جدول مع قراءة السجلات من Pulsar. |
read_state_metadata (مسار) | إرجاع جدول يحتوي على صفوف تمثل بيانات التعريف لحالة استعلام الدفق. |
read_statestore(path [, option_key => option_value] [...]) | إرجاع سجلات من مخزن الحالة للاستعلامات المتدفقة. |
دالات متنوعة
الوظيفة | الوصف |
---|---|
assert_true (expr) | إرجاع خطأ إذا expr لم يكن صحيحا. |
CASE expr { WHEN opt1 THEN res1 } [...] [ELSE def] انتهاء | إرجاع resN للأول optN الذي يساوي expr أو def إذا لم يتطابق أي منها. |
CASE { WHEN cond1 THEN res1 } [...] [ELSE def] انتهاء | إرجاع resN للأوائل condN التي يتم تقييمها إلى true، أو def إذا لم يتم العثور على أي منها. |
cloud_files_state( { TABLE(table) | checkpoint } ) | إرجاع حالة مستوى الملف لمصدر التحميل cloud_files التلقائي. |
الاندماج(expr1, expr2 [, ...]) | إرجاع الوسيطة الأولى غير الخالية. |
cube (expr1 [, ...]) | إنشاء مكعب متعدد الأبعاد باستخدام أعمدة التعبير المحددة. |
current_catalog() | إرجاع الكتالوج الحالي. |
current_database() | إرجاع المخطط الحالي. |
current_metastore() | إرجاع معرف Metastore الحالي كتالوج Unity. |
current_recipient (مفتاح) | إرجاع خاصية للمستلم الحالي في طريقة عرض مشتركة مع "مشاركة دلتا". |
current_schema() | إرجاع المخطط الحالي. |
current_user() | إرجاع المستخدم الذي يقوم بتنفيذ العبارة. |
current_version() | إرجاع الإصدار الحالي من Azure Databricks. |
decode(expr, { key, value } [, ...] [,defValue]) | إرجاع القيمة المطابقة للمفتاح. |
elt(index, expr1 [, ...] ) | إرجاع التعبير nth. |
equal_null(expr1, expr2) | إرجاع true إذا كان expr1 يساوي التعبيرين expr2 أو كليهما هما NULL ، أو false غير ذلك. |
event_log( { TABLE(table) | pipeline_id } ) | إرجاع جدول لمحفوظات التحديث لعرض مجسد أو جدول دفق أو مسار DLT. |
greatest(expr1, expr2 [, ...]) | ترجع هذه الدالة أكبر قيمة لكافة الوسيطات، مع تخطي القيم الخالية. |
تجميع (عمود) | يشير إلى ما إذا كان عمود محدد في GROUPING SET أو ROLLUP أو CUBE يمثل إجماليا فرعيا. |
grouping_id([col1 [, ...]]) | إرجاع مستوى التجميع لمجموعة من الأعمدة. |
hash(expr1 [, ...]) | إرجاع قيمة متجزئة للوسيطات. |
hll_sketch_estimate (expr) | تقدير عدد القيم المميزة التي تم جمعها في مخطط HyperLogLog. |
hll_union(expr1, expr2 [,allowDifferentLgConfigK]) | يجمع بين مخططين HyperLogLog. |
java_method(class, method[, arg1 [, ...]]) | استدعاء أسلوب مع انعكاس. |
if(cond, expr1, expr2) | إرجاع expr1 إذا كان cond ، true أو expr2 غير ذلك. |
iff(cond, expr1, expr2) | إرجاع expr1 إذا كان cond ، true أو expr2 غير ذلك. |
ifnull(expr1, expr2) | إرجاع expr2 إذا كان expr1 ، NULL أو expr1 غير ذلك. |
input_file_block_length() | إرجاع الطول بالبايت للكتلة التي تتم قراءتها. |
input_file_block_start() | إرجاع إزاحة البدء بالبايت للكتلة التي تتم قراءتها. |
input_file_name() | إرجاع اسم الملف الذي تتم قراءته أو السلسلة الفارغة إذا لم يكن متوفرا. |
is_account_group_member (مجموعة) | إرجاع القيمة true إذا كان المستخدم الحالي عضوا في مجموعة على مستوى الحساب. |
is_member (مجموعة) | إرجاع true إذا كان المستخدم الحالي عضوا في مجموعة على مستوى مساحة العمل. |
isnull(expr) | إرجاع true إذا كان expr هو NULL . |
isnotnull(expr) | إرجاع true إذا expr لم يكن NULL . |
least(expr1, expr2 [, ...]) | ترجع هذه الدالة أصغر قيمة لكافة الوسيطات، مع تخطي القيم الخالية. |
list_secrets([scopeStr]) | إرجاع المفاتيح في كل أو نطاق واحد الذي تم تخويل المستخدم رؤيته من خدمة Databricks السرية. |
luhn_check (numStr) | إرجاع true إذا numStr مرر فحص خوارزمية Luhn. |
monotonically_increasing_id() | إرجاع الأعداد الصحيحة 64 بت المتزايدة بشكل رتيبة. |
nullif(expr1, expr2) | إرجاع NULL إذا كان expr1 يساوي expr2 ، أو expr1 غير ذلك. |
nvl(expr1, expr2) | إرجاع expr2 إذا كان expr1 ، NULL أو expr1 غير ذلك. |
nvl2(expr1, expr2, expr3) | إرجاع expr2 إذا expr1 لم يكن NULL ، أو expr3 غير ذلك. |
raise_error (expr) | يطرح استثناء مع expr كرسالة. |
range(end) | إرجاع جدول قيم ضمن نطاق محدد. |
range(start, end [, step [, numParts]]) | إرجاع جدول قيم ضمن نطاق محدد. |
reflect(class, method[, arg1 [, ...]]) | استدعاء أسلوب مع انعكاس. |
secret(scope, key) | استخراج قيمة سرية مع معين scope ومن key خدمة Databricks السرية. |
session_user() | إرجاع المستخدم المتصل ب Azure Databricks. |
spark_partition_id() | إرجاع معرف القسم الحالي. |
sql_keywords() | إرجاع مجموعة كلمات SQL الأساسية في Azure Databricks. |
stack(numRows, expr1 [, ...]) | يفصل expr1 ، ...، exprN إلى numRows صفوف. |
table_changes(table_str, start [, end]) | إرجاع سجل التغييرات إلى جدول Delta Lake مع تمكين Change Data Feed. |
try_reflect(class, method[, arg1 [, ...]]) | استدعاء أسلوب مع انعكاس، مع NULL إرجاع إذا فشل الأسلوب. |
try_secret (نطاق، مفتاح) | استخراج قيمة سرية مع معين scope ومن key خدمة Databricks السرية، أو NULL إذا تعذر استرداد المفتاح. |
typeof(expr) | إرجاع سلسلة نوع بتنسيق DDL لنوع expr بيانات . |
المستخدم() | إرجاع المستخدم الذي يقوم بتنفيذ العبارة. |
uuid() | إرجاع سلسلة معرف فريد عالميا (UUID). |
window(expr, width[, step [, start]]) | إنشاء نافذة منزلقة مستندة إلى القفز عبر تعبير طابع زمني. |
xxhash64(expr1 [, ...]) | إرجاع قيمة متجزئة 64 بت للوسيطات. |
version() | إرجاع إصدار Apache Spark. |