دالات ميتا في تعيين تدفق البيانات
ينطبق على: 
Azure Data Factory Azure Synapse Analytics
تلميح
جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!
تتوفر تدفقات البيانات في كل من Azure Data Factory وخطوط أنابيب Azure Synapse. تنطبق هذه المقالة على تعيين تدفقات البيانات. إذا كنت جديداً في مجال التحويلات، فيرجى الرجوع إلى المقالة التمهيدية تحويل البيانات باستخدام تدفق بيانات التعيين.
توفر هذه المقالة تفاصيل حول دالات ميتا التي يدعمها Azure Data Factory وAzure Synapse Analytics في تدفقات بيانات التعيين.
قائمة دالات ميتا
تعمل دالات ميتا بشكلٍ أساسي على بيانات التعريف في تدفق البيانات
| دالة ميتا | مهمة |
|---|---|
| byItem | ابحث عن عنصر فرعي داخل بنية أو مجموعة بنى. إذا كان هناك العديد من حالات التطابق، يتم إرجاع التطابق الأول. إذا لم يكن هناك تطابق، فيتم إرجاع قيمة NULL. يجب تحويل القيمة التي تم إرجاعها بواسطة أحد أنواع تحويل actions(? date, ? string ...) وتجب معالجة أسماء الأعمدة المعروفة في وقت التصميم بالاسم فقط. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام بدائل المعلمات |
| byOrigin | تحديد قيمة العمود حسب الاسم في تدفق الأصل. الوسيطة الثانية هي اسم تدفق الأصل. إذا كان هناك العديد من حالات التطابق، يتم إرجاع التطابق الأول. إذا لم يكن هناك تطابق، فيتم إرجاع قيمة NULL. يجب تحويل القيمة التي تم إرجاعها بواسطة إحدى دالات تحويل النوع(TO_DATE, TO_STRING...). يجب معالجة أسماء الأعمدة المعروفة في وقت التصميم بالاسم فقط. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام بدائل المعلمات. |
| byOrigins | تحديد صفيف أعمدة حسب الاسم في التدفق. الوسيطة الثانية هي الدفق الذي نشأت منه. إذا كان هناك العديد من حالات التطابق، يتم إرجاع التطابق الأول. إذا لم يكن هناك تطابق، فيتم إرجاع قيمة NULL. يجب تحويل القيمة التي تم إرجاعها بواسطة إحدى دالات تحويل النوع(TO_DATE, TO_STRING...) ويجب معالجة أسماء الأعمدة المعروفة في وقت التصميم بالاسم فقط. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام بدائل المعلمات. |
| byName | تحديد قيمة العمود حسب الاسم في التدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. إذا كان هناك العديد من حالات التطابق، يتم إرجاع التطابق الأول. إذا لم يكن هناك تطابق، فيتم إرجاع قيمة NULL. يجب تحويل القيمة التي تم إرجاعها بواسطة إحدى دالات تحويل النوع(TO_DATE, TO_STRING...). يجب معالجة أسماء الأعمدة المعروفة في وقت التصميم بالاسم فقط. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام بدائل المعلمات. |
| byNames | تحديد صفيف أعمدة حسب الاسم في التدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. إذا كان هناك العديد من حالات التطابق، يتم إرجاع التطابق الأول. إذا لم تكن هناك حالات تطابق لعمود، فسيكون الناتج بالكامل قيمة NULL. تتطلب القيمة التي تم إرجاعها وظيفة تحويل النوع (toDate، toString، ...). تجب معالجة أسماء الأعمدة المعروفة في وقت التصميم بالاسم فقط. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام بدائل المعلمات. |
| byPath | البحث عن مسار هرمي بالاسم في الدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. إذا لم يتم العثور على مثل هذا المسار، فسيتم إرجاعه خالياً. يجب معالجة أسماء/مسارات الأعمدة المعروفة في وقت التصميم فقط من خلال الاسم أو مسار التدوين النقطي. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام بدائل المعلمات. |
| byPosition | تحديد قيمة عمود حسب موضعه النسبي (استناداً إلى 1) في الدفق. إذا كان الموضع خارج الحدود، فإنه يُرجع قيمة NULL. يجب تحويل القيمة التي تم إرجاعها بواسطة إحدى وظائف تحويل النوع (TO_DATE، TO_STRING ...) المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام استبدالات المعلمات. |
| hasPath | التحقق من وجود مسار هرمي معين بالاسم في الدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. يجب معالجة أسماء/مسارات الأعمدة المعروفة في وقت التصميم فقط من خلال الاسم أو مسار التدوين النقطي. المدخلات المحسوبة غير مدعومة ولكن يمكنك استخدام بدائل المعلمات. |
| originColumns | يحصل على كل أعمدة الإخراج لتدفق بيانات الأصل حيث تم إنشاء الأعمدة. يجب تضمينه في دالة أخرى. |
| hex | إرجاع تمثيل سلسلة سداسية عشرية لقيمة ثنائية |
| unhex | إلغاء قيمة سداسية عشرية لقيمة ثنائية من تمثيل السلسلة. يمكن استخدام هذا مع sha2 وmd5 للتحويل من سلسلة إلى تمثيل ثنائي |
المحتوى ذو الصلة
- قائمة بجميع الوظائف المجمعة.
- قائمة بجميع دالات الصفيف.
- قائمة بجميع وظائف البحث المخزنة مؤقتًا.
- قائمة بجميع دوال التحويل.
- قائمة بجميع دالات التاريخ والوقت.
- قائمة بجميع دالات التعبير.
- قائمة بجميع وظائف الخريطة.
- قائمة بجميع وظائف النافذة.
- تفاصيل الاستخدام لجميع تعبيرات تحويل البيانات.
- تعرف على كيفية استخدام منشئ التعبير.