دالات التعبير في تعيين تدفق البيانات

  • مقالة
  • قراءة خلال 10 دقائق

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

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

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

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

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

دالة التعبير المهمة
abs القيمة المطلقة للعدد.
acos حساب قيمة معكوسة جيب التمام.
add إضافة زوج من السلاسل أو الأرقام. إضافة تاريخ إلى عدد من الأيام. إضافة مدة إلى طابع زمني. إلحاق صفيف واحد من نوع مشابه إلى آخر. مثل + عامل التشغيل.
و عامل التشغيل المنطقي AND. مثله كـ ⁧&&⁩.
asin حساب قيمة معكوسة جيب الزاوية.
رسائل تأكيد الأخطاء إرجاع خريطة لكافة رسائل التأكيد.
atan حساب قيمة ظل معكوس.
atan2 إرجاع الزاوية بالتقدير الدائري بين المحور السيني الموجب لمستوى والنقطة المعطاة بالإحداثيات.
between التحقق مما إذا كانت القيمة الأولى تقع بين قيمتين أخريين بشكلٍ شامل. إمكانية مقارنة القيم الرقمية والسلسلة والتاريخ والوقت
bitwiseAnd معالجة البت وعامل التشغيل عبر أنواع متكاملة. مثل & عامل التشغيل.
bitwiseOr معالجة البت أو عامل التشغيل عبر أنواع متكاملة. مثل | المشغل.
bitwiseXor معالجة البت أو عامل التشغيل عبر أنواع متكاملة. مثل | المشغل.
blake2b حساب ملخص Blake2 لمجموعة من الأعمدة من أنواع البيانات الأولية المختلفة نظرا لطول البت. يمكن أن يكون طول البت فقط مضاعفات 8 بين 8 و512. يمكن استخدامه لحساب بصمة صف.
blake2bBinary حساب ملخص Blake2 لمجموعة من الأعمدة من أنواع البيانات الأولية المختلفة نظرا لطول البت، والتي يمكن أن تكون فقط مضاعفات من 8 بين 8 & 512. يمكن استخدامه لحساب بصمة صف
case بناءً على الشروط المتناوبة، يتم تطبيق قيمة واحدة أو أخرى. إذا كان عدد المدخلات زوجياً، فسيتم تعيين الآخر افتراضياً على NULL للشرط الأخير.
cbrt حساب الجذر التكعيبي لرقم.
ceil إرجاع أصغر عدد صحيح وليس أصغر من الرقم.
coalesce إرجاع القيمة الأولى غير الفارغة من مجموعة إدخالات. يجب أن تكون جميع الإدخالات من نفس النوع.
columnNames الحصول على أسماء جميع أعمدة الإخراج الخاصة بالتدفق. يمكنك تمرير اسم دفق اختياري كوسيطة أولى ووسيطة ثانية اختيارية لإرجاع أعمدة انحراف المخطط فقط.
columns الحصول على قيم جميع أعمدة الإخراج الخاصة بالتدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية.
compare مقارنة قيمتين من نفس النوع. إرجاع عدد صحيح سالب إذا كانت value1 < value2، 0 if value1 == value2، قيمة موجبة إذا كانت value1 > value2.
concat ربط عدد متغير من السلاسل معاً. نفس عامل التشغيل + مع السلاسل.
concatWS ربط عدد متغير من السلاسل مع فاصل. المعلمة الأولى هي الفاصل.
cos حساب قيمة جيب التمام.
cosh حساب جيب الزاوية الزائدي لقيمة.
crc32 حساب تجزئة CRC32 لمجموعة من الأعمدة من أنواع البيانات الأولية المختلفة نظرا لطول البت. يجب أن يكون طول البت من القيم 0 (256) أو 224 أو 256 أو 384 أو 512. يمكن استخدامه لحساب بصمة صف.
degrees تحويل التقدير الدائري إلى درجات.
divide تقسيم زوج من الأرقام. مثل عامل التشغيل /.
dropLeft إزالة العديد من الأحرف من يسار السلسلة. إذا تجاوز الإفلات المطلوب طول السلسلة، يتم إرجاع سلسلة فارغة.
dropRight إزالة العديد من الأحرف من يمين السلسلة. إذا تجاوز الإفلات المطلوب طول السلسلة، يتم إرجاع سلسلة فارغة.
endsWith التحقق مما إذا كانت السلسلة تنتهي بالسلسلة المرفقة.
equals المقارنة تساوي عامل التشغيل. مثل == عامل التشغيل.
equalsIgnoreCase المقارنة تساوي عامل التشغيل، مع تجاهل الحالة. <مثل => عامل التشغيل.
escape تخطي سلسلة وفقاً لتنسيق. القيم الحرفية للتنسيق المقبول هي "json" و"xml" و"ecmascript" و"html" و"java".
expr ينتج عن ذلك تعبير من سلسلة. وهو ما يعادل كتابة التعبير في نموذج غير حرفي ويمكن استخدامه لتمرير المعلمات كتمثيلات سلسلة.
factorial حساب مضروب الرقم.
false إرجاع قيمة خاطئة دائماً. استخدم الدالة syntax(false()) إذا كان هناك عمود يسمى "false".
floor إرجاع أكبر عدد صحيح لا يزيد عن الرقم.
fromBase64 فك تشفير السلسلة المعطاة بترميز base64.
greater مقارنة عامل تشغيل الأكبر. مثل > عامل التشغيل.
greaterOrEqual مقارنة أكبر من أو يساوي عامل التشغيل. >مثل = عامل التشغيل.
greatest إرجاع القيمة الأكبر بين قائمة القيم كمدخلات تتخطى القيم الخالية. إرجاع null إذا كانت جميع الإدخالات فارغة.
hasColumn التحقق من قيمة عمود حسب الاسم في التدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. يجب تناول أسماء الأعمدة المعروفة في وقت التصميم بالاسم فقط. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام استبدال المعلمات.
hasError التحقق من وضع علامة خطأ على التأكيد مع المعرف المتوفر.
iif بناءً على شرط يتم تطبيق قيمة أو أخرى. إذا كان الآخر غير محدد، فإنه يعتبر NULL. يجب أن تكون كلتا القيمتين متوافقة (رقمية، سلسلة...).
iifNull نظرا لإدخالين أو أكثر، ترجع العنصر الأول وليس الفارغ. هذه الدالة مكافئة للدمج.
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 التحقق مما إذا كانت القيمة فارغة.
isUpdate التحقق مما إذا كان الصف محدداً للتحديث. بالنسبة للتحويلات التي تأخذ أكثر من دفق إدخال واحد، يمكنك تمرير فهرس الدفق (المستند إلى 1). يجب أن يكون مؤشر التدفق إما 1 أو 2 والقيمة الافتراضية هي 1.
isUpsert التحقق مما إذا كان الصف محدداً للإدراج. بالنسبة للتحويلات التي تأخذ أكثر من دفق إدخال واحد، يمكنك تمرير فهرس الدفق (المستند إلى 1). يجب أن يكون مؤشر التدفق إما 1 أو 2 والقيمة الافتراضية هي 1.
jaroWinkler الحصول على مسافة JaroWinkler بين سلسلتين.
least مقارنة أكبر من أو يساوي عامل التشغيل. <مثل = عامل التشغيل.
left استخراج سلسلة فرعية تبدأ في الفهرس 1 بعدد الأحرف. مثل BSTRING(str, 1, n).
الطول إرجاع طول السلسلة.
lesser مقارنة عامل تشغيل أقل. مثل < عامل التشغيل.
lesserOrEqual مقارنة أكبر من أو يساوي عامل التشغيل. <مثل = عامل التشغيل.
levenshtein الحصول على مسافة levenshtein بين سلسلتين.
like النمط عبارة عن سلسلة تتم مطابقتها حرفياً. الاستثناءات هي الرموز الخاصة التالية: _ تطابق أي حرف واحد في الإدخال (على غرار. في posix التعبيرات العادية)
locate البحث عن موضع (مستند إلى 1) من السلسلة الفرعية داخل سلسلة تبدأ موضعاً معيناً. إذا تم حذف الموضع، يتم اعتباره من بداية السلسلة. يتم إرجاع 0 إذا لم يتم العثور عليه.
log حساب قيمة السجل. يمكن توفير قاعدة اختيارية أخرى رقم Euler إذا تم استخدامه.
log10 حساب قيمة السجل استناداً إلى القاعدة 10.
lower تصغير حروف السلسلة.
lpad تعبئة السلسلة من جهة اليسار من خلال ترك مساحة متوفرة حتى تصبح بطول معين. إذا كانت السلسلة مساوية للطول أو أكبر منه، فسيتم اقتطاعها إلى الطول.
ltrim تقليص من جهة اليسار لسلسلة من الأحرف البادئة. إذا كانت المعلمة الثانية غير محددة، فإنها تقلص المسافة البيضاء. وإلا فإنه يقلص أي حرف محدد في المعلمة الثانية.
md5 حساب ملخص MD5 لمجموعة من الأعمدة من أنواع البيانات الأولية المختلفة وإرجاع سلسلة سداسية عشرية مكونة من 32 حرفا. يمكن استخدامه لحساب بصمة صف.
minus طرح الأرقام. طرح عدد الأيام من تاريخ. طرح المدة من طابع زمني. طرح اثنين من الطوابع الزمنية للحصول على الفرق بالملّي ثانية. مثل - عامل التشغيل.
mod معامل زوج الأعداد. مثل % عامل التشغيل.
multiply ضرب زوج من الأعداد. مثل عامل التشغيل *.
negate نفي رقماً. تحويل الأرقام الموجبة إلى سلبية والعكس صحيح.
nextSequence إرجاع التسلسل الفريد التالي. يكون الرقم متتالياً فقط داخل القسم ويسبقه رقم القسم.
normalize تطبيع قيمة السلسلة لفصل أحرف unicode المعلمة.
not عامل النفي المنطقي.
notEquals المقارنة لا تساوي عامل التشغيل. مثل != عامل التشغيل.
notNull التحقق من أن القيمة ليست NULL.
null إرجاع قيمة فارغة. استخدم الدالة syntax(null()) إذا كان هناك عمود يسمى 'null'. أي عملية يتم استخدامها سينتج عنها NULL.
أو عامل التشغيل المنطقي OR. مثل ||.
pMod معامل إيجابي لزوج من الأرقام.
partitionId إرجاع معرف القسم الحالي الذي يوجد به صف الإدخال.
power رفع رقم واحد إلى قوة آخر.
radians تحويل الدرجات إلى تقدير دائري
random إرجاع رقم عشوائي بمنحه قيمة اختيارية داخل أحد الأقسام. يجب أن تكون القيمة الأولية قيمة ثابتة ويتم استخدامها مع partitionId لإنتاج قيم عشوائية
regexExtract استخراج سلسلة فرعية مطابقة لنمط regex محدد. تحدد المعلمة الأخيرة مجموعة المطابقة وتكون افتراضياً على 1 إذا تم حذفها. استخدم `<regex>` (عرض أسعار للخلف) لمطابقة سلسلة دون الهروب.
regexMatch التحقق مما إذا كانت السلسلة تطابق نمط regex المحدد. استخدم `<regex>` (عرض أسعار للخلف) لمطابقة سلسلة دون الهروب.
regexReplace استبدل كافة تكرارات نمط regex بسلسلة فرعية أخرى في السلسلة المحددة استخدام `<regex>` (عرض أسعار للخلف) لمطابقة سلسلة دون الهروب.
regexSplit تقسيم سلسلة بناءً على محدد استناداً إلى regex وإرجاع صفيف سلاسل.
replace استبدال جميع تكرارات سلسلة فرعية مع سلسلة فرعية أخرى في السلسلة المحددة. إذا تم حذف المعلمة الأخيرة، فمن الافتراضي أن يتم إفراغ السلسلة.
reverse عكس السلسلة.
right استخراج سلسلة فرعية مع عدد من الأحرف من اليمين. مثل SUBSTRING(str, LENGTH(str) - n, n).
rlike التحقق مما إذا كانت السلسلة تطابق نمط regex المحدد.
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. إذا تم حذف الطول، فسيتم تعيينه افتراضيا إلى نهاية السلسلة.
tan حساب قيمة ظل الزاوية.
tanh حساب قيمة ظل الزاوية الزائدي.
translate استبدل مجموعة واحدة من الأحرف بمجموعة أخرى من الأحرف في السلسلة. استبدال الأحرف 1 إلى 1.
trim تقليص سلسلة من الأحرف البادئة واللاحقة. إذا كانت المعلمة الثانية غير محددة، فإنها تقلص المسافة البيضاء. وإلا فإنه يقلص أي حرف محدد في المعلمة الثانية.
صواب إرجاع قيمة حقيقية دوماً. استخدم الدالة syntax(true()) إذا كان هناك عمود يسمى 'true'.
typeMatch مطابقة نوع العمود. يمكن استخدامه فقط في نمط expressions.number الذي يتطابق مع القيم القصيرة، والعدد الصحيح، والقيم الطويلة، والمزدوجة، والمعوم أو العشري الذي يتطابق مع القيم القصيرة، والعدد الصحيح، والقيم الطويلة، والكسور التي تتطابق مع القيم المزدوجة، والمعوم، والقيم العشرية وتحدد مدى مطابقة نوع التاريخ أو الطابع الزمني.
unescape عدم إلغاء سلسلة وفقاً لتنسيق. القيم الحرفية للتنسيق المقبول هي "json" و"xml" و"ecmascript" و"html" و"java".
upper تكبير أحرف سلسلة.
uuid إرجاع UUID الذي تم إنشاؤه.
xor عامل التشغيل المنطقي XOR. مثل ^ عامل التشغيل.

الخطوات التالية