مشاركة عبر

متغيرات النظام المدعومة من قِبل Azure Data Factory وAzure Synapse Analytics

  • مقالة

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

تلميح

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

توضح هذه المقالة متغيرات النظام المدعومة من قِبل Azure Data Factory وAzure Synapse. يمكنك استخدام هذه المتغيرات في التعبيرات عند تعريف الكيانات داخل أي من الخدمات.

نطاق التدفقات

يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في تدفقات JSON.

اسم المتغير ‏‏الوصف
@pipeline().DataFactory اسم البيانات أو مساحة عمل Synapse التي يتم تشغيل خط التدفق فيها
@pipeline().Pipeline اسم المسار
@pipeline().RunId معرف تشغيل تدفقات مُعين
@pipeline().TriggerType نوع المشغل الذي قام باستدعاء التدفقات (على سبيل المثال، ScheduleTrigger ،BlobEventsTrigger). للحصول على قائمة بأنواع المشغلات المعتمدة، راجع تنفيذ التدفقات والمشغلات. يشير نوع المشغل Manual إلى أنه تم تشغيل التدفقات يدوياً.
@pipeline().TriggerId معرف المشغل الذي قام باستدعاء التدفقات
@pipeline().TriggerName اسم المشغل الذي قام باستدعاء التدفقات
@pipeline().TriggerTime وقت تشغيل المشغل الذي قام باستدعاء التدفقات. هذا هو الوقت الذي تم فيه تشغيل المشغل فعلياً لاستدعاء تشغيل التدفقات، وقد يختلف قليلاً عن الوقت المجدول للمشغل.
@pipeline().GroupId معرف المجموعة التي ينتمي إليها تشغيل التدفقات.
@pipeline()?.TriggeredByPipelineName اسم التدفقات التي تؤدي إلى تشغيل التدفقات. قابل للتطبيق عند تشغيل تدفقات يتم تشغيلها بواسطة نشاط ExecutePipeline. تقييم إلى قيمة خالية عند استخدامها في ظروف أخرى. لاحظ علامة الاستفهام بعد @pipeline()
@pipeline()?.TriggeredByPipelineRunId تشغيل معرف التدفقات الذي يؤدي إلى تشغيل التدفقات. قابل للتطبيق عند تشغيل تدفقات يتم تشغيلها بواسطة نشاط ExecutePipeline. تقييم إلى قيمة خالية عند استخدامها في ظروف أخرى. لاحظ علامة الاستفهام بعد @pipeline()

إشعار

المتغيرات المتعلقة بنظام التاريخ/الوقت للمشغل (في كل من التدفقات ونطاقات المشغل) والرجوع إلى تواريخ UTC بتنسيق ISO 8601، على سبيل المثال، 2017-06-01T22:20:00.4061448Z.

جدولة نطاق المشغل

يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع ScheduleTrigger.

اسم المتغير ‏‏الوصف
@trigger().scheduledTime الوقت الذي تمت فيه جدولة المشغل لاستدعاء تشغيل التدفقات.
@trigger().startTime الوقت الذي تم فيه تشغيل المُشغل فعلياً لاستدعاء تشغيل التدفقات. قد يختلف هذا قليلاً عن الوقت المجدول للمشغل.

نطاق مشغل نافذة التدوير

يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع TumblingWindowTrigger.

اسم المتغير ‏‏الوصف
@trigger().outputs.windowStartTime بدء النافذة المقترنة بتشغيل المُشغل.
@trigger().outputs.windowEndTime إنهاء النافذة المقترنة بتشغيل المُشغل.
@trigger().scheduledTime الوقت الذي تمت فيه جدولة المشغل لاستدعاء تشغيل التدفقات.
@trigger().startTime الوقت الذي تم فيه تشغيل المُشغل فعلياً لاستدعاء تشغيل التدفقات. قد يختلف هذا قليلاً عن الوقت المجدول للمشغل.

نطاق مشغل حدث التخزين

يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع BlobEventsTrigger.

اسم المتغير ‏‏الوصف
@triggerBody().fileName اسم الملف الذي تسبب إنشاؤه أو حذفه في تشغيل المشغل.
@triggerBody().folderPath المسار إلى المجلد الذي يحتوي على الملف المحدد بواسطة @triggerBody().fileName. الجزء الأول من مسار المجلد هو اسم حاوية تخزين Blob Azure.
@trigger().startTime الوقت الذي تم فيه تشغيل المشغل لاستدعاء تشغيل التدفقات.

إشعار

إذا كنت تنشئ خط التدفق والتشغيل في Azure Synapse Analytics، فيجب عليك استخدام @trigger().outputs.body.fileName و@trigger().outputs.body.folderPath كمعلمات. هاتان الخاصيتان تلتقطان معلومات blob. استخدم هذه الخصائص بدلاً من استخدام @triggerBody().fileName و@triggerBody().folderPath.

نطاق مشغل الحدث المخصص

يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع CustomEventsTrigger.

إشعار

تتوقع الخدمة أن يتم تنسيق الأحداث المخصصة باستخدام مخطط الحدث Azure Event Grid.

اسم المتغير ‏‏الوصف
@triggerBody().event.eventType نوع الأحداث التي أدت إلى تشغيل "مشغل الحدث المخصص". نوع الحدث هو حقل معرّف من قِبل العميل ويتخذ أي قيم من نوع السلسلة.
@triggerBody().event.subject موضوع الحدث المخصص الذي تسبب في تشغيل المشغل.
@triggerBody().event.data._keyName_ حقل البيانات في الحدث المخصص هو خالٍ من المخزن JSON، والتي يمكن للعملاء استخدامه لإرسال الرسائل والبيانات. الرجاء استخدام البيانات. keyName للإشارة إلى كل حقل. على سبيل المثال، تُرجع الوظيفة @triggerBody().event.data.callback قيمة حقل callback المخزنة ضمن data.
@trigger().startTime الوقت الذي تم فيه تشغيل المشغل لاستدعاء تشغيل التدفقات.

إشعار

إذا كنت تقوم بإنشاء البنية الأساسية لبرنامج ربط العمليات التجارية والمشغل في Azure Synapse Analytics، فيجب عليك استخدام @trigger().outputs.body.event كمعلمات. تلتقط هذه الخاصية معلومات الحدث. استخدم هذه الخاصية بدلا من استخدام @triggerBody().event.

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