مشاركة عبر

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

  • مقالة

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

تلميح

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

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

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

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

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

دالة التعبير مهمة
abs القيمة المطلقة للعدد.
acos حساب قيمة معكوسة جيب التمام.
add إضافة زوج من السلاسل أو الأرقام. إضافة تاريخ إلى عدد من الأيام. إضافة مدة إلى طابع زمني. إلحاق صفيف واحد من نوع مشابه إلى آخر. مثل + عامل التشغيل.
و عامل التشغيل المنطقي AND. مثل &&.
asin حساب قيمة معكوسة جيب الزاوية.
assertErrorMessages إرجاع خريطة لجميع رسائل التأكيد.
atan تحسب قيمة المماس المعكوسة.
atan2 إرجاع الزاوية بالتقدير الدائري بين المحور السيني الموجب لمستوى والنقطة المعطاة بالإحداثيات.
between التحقق مما إذا كانت القيمة الأولى تقع بين قيمتين أخريين بشكلٍ شامل. إمكانية مقارنة القيم الرقمية والسلسلة والتاريخ والوقت
bitwiseAnd معالجة البت وعامل التشغيل عبر أنواع متكاملة. مثل عامل التشغيل.
bitwiseOr معالجة البت أو عامل التشغيل عبر أنواع متكاملة. مثل | المشغل أو العامل.
bitwiseXor معالجة البت أو عامل التشغيل عبر أنواع متكاملة. مثل | المشغل أو العامل.
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 المقارنة تساوي عامل التشغيل. مثل == عامل التشغيل.
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 المقارنة لا تساوي عامل التشغيل. مثل != عامل التشغيل.
قيمة فارغة إرجاع قيمة فارغة. استخدم الدالة 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. إذا تم حذف الطول، فسيتم تعيينه افتراضياً في نهاية السلسلة.
substringIndex استخراج السلسلة الفرعية قبل حالات count للمحدد. إذا كان count إيجابيًا، يتم إرجاع كل شيء إلى يسار المحدد النهائي (العد من اليسار). إذا كان count سلبيًا، يتم إرجاع كل شيء على يمين المحدد النهائي (العد من اليمين).
tan حساب قيمة ظل الزاوية.
tanh حساب قيمة ظل الزاوية الزائدي.
translate استبدل مجموعة واحدة من الأحرف بمجموعة أخرى من الأحرف في السلسلة. استبدال الأحرف 1 إلى 1.
trim تقليص سلسلة من الأحرف البادئة واللاحقة. إذا كانت المعلمة الثانية غير محددة، فإنها تقلص المسافة البيضاء. وإلا فإنه يقلص أي حرف محدد في المعلمة الثانية.
true إرجاع قيمة حقيقية دوماً. استخدم الدالة syntax(true()) إذا كان هناك عمود يسمى 'true'.
typeMatch مطابقة نوع العمود. يمكن استخدامه فقط في نمط expressions.number الذي يتطابق مع القيم القصيرة، والعدد الصحيح، والقيم الطويلة، والمزدوجة، والمعوم أو العشري الذي يتطابق مع القيم القصيرة، والعدد الصحيح، والقيم الطويلة، والكسور التي تتطابق مع القيم المزدوجة، والمعوم، والقيم العشرية وتحدد مدى مطابقة نوع التاريخ أو الطابع الزمني.
unescape عدم إلغاء سلسلة وفقاً لتنسيق. القيم الحرفية للتنسيق المقبول هي "json" و"xml" و"ecmascript" و"html" و"java".
upper تكبير أحرف سلسلة.
uuid إرجاع UUID الذي تم إنشاؤه.
xor عامل التشغيل المنطقي XOR. مثل ^ عامل التشغيل.

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