Share via

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

  • مقالة

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

تلميح

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

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

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

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

Screenshot that highlights the New button you select to create global parameters.

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

Screenshot that shows where you add the name, data type, and value for the new global parameter.

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

Create global parameters

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

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

Using global parameters

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

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

Screenshot of 'Include in ARM template'.

إشعار

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

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

  • تضمين المعلمات العمومية في قالب ARM (من "إدارة المركز" -> "المعلمات العمومية" -> "تضمين في قالب ARM") Screenshot of deprecated 'Include in ARM template'.

  • توزيع المعلّمات العمومية عبر أحد البرامج النصية لـ 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: .....}". إلّا أنه، يمكنك استخدام ‘_’ في اسم المعلمة.

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