مشاركة عبر


الدوال الفوقية في تعيين تدفقات البيانات

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

تلميح

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

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

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

قائمة دالات ميتا

الدوال الوصفية تعمل بشكل أساسي على البيانات الوصفية في تدفق بياناتك.

دالة ميتا مهمة
byItem يجد عنصرا فرعيا داخل هيكل أو مصفوفة من هيكل. إذا كان هناك العديد من حالات التطابق، يتم إرجاع التطابق الأول. إذا لم تكن هناك تطابقات، NULL يتم إرجاع قيمة. يجب تحويل القيمة المرتجعة من النوع بواسطة أحد إجراءات تحويل الأنواع (مثل ? 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 البحث عن مسار هرمي بالاسم في الدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. إذا لم يتم العثور على مثل هذا المسار، فإنه يعطي NULL قيمة. أسماء ومسارات أعمدة العناوين المعروفة في وقت التصميم فقط بأسمائها أو مسارات تدوين النقاط. المدخلات المحوسبة غير مدعومة، لكن يمكنك استخدام استبدالات المعلمات.
byPosition يختار قيمة العمود حسب موقعها النسبي (1 على الأساس) في التدفق. إذا كان المركز خارج الحدود، فإنه يعطي NULL قيمة. يجب تحويل القيمة المرتجعة نوعا بواسطة إحدى دوال تحويل الأنواع (مثل TO_DATE و TO_STRING). المدخلات المحوسبة غير مدعومة، لكن يمكنك استخدام استبدالات المعلمات.
hasPath التحقق من وجود مسار هرمي معين بالاسم في الدفق. يمكنك تمرير اسم تدفق اختياري كوسيطة ثانية. أسماء ومسارات أعمدة العناوين المعروفة في وقت التصميم فقط بأسمائها أو مسارات تدوين النقاط. المدخلات المحوسبة غير مدعومة، لكن يمكنك استخدام استبدالات المعلمات.
originColumns يحصل على كل أعمدة الإخراج لتدفق بيانات الأصل حيث تم إنشاء الأعمدة. يجب تضمينه في دالة أخرى.
hex يرجع تمثيلا لسلسلة سداسية لقيمة ثنائية.
unhex إلغاء قيمة سداسية عشرية لقيمة ثنائية من تمثيل السلسلة. يمكنك استخدامه مع sha2 وللتحويل md5 من النص إلى التمثيل الثنائي.