مشاركة عبر

المعلمات العمومية في 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 (من "Manage hub" -> "ARM template" -> "Include global parameters in ARM template") كما هو موضح في الصورة التالية، في تجاوز الإعدادات على مستوى المصنع كما كانت تفعل سابقا، وبالتالي لا تتطلب PowerShell إضافية لنشر المعلمات العمومية أثناء CI/CD.

لقطة شاشة لـ

إشعار

نقلنا تجربة واجهة المستخدم لتضمين المعلمات العمومية من قسم "المعلمات العمومية" إلى قسم "قالب ARM" في مركز الإدارة.

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

يحتوي مجلد المعلمات في قالب ARM الذي تم تنزيله على ملفات JSON التي تحدد المعلمات المستخدمة في قالب ARM. يتوافق كل ملف مع معلمة عمومية معينة.

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

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

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

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

إشعار

لا يتوفر تكوين تضمين المعلمات العامة في قالب ARM إلا في "وضع Git". حاليا يتم تعطيله في وضع "الوضع المباشر" أو وضع "مصنع البيانات".

تحذير

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

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