إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على: 
Azure Data Factory Azure Synapse Analytics
تلميح
جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!
تتوفر تدفقات البيانات في كل من Azure Data Factory وخطوط أنابيب Azure Synapse. تنطبق هذه المقالة على تعيين تدفقات البيانات. إذا كنت جديداً في مجال التحويلات، فيرجى الرجوع إلى المقالة التمهيدية تحويل البيانات باستخدام تدفق بيانات التعيين.
الوظيفة المعرفة من قبل المستخدم هي تعبير مخصص يمكنك تحديده لتتمكن من إعادة استخدام المنطق عبر تدفقات بيانات تعيين متعددة. تعيش الوظائف التي يحددها المستخدم في مجموعة تسمى مكتبة تدفق البيانات لتتمكن من تجميع مجموعات مشتركة من الوظائف المخصصة بسهولة.
كلما وجدت نفسك تبني نفس المنطق في تعبير عبر تدفقات بيانات تعيين متعددة، ستكون هذه فرصة جيدة لتحويل ذلك إلى وظيفة معرفة من قبل المستخدم.
الشروع في العمل
لبدء استخدام الوظائف المعرفة من قبل المستخدم، يجب أولًا إنشاء مكتبة تدفق بيانات. انتقل إلى صفحة الإدارة ثم ابحث عن مكتبات تدفق البيانات ضمن القسم المؤلف.
مكتبة تدفق البيانات
من هنا، يمكنك النقر فوق الزر +New لإنشاء مكتبة تدفق بيانات جديدة. املأ الاسم والوصف ثم تصبح جاهزًا لإنشاء وظيفة معرفة من قبل المستخدم.
الوظائف المعرفة بواسطة المستخدم
لإنشاء وظيفة معرفة من قبل المستخدم، من مكتبة تدفق البيانات التي تريد إنشاء الدالة فيها، انقر فوق الزر +New.
قم بتعبئة اسم الدالة المعرفة من قبل المستخدم.
إشعار
لا يمكنك استخدام اسم تعبير تدفق بيانات التعيين الموجود. للحصول على قائمة بتعبيرات تدفق بيانات التعيين الحالية، راجع تعبيرات تحويل البيانات في تعيين تدفق البيانات | Microsoft Docs
يمكن أن تحتوي الوظائف المعرفة من قبل المستخدم على وسيطات صفرية أو أكثر. تسمح لك الوسيطات بتمرير القيم عند استدعاء الوظيفة الخاصة بك والإشارة إلى هذه الوسيطات في منطق التعبير الخاص بك. تتم تسمية الوسيطات تلقائيًا من i1 وi2 وما إلى ذلك، ويمكنك اختيار نوع بيانات الوسيطة من القائمة المنسدلة.
نص الوظيفة المعرفة من قبل المستخدم هو المكان الذي تحدد فيه منطق الوظيفة الخاصة بك. يوفر المحرر التجربة الكاملة لـ منشئ التعبير | Microsoft Docs وتسمح لك بالإشارة إلى الوسيطات التي تم إنشاؤها وأي تعبيرات تحويل بيانات في تعيين تدفق البيانات | Microsoft Docs.
إشعار
لا يمكن أن تشير الوظيفة المعرفة من قبل المستخدم إلى وظيفة أخرى معرفة من قبل المستخدم.
استخدام وظيفة معرفة من قبل المستخدم في منشئ التعبير
ستظهر الوظائف المعرفة من قبل المستخدم في منشئ تعبير تدفق بيانات التعيين ضمن وظائف مكتبة تدفق البيانات. من هنا، يمكنك استخدام الدالات التي تم إنشاؤها المخصصة وتمرير الوسيطات المناسبة (إن وجدت) التي قمت بتعريفها.
