الدوال المدمجة
ينطبق على:
Databricks SQL Databricks Runtime
تقدم هذه المقالة ارتباطات إلى أوصاف عوامل التشغيل والدالات المضمنة للسلاسل والأنواع الثنائية، والتحجيمات الرقمية، والتجميعات، والنوافذ، والصفائف، والخرائط، والتواريخ والطوابع الزمنية، والصب، وبيانات CSV، وبيانات JSON، ومعالجتها، والدالات المتنوعة الأخرى.
انظر أيضا:
عوامل التشغيل والمسندات
للحصول على معلومات حول كيفية تحليل عوامل التشغيل فيما يتعلق ببعضها البعض، راجع أسبقية عامل التشغيل.
| عامل تشغيل | بناء الجملة | الوصف |
|---|---|---|
| و | expr1 & expr2 |
إرجاع البت و من 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البيانات الهدف . |
| div | divisor div dividend |
إرجاع الجزء المتكامل من تقسيم حسب divisordividend. |
| . | 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 |
يختبر ما إذا كانت الوسيطات (لا) لها قيم مختلفة حيث تعتبر NULLs قيما قابلة للمقارنة. |
| خطأ | 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 إذا كان كلاهما ، NULLfalse إذا كان أحدهما هو NULL. |
| <= | expr1 <= expr2 |
إرجاع true إذا كان expr1 أقل من أو يساوي expr2، أو false غير ذلك. |
| <> | expr1 <> expr2 |
إرجاع true إذا expr1 لم يساوي expr2، أو false غير ذلك. |
| < | expr1 < expr2 |
إرجاع true إذا كان expr1 أقل من expr2، أو false غير ذلك. |
| - | expr1 - expr2 |
إرجاع طرح من expr2expr1. |
| not | not expr |
إرجاع المنطقي NOT لتعبير منطقي. |
| أو | expr1 or expr2 |
ترجع هذه الدالة المنطقية OR ل expr1 و expr2. |
| % | dividend % divisor |
إرجاع الباقي بعد dividend / divisor. |
| || | expr1 || expr2 |
إرجاع سلسلة و expr1expr2. |
| | | 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 | إرجاع سلسلة و expr1expr2. |
| 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) لأول تكرار في substrstr. |
| 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]) | يستبدل كافة السلاسل الفرعية لتلك المطابقة strregexp ب rep. |
| regexp_substr(str, regexp) | إرجاع السلسلة الفرعية الأولى في str التي تطابق regexp. |
| repeat(expr, n) | إرجاع السلسلة التي تكرر exprn الأوقات. |
| replace(str, search [, replace]) | يستبدل كافة تكرارات ب searchreplace. |
| عكسي (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 التحويل إلى BINARY استنادا fmtإلى ، أو NULL إذا كان الإدخال غير صالح. |
| ucase(expr) | إرجاع expr مع تغيير كافة الأحرف إلى أحرف كبيرة. |
| unbase64(expr) | إرجاع سلسلة base64 تم فك ترميزها كسلسلة ثنائية. |
| unhex(expr) | تحويل سداسي عشري expr إلى ثنائي. |
| upper(expr) | إرجاع expr مع تغيير كافة الأحرف إلى أحرف كبيرة. |
| url_decode (سلسلة) | ترجمة سلسلة مرة أخرى من تنسيق application/x-www-form-urlencoded . |
| url_encode (سلسلة) | يترجم سلسلة إلى تنسيق application/x-www-form-urlencoded . |
دالات رقمية رقمية
| الوظيفة | الوصف |
|---|---|
| ~Expr | إرجاع البت NOT ل expr. |
| توزيع الأرباح / عامل القسمة | إرجاع dividend مقسوما على divisor. |
| expr1 | expr2 | إرجاع البت OR من expr1 و expr2. |
| -Expr | إرجاع القيمة النفي ل expr. |
| expr1 - expr2 | إرجاع طرح من expr2expr1. |
| + expr | إرجاع قيمة expr. |
| expr1 + expr2 | إرجاع مجموع expr1 و expr2. |
| المقسوم على نسبة الأرباح | إرجاع الباقي بعد dividend / divisor. |
| expr1 ^ expr2 | إرجاع البت الخاص OR (XOR) ب expr1 و expr2. |
| expr1 وexpr2 | إرجاع البت و من 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) | تحويل التقدير الدائري إلى درجات. |
| المقسوم على توزيعات الأسهم | إرجاع الجزء المتكامل من تقسيم حسب divisordividend. |
| مزدوج (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. |
| sin(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 أو موجب. |
| 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_multiply (مضاعف، مضروب) | إرجاع multiplier مضروب في multiplicandأو NULL عند تجاوز السعة. |
| try_subtract(expr1, expr2) | إرجاع طرح من expr2expr1أو 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 الأولى لمجموعة من الصفوف. |
| 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]) | إرجاع القيمة المئوية الدقيقة في exprpercentageالمحدد . |
| 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 ليست NULL. |
| regr_avgy(yExpr, xExpr) | ترجع هذه الدالة yExpr متوسط المحسوب من قيم مجموعة حيث xExpr و yExpr ليست 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 و yExpr ليست NULL. |
| regr_syy(yExpr, xExpr) | إرجاع مجموع مربعات yExpr قيم مجموعة حيث xExpr و yExpr ليست NULL. |
| schema_of_json_agg(json[, options]) | إرجاع المخطط المدمج للسلاسل JSON في مجموعة بتنسيق 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) | إزالة كافة تكرارات من elementarray. |
| array_repeat(عنصر,عدد) | إرجاع صفيف يحتوي على elementcount أوقات. |
| 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) | دمج و map1map2 في خريطة واحدة. |
| 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 ل أو keyNULL إذا key لم تكن موجودة. |
دالات التاريخ والطوابع الزمنية والفاصل الزمني
للحصول على معلومات حول تنسيقات التاريخ والطوابع الزمنية، راجع أنماط التاريخ والوقت.
| الوظيفة | الوصف |
|---|---|
| intervalExpr / عامل القسمة | إرجاع الفاصل الزمني مقسوما على divisor. |
| - intervalExpr | إرجاع القيمة النفي ل intervalExpr. |
| intervalExpr1 - intervalExpr2 | إرجاع طرح من intervalExpr2intervalExpr1. |
| datetimeExpr1 - datetimeExpr2 | إرجاع طرح من datetimeExpr2datetimeExpr1. |
| + intervalExpr | إرجاع قيمة intervalExpr. |
| intervalExpr1 + intervalExpr2 | إرجاع مجموع intervalExpr1 و intervalExpr2. |
| intervalExpr * ضرب | إرجاع intervalExpr مضروبا في multiplicand. |
| abs (expr) | إرجاع القيمة المطلقة لقيمة الفاصل الزمني في expr. |
| add_months(startDate,numMonths) | إرجاع التاريخ الذي يلي numMonthsstartDate. |
| curdate() | إرجاع التاريخ الحالي في بداية تقييم الاستعلام. |
| current_date() | إرجاع التاريخ الحالي في بداية تقييم الاستعلام. |
| current_timestamp() | إرجاع الطابع الزمني الحالي في بداية تقييم الاستعلام. |
| current_timezone() | إرجاع المنطقة الزمنية المحلية لجلسة العمل الحالية. |
| التاريخ (expr) | تحويل القيمة expr إلى DATE. |
| date_add(startDate,numDays) | إرجاع التاريخ numDays بعد startDate. |
| date_add (وحدة، قيمة، expr) | valueunitيضيف s إلى طابع exprزمني . |
| date_diff (وحدة، بدء، توقف) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب units. |
| 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) | valueunitيضيف s إلى طابع exprزمني . |
| datediff(endDate,startDate) | إرجاع عدد الأيام من startDate إلى endDate. |
| datediff(unit, start, stop) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب units. |
| 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و hoursmins و.secs |
| make_interval (السنوات والأشهر والأسابيع والأيام والساعات والدقائق والثواني) | مهمل: ينشئ فاصلا زمنيا من yearsو monthsو hoursminsweeksdays.secs |
| make_timestamp(year,month,day,hour,min,sec[,timezone]) | إنشاء طابع زمني من yearmintimezonemonthdayhoursecالحقول و. |
| 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) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب units. |
| الطابع الزمني (expr) | تحويل expr إلى TIMESTAMP. |
| timestamp_micros (expr) | إنشاء ميكرو ثانية الطابع expr الزمني منذ فترة التوقيت العالمي المتفق عليه. |
| timestamp_millis (expr) | ينشئ طابعا expr زمنيا بالمللي ثانية منذ فترة التوقيت العالمي المتفق عليه. |
| timestamp_seconds (expr) | إنشاء ثوان الطابع expr الزمني منذ فترة التوقيت العالمي المتفق عليه. |
| timestampadd(unit, value, expr) | valueunitيضيف s إلى طابع exprزمني . |
| timestampdiff(unit, start, stop) | ترجع الفرق بين طابعين زمنيين تم قياسهما ب units. |
| 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) | إرجاع طرح من expr2expr1أو 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و hoursmins و.secs |
| make_interval (السنوات والأشهر والأسابيع والأيام والساعات والدقائق والثواني) | إنشاء فاصل زمني من yearsو weeksmonthsو minsdayshours.secs |
| make_timestamp(year,month,day,hour,min,sec[,timezone]) | إنشاء طابع زمني من yearmintimezonemonthdayhoursecالحقول و. |
| 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 التحويل إلى DECIMAL باستخدام التنسيق 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 كمجموعة. |
| schema_of_json(jsonStr[, options]) | إرجاع مخطط سلسلة JSON بتنسيق DDL. |
| schema_of_json_agg(jsonStr[, options]) | إرجاع المخطط المدمج للسلاسل JSON في مجموعة بتنسيق DDL. |
| to_json(expr[, options]) | إرجاع سلسلة JSON مع البنية المحددة في expr. |
دالات XPath وXML
| الوظيفة | الوصف |
|---|---|
| from_xml(xmlStr, schema[, options]) | إرجاع قيمة بنية تم تحليلها من xmlStr باستخدام schema. |
| schema_of_xml(xmlStr[, options]) | إرجاع مخطط سلسلة XML بتنسيق DDL. |
| xpath(xml, xpath) | إرجاع القيم داخل عقد تلك المطابقة xmlxpath. |
| 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_gen (محتوى) | استدعاء نموذج الذكاء الاصطناعي إنشاءي حديث من واجهات برمجة تطبيقات نموذج Databricks Foundation للرد على المطالبة التي يوفرها المستخدم. |
| ai_generate_text(prompt, modelName[, param1, value1] [...]) | مهمل: إرجاع النص الذي تم إنشاؤه بواسطة نموذج لغة كبير محدد (LLM) نظرا إلى المطالبة. |
| ai_mask (محتوى، تسميات) | إخفاء الكيانات المحددة داخل نص معين. |
| ai_query(endpointName, request, returnType) | استدعاء نقطة نهاية خدمة نموذج Databricks موجودة وتحليلها وإرجاع استجابتها. |
| ai_similarity(strExpr1, strExpr2) | يقارن بين سلسلتين ويحسب درجة التشابه الدلالي. |
| ai_summarize(content[, max_words]) | إنشاء ملخص لنص معين. |
| ai_translate (محتوى، to_lang) | ترجمة النص إلى لغة هدف محددة. |
قراءة الدوال
| الوظيفة | الوصف |
|---|---|
| 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 } ) | |
| الاندماج(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 } ) | |
| 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() | إرجاع المفاتيح التي تم تفويض المستخدم لرؤيتها من خدمة 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 إرجاع إذا فشل الأسلوب. |
| typeof(expr) | إرجاع سلسلة نوع بتنسيق DDL لنوع exprبيانات . |
| المستخدم() | إرجاع المستخدم الذي يقوم بتنفيذ العبارة. |
| uuid() | إرجاع سلسلة معرف فريد عالميا (UUID). |
| window(expr, width[, step [, start]]) | إنشاء نافذة منزلقة مستندة إلى القفز عبر تعبير طابع زمني. |
| xxhash64(expr1 [, ...]) | إرجاع قيمة متجزئة 64 بت للوسيطات. |
| version() | إرجاع إصدار Apache Spark. |