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

ينطبق على: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. مثل ^ عامل التشغيل.

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

• قائمة بجميع الوظائف المجمعة.
• قائمة بجميع دالات الصفيف.
• قائمة بجميع وظائف البحث المخزنة مؤقتًا.
• قائمة بجميع دوال التحويل.
• قائمة بجميع دالات التاريخ والوقت.
• قائمة بجميع وظائف الخريطة.
• قائمة بجميع وظائف ميتا.
• قائمة بجميع وظائف النافذة.
• تفاصيل الاستخدام لجميع تعبيرات تحويل البيانات.
• تعرف على كيفية استخدام منشئ التعبير.