مشاركة عبر

المعلمات العمومية في Azure Data Factory

  • مقالة

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

تلميح

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

المعلمات العمومية هي ثوابت عبر مصنع بيانات يمكن استهلاكها بواسطة مسارات بتعبيرات. تكون مفيدة عندما يكون لديك مسارات متعددة بأسماء وقيم معلمات متطابقة. عند ترقية مصنع بيانات باستخدام عملية التكامل والنشر المستمرة (CI/CD)، يمكنك تجاوز هذه المعلمات في كل بيئة.

إنشاء معلمات عمومية

لإنشاء معلمة عمومية، انتقل إلى علامة التبويب Global parameters في قسم Manage. حدد New لفتح التنقل الجانبي للإنشاء.

لقطة شاشة توضح الزر

في جزء التنقل، أدخل اسماً، وحدد نوع بيانات ثم حدد قيمة المعلّمة.

لقطة شاشة توضح مكان إضافة الاسم ونوع البيانات والقيمة للمعلمة العمومية الجديدة.

بعد إنشاء معلّمة عمومية، يمكنك تحريرها بالنقر فوق اسم المعلمة. لتغيير معلمات متعددة في وقت واحد، حدد Edit all.

إنشاء معلمات عمومية

استخدام المعلمات العمومية في مسار معالجة

يمكن استخدام المعلمات العمومية في أي تعبير للمسارات. إذا كان المسار يشير إلى مورد آخر مثل مجموعة البيانات أو تدفق البيانات، فيمكنك تمرير قيمة المعلمة العمومية عبر معلمات هذا المورد. يتم الإشارة إلى المعلمات العمومية بأنها pipeline().globalParameters.<parameterName>.

استخدام معلمات عمومية

المعلّمات العمومية في CI/CD

نوصي بتضمين المعلمات العالمية في قالب ARM خلال CI/CD. الآلية الجديدة لتضمين المعلمات العالمية في قالب ARM (من "إدارة المركز" -> "قالب ARM" -> "تضمين المعلمات العالمية في قالب ARM") كما هو موضح أدناه، لن تتعارض/تتجاوز المصنع- إعدادات المستوى كما كانت تفعل سابقاً، وبالتالي لا تتطلب PowerShell إضافياً لتوزيع المعلمات العالمية خلال CI/CD.

لقطة شاشة لـ

إشعار

لقد نقلنا تجربة واجهة المستخدم لتضمين المعلمات العالمية من قسم "المعلمات العالمية" إلى قسم "قالب ARM" في مركز الإدارة. إذا كنت تستخدم الآلية القديمة بالفعل (من "إدارة المركز" -> "المعلمات العامة" -> "التضمين في قالب ARM")، يمكنك المتابعة. سنواصل دعمها.

إذا كنت تستخدم التدفق الأقدم لدمج المعلمات العالمية في حل التكامل والتوزيع المستمر، فسيستمر في العمل:

  • تضمين المعلمات العمومية في قالب ARM (من "إدارة المركز" -> "المعلمات العمومية" -> "تضمين في قالب ARM") لقطة شاشة ل

  • توزيع المعلّمات العمومية عبر أحد البرامج النصية لـ PowerShell

نوصي بشدة باستخدام الآلية الجديدة لتضمين المعلمات العالمية في قالب ARM (من "إدارة المركز" -> "قالب ARM" -> "تضمين المعلمات العامة في قالب ARM") نظراً لأنها تجعل CICD مع عالمي المعلمات أكثر وضوحاً وأسهل في إدارتها.

إشعار

لا يتوفر تكوين تضمين المعلمات العامة في قالب ARM إلا في "وضع Git". وحالياً، معطل في وضع "Live mode" أو "Data Factory".

تحذير

لا يمكنك استخدام "-" في اسم المعلمة. ستتلقى رمز الخطأ "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}". إلّا أنه، يمكنك استخدام ‘_’ في اسم المعلمة.

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