مشاركة عبر

دوال التعبير في تدفقات البيانات المخصصة

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

تتوفر تدفقات البيانات في كل من مسارات Azure Data Factory ومسارات Azure Synapse Analytics. تنطبق هذه المقالة على تعيين تدفقات البيانات. إذا كنت جديدا في مجال التحويلات، فراجع المقالة التمهيدية تحويل البيانات باستخدام تعيين تدفقات البيانات.

توفر هذه المقالة تفاصيل حول دوال التعبير المدعومة من قبل Azure Data Factory وAzure Synapse Analytics في تعيين تدفقات البيانات.

قائمة دالات التعبير

في خطوط أنابيب Azure Data Factory وAzure Synapse Analytics، استخدم لغة التعبير الخاصة بميزة تدفق البيانات لتكوين تحويلات البيانات.

دالة التعبير مهمة
abs تعطي القيمة المطلقة لرقم.
acos حساب قيمة معكوسة جيب التمام.
add إضافة زوج من السلاسل أو الأرقام. إضافة تاريخ إلى عدد من الأيام. تضيف مدة إلى الطابع الزمني. إلحاق صفيف واحد من نوع مشابه إلى آخر. مثل عامل التشغيل +.
و يستخدم المؤثر المنطقي AND . نفس الشيء مثل &&.
asin حساب قيمة معكوسة جيب الزاوية.
assertErrorMessages يعيد خريطة لجميع رسائل التأكيد.
atan تحسب قيمة المماس المعكوسة.
atan2 إرجاع الزاوية بالتقدير الدائري بين المحور السيني الموجب لمستوى والنقطة المعطاة بالإحداثيات.
between التحقق مما إذا كانت القيمة الأولى تقع بين قيمتين أخريين بشكلٍ شامل. يمكنك مقارنة القيم الرقمية، والسلاسل النصية، والقيم datetime .
bitwiseAnd يستخدم عامل البت And عبر أنواع التكامل. مثل عامل التشغيل &.
bitwiseOr يستخدم عامل البت Or عبر أنواع التكامل. مثل عامل التشغيل |.
bitwiseXor يستخدم عامل البت Or عبر أنواع التكامل. مثل عامل التشغيل |.
blake2b يحسب ملخص Blake2 لمجموعة من الأعمدة ذات أنواع بيانات بدائية مختلفة عند إعطاؤها طول بت. يمكن أن يكون طول البت هو مضاعفات 8 فقط بين 8 و512. يمكنك استخدامه لحساب بصمة الإصبع لصف.
blake2bBinary يحسب ملخص Blake2 لمجموعة من الأعمدة ذات أنواع بيانات بدائية مختلفة عند إعطاء طول بت، والذي لا يمكن أن يكون إلا مضاعفات 8 بين 8 و512. يمكنك استخدامه لحساب بصمة الإصبع لصف.
case يطبق قيمة واحدة أو الأخرى بناء على شروط متناوبة. إذا كان عدد المدخلات زوجيا، يتم وضع الآخر افتراضيا NULL للشرط الأخير.
cbrt حساب الجذر التكعيبي لرقم.
ceil إرجاع أصغر عدد صحيح وليس أصغر من الرقم.
coalesce إرجاع القيمة الأولى غير الفارغة من مجموعة إدخالات. يجب أن تكون جميع الإدخالات من نفس النوع.
columnNames الحصول على أسماء جميع أعمدة الإخراج الخاصة بالتدفق. يمكنك تمرير اسم تدفق اختياري كوجيدة أولى ووسيطة ثانية اختيارية لإرجاع أعمدة انحراف المخطط فقط.
columns الحصول على قيم جميع أعمدة الإخراج الخاصة بالتدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية.
compare مقارنة قيمتين من نفس النوع. يرجع عددا صحيحا سالبا إذا كانت القيمة1 < قيمت2 أو 0 إذا كانت القيمة 1 == قيمت2، ويعيد قيمة موجبة إذا كانت القيمة1 > قيمت2.
concat ربط عدد متغير من السلاسل معاً. نفس العامل + الذي يستخدم سلاسل نصية.
concatWS ربط عدد متغير من السلاسل مع فاصل. المعلمة الأولى هي الفاصل.
cos حساب قيمة جيب التمام.
cosh حساب جيب الزاوية الزائدي لقيمة.
crc32 يحسب تجزئة CRC32 لمجموعة من الأعمدة ذات أنواع بيانات بدائية مختلفة عند إعطاؤها طول بت. يجب أن يكون طول البت من قيم 0 (256), 224, 256, 384, و 512. يمكنك استخدامه لحساب بصمة الإصبع لصف.
degrees تحويل التقدير الدائري إلى درجات.
divide يقسم زوجا من الأعداد. مثل عامل التشغيل /.
dropLeft يزيل أكبر عدد من الأحرف المحددة من يسار السلسلة. إذا تجاوز الإفلات المطلوب طول السلسلة، يتم إرجاع سلسلة فارغة.
dropRight تزيل أكبر عدد من الأحرف المحددة من يمين السلسلة. إذا تجاوز الإفلات المطلوب طول السلسلة، يتم إرجاع سلسلة فارغة.
endsWith التحقق مما إذا كانت السلسلة تنتهي بالسلسلة المرفقة.
equals يستخدم مؤثر المقارنة (iso). مثل عامل التشغيل ==.
equalsIgnoreCase يستخدم المقارنة تساوي عامل ويتجاهل الحالة. مثل عامل التشغيل <=>.
escape تخطي سلسلة وفقاً لتنسيق. القيم الحرفية للتنسيق المقبول هي json، xml، ، htmlecmascript، و java.
expr ينتج عنه تعبير من سلسلة. يعادل كتابة التعبير بشكل غير حرفي. يمكنك استخدامه لتمرير المعاملات كتمثيلات نصية.
factorial حساب مضروب الرقم.
false إرجاع قيمة خاطئة دائماً. استخدم الدالة syntax(false()) إذا كان هناك عمود يسمى false.
floor إرجاع أكبر عدد صحيح لا يزيد عن الرقم.
fromBase64 فك تشفير السلسلة المشفرة بنظام base64 المحدد.
greater يستخدم المقارنة الأكبر من المؤثر. مثل عامل التشغيل >.
greaterOrEqual يستخدم المقارنة التي تتجاوز أو تساوي المؤثر. مثل عامل التشغيل >=.
greatest إرجاع القيمة الأكبر بين قائمة القيم كمدخلات تتخطى القيم الخالية. إرجاع null إذا كانت جميع الإدخالات فارغة.
hasColumn التحقق من قيمة عمود حسب الاسم في التدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. يجب معالجة أسماء الأعمدة المعروفة في وقت التصميم باستخدام اسمها فقط. المدخلات المحوسبة غير مدعومة، لكن يمكنك استخدام استبدالات المعلمات.
hasError يتحقق مما إذا كان الادعاء مع المعرف المقدم مصنفا كخطأ.
iif يطبق قيمة واحدة أو الأخرى بناء على شرط. إذا لم يكن الآخر محددا، تعتبر NULLالقيمة . يجب أن تكون القيمتان متوافقتين (على سبيل المثال، رقمية أو نصية).
iifNull يعيد أول عنصر غير فارغ عند إعطاؤه مدخلين أو أكثر. هذه الدالة مكافئة ل coalesce.
initCap تحويل الحرف الأول من كل كلمة إلى أحرف كبيرة. يتم تحديد الكلمات على أنها مفصولة بمسافة بيضاء.
instr يحدد الموقع (1 مبنا) للسلسلة الفرعية داخل السلسلة. إذا لم يتم العثور عليه، 0 يتم إرجاعه.
isDelete التحقق مما إذا كان الصف محدداً للحذف. بالنسبة للتحويلات التي تتطلب أكثر من تدفق إدخال، يمكنك تمرير مؤشر (1) للتدفق. يجب أن يكون مؤشر التيار إما 1 أو 2، والقيمة الافتراضية هي 1.
isError التحقق مما إذا تم تحديد الصف على أنه خطأ. بالنسبة للتحويلات التي تتطلب أكثر من تدفق إدخال، يمكنك تمرير مؤشر (1) للتدفق. يجب أن يكون مؤشر التيار إما 1 أو 2. القيمة الافتراضية هي 1.
isIgnore يتحقق مما إذا كان يجب تجاهل الصف. بالنسبة للتحويلات التي تتطلب أكثر من تدفق إدخال، يمكنك تمرير مؤشر (1) للتدفق. يجب أن يكون مؤشر التيار إما 1 أو 2. القيمة الافتراضية هي 1.
isInsert التحقق مما إذا كان الصف محدداً للإدراج. بالنسبة للتحويلات التي تتطلب أكثر من تدفق إدخال، يمكنك تمرير مؤشر (1) للتدفق. يجب أن يكون مؤشر التيار إما 1 أو 2. القيمة الافتراضية هي 1.
isMatch التحقق مما إذا كان الصف متطابقاً عند البحث. بالنسبة للتحويلات التي تتطلب أكثر من تدفق إدخال، يمكنك تمرير مؤشر (1) للتدفق. يجب أن يكون مؤشر التيار إما 1 أو 2. القيمة الافتراضية هي 1.
isNull يتحقق مما إذا كانت القيمة هي NULL.
isUpdate التحقق مما إذا كان الصف محدداً للتحديث. بالنسبة للتحويلات التي تتطلب أكثر من تدفق إدخال، يمكنك تمرير مؤشر (1) للتدفق. يجب أن يكون مؤشر التيار إما 1 أو 2. القيمة الافتراضية هي 1.
isUpsert التحقق مما إذا كان الصف محدداً للإدراج. بالنسبة للتحويلات التي تتطلب أكثر من تدفق إدخال، يمكنك تمرير مؤشر (1) للتدفق. يجب أن يكون مؤشر التيار إما 1 أو 2. القيمة الافتراضية هي 1.
jaroWinkler الحصول على مسافة JaroWinkler بين سلسلتين.
least يستخدم المقارنة الأقل من أو المساواة للمؤثر. مثل عامل التشغيل <=.
left يستخرج سلسلة فرعية تبدأ عند الفهرس 1 بعدد الحروف. نفس الشيء مثل SUBSTRING(str, 1, n).
الطول إرجاع طول السلسلة.
lesser يستخدم عامل المقارنة الأقل (par less). مثل عامل التشغيل <.
lesserOrEqual يستخدم المقارنة الأقل من أو المساواة للمؤثر. مثل عامل التشغيل <=.
levenshtein الحصول على مسافة levenshtein بين سلسلتين.
like يستخدم نمطا بخيط متطابق حرفيا. الاستثناء هو الرمز _ الخاص الذي يطابق أي حرف في الإدخال (مشابه ل .* في posix التعبيرات النمطية).
locate يحدد الموضع (1 مبنا) للوتر الفرعي داخل سلسلة تبدأ من موضع معين. إذا تم حذف الوضعية، ابدأ من بداية الوتر. إذا لم يتم العثور عليه، 0 يتم إرجاعه.
log يحسب قيمة اللوغاريتم. يمكنك توفير قاعدة اختيارية أو رقم أويلر إذا استخدمت.
log10 يحسب قيمة اللوغاريتمية بناء على قاعدة 10.
lower تصغير حروف السلسلة.
lpad الوسادة اليسرى تضع الوتر بجانب الحشوة المرفقة حتى يصل إلى طول معين. إذا كان الوتر مساويا أو أكبر من الطول، يتم قص الخيط حسب الطول.
ltrim تقليص من جهة اليسار لسلسلة من الأحرف البادئة. إذا لم يكن المعامل الثاني محددا، فإنه يقص الفراغ الأبيض. وإلا، فإنه يقص أي حرف محدد في المعامل الثاني.
md5 يحسب ملخص MD5 لمجموعة من الأعمدة بأنواع بيانات بدائية مختلفة ويعيد سلسلة سداسية مكونة من 32 حرفا. يمكنك استخدامه لحساب بصمة الإصبع لصف.
minus طرح الأرقام. يطرح عدد الأيام من التاريخ. يطرح المدة من الطابع الزمني. يطرح طابعين زمنيين للحصول على الفرق بالملي ثانية. مثل عامل التشغيل -.
mod يعطي معامل زوج من الأعداد. مثل عامل التشغيل %.
multiply يضرب زوجا من الأعداد. مثل عامل التشغيل *.
negate نفي رقماً. تحويل الأرقام الموجبة إلى سلبية والعكس صحيح.
nextSequence إرجاع التسلسل الفريد التالي. الرقم متتالي فقط داخل القسم ويبدأ بمعرف القسم.
normalize يقوم بتطبيع قيمة السلسلة النصية إلى أحرف يونيكود المميزة بشكل منفصل.
not يستخدم عامل النفي المنطقي.
notEquals يستخدم مؤثرة المقارنة التي لا تساوي المعامل. مثل عامل التشغيل !=.
قيمة فارغة يعيد قيمة NULL . استخدم الدالة syntax(null()) إذا كان هناك عمود يسمى null. أي عملية تستخدمه تؤدي إلى .NULL
أو يستخدم المؤثر المنطقي OR . نفس الشيء مثل ||.
pMod يعطي معامل موجب لزوج من الأعداد.
partitionId يرجع معرف القسم الحالي الذي يوجد فيه صف الإدخال.
power رفع رقم واحد إلى قوة آخر.
radians يحول الدرجات إلى راديان.
random يرجع رقما عشوائيا عند إعطاؤه بذرة اختيارية داخل قسم. يجب أن تكون البذرة قيمة ثابتة وتستخدم مع معرف القسم لإنتاج قيم عشوائية.
regexExtract يستخرج سلسلة فرعية مطابقة لنمط regex محدد. المعامل الأخير يحدد مجموعة المطابقة ويتحول افتراضيا إلى 1 إذا تم حذفها. تستخدم `<regex>` لمطابقة وتر دون أن يفلت منه.
regexMatch يتحقق مما إذا كانت السلسلة تطابق نمط الريجيكس المحدد. تستخدم `<regex>` لمطابقة وتر دون أن يفلت منه.
regexReplace يستبدل جميع حالات نمط الريجيكس بسلسلة فرعية أخرى في السلسلة المحددة. تستخدم `<regex>` لمطابقة وتر دون أن يفلت منه.
regexSplit تقسيم سلسلة بناءً على محدد استناداً إلى regex وإرجاع صفيف سلاسل.
replace يستبدل جميع حالات سلسلة فرعية بسلسلة فرعية أخرى في السلسلة المحددة. إذا تم حذف المعامل الأخير، فإنه يتحول افتراضيا إلى سلسلة فارغة.
reverse عكس السلسلة.
right يستخرج سلسلة فرعية بعدد الأحرف من اليمين. نفس الشيء مثل SUBSTRING(str, LENGTH(str) - n, n).
rlike يتحقق مما إذا كانت السلسلة تطابق نمط الريجيكس المحدد.
round يقرب رقما عند إعطاؤه مقياس اختياري ووضع تقريب اختياري. إذا تم حذف المقياس، يتحول الوضع الافتراضي إلى 0. إذا تم حذف الوضع، فإنه يتحول افتراضيا إلى ROUND_HALF_UP(5).
rpad يمتد الوتر الأيمن بجانب الحشوة المرفقة حتى يصل إلى طول معين. إذا كان الوتر مساويا أو أكبر من الطول، يتم قص الخيط حسب الطول.
rtrim تقليص من جهة اليسار لسلسلة من الأحرف اللاحقة. إذا لم يكن المعامل الثاني محددا، فإنه يقص الفراغ الأبيض. وإلا، فإنه يقص أي حرف محدد في المعامل الثاني.
sha1 يحسب ملخص SHA-1 لمجموعة من الأعمدة ذات أنواع بيانات بدائية مختلفة ويعيد سلسلة سداسية مكونة من 40 حرفا. يمكنك استخدامه لحساب بصمة الإصبع لصف.
sha2 يحسب ملخص SHA-2 لمجموعة من الأعمدة ذات أنواع بيانات أولية مختلفة عند إعطاء طول بت، والذي لا يمكن أن يكون إلا من قيم 0 (256)، 224، 256، 384، و 512. يمكنك استخدامه لحساب بصمة الإصبع لصف.
sin حساب قيمة الجيب.
sinh حساب جيب الزاوية الزائدي.
soundex الحصول على التعليمة البرمجية soundex للسلسلة.
split تقسيم سلسلة بناءً على محدد وإرجاع مصفوفة من السلاسل.
sqrt تحسب الجذر التربيعي لرقم.
startsWith التحقق مما إذا كانت السلسلة تبدأ بالسلسلة المرفقة.
substring استخراج سلسلة فرعية بطول معين من موضع. الموضع هو مستند إلى 1. إذا تم حذف الطول، فإنه يتحول افتراضيا إلى نهاية السلسلة.
substringIndex استخراج السلسلة الفرعية قبل حالات count للمحدد. إذا كان count إيجابيًا، يتم إرجاع كل شيء إلى يسار المحدد النهائي (العد من اليسار). إذا كان count سلبيًا، يتم إرجاع كل شيء على يمين المحدد النهائي (العد من اليمين).
tan حساب قيمة ظل الزاوية.
tanh حساب قيمة ظل الزاوية الزائدي.
translate يستبدل مجموعة من الأحرف بمجموعة أخرى من الأحرف في السلسلة. الشخصيات لها بديل واحد لواحد.
trim تقليص سلسلة من الأحرف البادئة واللاحقة. إذا لم يكن المعامل الثاني محددا، فإنه يقص الفراغ الأبيض. وإلا، فإنه يقص أي حرف محدد في المعامل الثاني.
true إرجاع قيمة حقيقية دوماً. استخدم الدالة syntax(true()) إذا كان العمود يسمى true.
typeMatch مطابقة نوع العمود. يستخدم فقط في تعبيرات النمط. الأرقام تطابق القصير، الصحيح، الطويل، المزدوج، العائم، أو العشري. التكامل يطابق بين القصير والصحيح والطويل. الكسر يطابق بين المزدوج والعائم والعشري. التاريخ يتطابق مع نوع التاريخ أو الطابع الزمني.
unescape عدم إلغاء سلسلة وفقاً لتنسيق. القيم الحرفية للتنسيق المقبول هي json، xml، ، htmlecmascript، و java.
upper تكبير أحرف سلسلة.
uuid إرجاع UUID الذي تم إنشاؤه.
xor يعطي المؤثر المنطقي XOR . مثل عامل التشغيل ^.

المحتوى ذو الصلة

  • Last updated on