مشاركة عبر


معلمات المسار والمتغيرات في Azure Data Factory و Azure Synapse Analytics

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

تلميح

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

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

معلمات المسار

يتم تعريف المعلمات على مستوى البنية الأساسية لبرنامج ربط العمليات التجارية، ولا يمكن تعديلها أثناء تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية. يمكن استخدام معلمات المسار للتحكم في سلوك البنية الأساسية لبرنامج ربط العمليات التجارية وأنشطتها، مثل تمرير تفاصيل الاتصال لمجموعة بيانات أو مسار ملف ستتم معالجته.

كيفية تعريف معلمة البنية الأساسية لبرنامج ربط العمليات التجارية

لتعريف معلمة البنية الأساسية لبرنامج ربط العمليات التجارية، اتبع الخطوات التالية:

  • انقر فوق البنية الأساسية لبرنامج ربط العمليات التجارية لعرض علامات تبويب التكوين الخاصة به.
  • حدد علامة التبويب "Parameters"، وانقر فوق الزر "+ New" لتعريف معلمة جديدة.
  • أدخل اسما ووصفا للمعلمة، وحدد نوع بياناتها من القائمة المنسدلة. يمكن أن تكون أنواع البيانات سلسلة أو Int أو Float أو Bool أو Array أو Object أو SecureString.
  • اختياريا، يمكنك أيضا تعيين قيمة افتراضية للمعلمة .

بعد تعريف معلمة البنية الأساسية لبرنامج ربط العمليات التجارية، يمكنك الوصول إلى قيمتها أثناء تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية باستخدام @pipeline().parameters.<parameter name> التعبير في نشاط البنية الأساسية لبرنامج ربط العمليات التجارية. على سبيل المثال، إذا قمت بتعريف معلمة تسمى account_name من النوع String، يمكنك الوصول إلى قيمتها في نشاط باستخدام التعبير @pipeline().parameters.account_name.

لقطة شاشة لتعريف المعلمة.

قبل تشغيل كل مسار، يمكنك تعيين قيمة جديدة إلى المعلمة الخاصة بك في اللوحة اليمنى، وإلا سيستخدم المسار القيمة الافتراضية أو القيمة المحددة مسبقا.

متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية

متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية هي قيم يمكن تعيينها وتعديلها أثناء تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية. على عكس معلمات المسار، التي يتم تعريفها على مستوى المسار ولا يمكن تغييرها أثناء تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية، يمكن تعيين متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية وتعديلها داخل البنية الأساسية لبرنامج ربط العمليات التجارية باستخدام نشاط Set Variable .

يمكن استخدام متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية لتخزين البيانات ومعالجتها أثناء تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية، مثل تخزين نتائج الحساب أو الحالة الحالية لعملية ما.

إشعار

يتم حالياً تحديد نطاق المتغيرات على مستوى خط التدفقات. وهذا يعني أنها ليست مؤشر ترابط آمن ويمكن أن تتسبب في سلوك غير متوقع وغير مرغوب فيه إذا تم الوصول إليها من داخل نشاط تكرار متوازي مثل التكرار الحلقي foreach، خاصة عندما يتم أيضاً تعديل القيمة ضمن نشاط foreach هذا.

لتعريف متغير البنية الأساسية لبرنامج ربط العمليات التجارية، اتبع الخطوات التالية:

  • انقر فوق البنية الأساسية لبرنامج ربط العمليات التجارية لعرض علامات تبويب التكوين الخاصة به.

  • حدد علامة التبويب "المتغيرات"، وانقر فوق الزر "+ جديد" لتعريف متغير جديد.

  • أدخل اسما ووصفا للمتغير، وحدد نوع البيانات الخاص به من القائمة المنسدلة. يمكن أن تكون أنواع البيانات سلسلة أو قيمة منطقية أو صفيف.

  • اختياريا، يمكنك أيضا تعيين قيمة افتراضية للمتغير. سيتم استخدام هذه القيمة كقيمة أولية للمتغير في بداية تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية.

بعد تعريف متغير البنية الأساسية لبرنامج ربط العمليات التجارية، يمكنك الوصول إلى قيمته أثناء تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية باستخدام @variables('<variable name>') التعبير في نشاط البنية الأساسية لبرنامج ربط العمليات التجارية. على سبيل المثال، إذا قمت بتعريف متغير يسمى علامة من النوع Array، يمكنك الوصول إلى قيمته في نشاط باستخدام التعبير @variables('flag'). يمكنك أيضا استخدام نشاط "تعيين متغير" لتعديل قيمة المتغير داخل البنية الأساسية لبرنامج ربط العمليات التجارية.

لقطة شاشة لتعريف متغير.

راجع البرامج التعليمية التالية للحصول على إرشادات خطوة بخطوة لإنشاء مسارات مع الأنشطة:

كيفية تحقيق CI/CD (التكامل والتسليم المستمر) باستخدام Azure Data Factory