إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
Azure Data Factory Azure Synapse Analytics
Tip
جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!
توضح هذه المقالة متغيرات النظام المدعومة من قِبل Azure Data Factory وAzure Synapse. يمكنك استخدام هذه المتغيرات في التعبيرات عند تعريف الكيانات داخل أي من الخدمات.
Pipeline scope
يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في تدفقات JSON.
| Variable Name | Description |
|---|---|
| @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() |
Note
المتغيرات المتعلقة بنظام التاريخ/الوقت للمشغل (في كل من التدفقات ونطاقات المشغل) والرجوع إلى تواريخ UTC بتنسيق ISO 8601، على سبيل المثال، 2017-06-01T22:20:00.4061448Z.
جدولة نطاق المشغل
يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع ScheduleTrigger.
| Variable Name | Description |
|---|---|
| @trigger().scheduledTime | الوقت الذي تمت فيه جدولة المشغل لاستدعاء تشغيل التدفقات. |
| @trigger().startTime | الوقت الذي تم فيه تشغيل المُشغل فعلياً لاستدعاء تشغيل التدفقات. قد يختلف هذا قليلا عن الوقت المجدول للمشغل. |
نطاق مشغل نافذة التدوير
يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع TumblingWindowTrigger.
| Variable Name | Description |
|---|---|
| @trigger().outputs.windowStartTime | بدء النافذة المقترنة بتشغيل المُشغل. |
| @trigger().outputs.windowEndTime | إنهاء النافذة المقترنة بتشغيل المُشغل. |
| @trigger().scheduledTime | الوقت الذي تمت فيه جدولة المشغل لاستدعاء تشغيل التدفقات. |
| @trigger().startTime | الوقت الذي تم فيه تشغيل المُشغل فعلياً لاستدعاء تشغيل التدفقات. قد يختلف هذا قليلا عن الوقت المجدول للمشغل. |
نطاق مشغل حدث التخزين
يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع BlobEventsTrigger.
| Variable Name | Description |
|---|---|
| @triggerBody().fileName | اسم الملف الذي تسبب إنشاؤه أو حذفه في تشغيل المشغل. |
| @triggerBody().folderPath | المسار إلى المجلد الذي يحتوي على الملف المحدد بواسطة @triggerBody().fileName. الجزء الأول من مسار المجلد هو اسم حاوية تخزين Blob Azure. |
| @trigger().startTime | الوقت الذي تم فيه تشغيل المشغل لاستدعاء تشغيل التدفقات. |
Note
إذا كنت تقوم بإنشاء البنية الأساسية لبرنامج ربط العمليات التجارية والمشغل في Azure Synapse Analytics، فيجب عليك استخدام @trigger().outputs.body.fileName وكمعلمات @trigger().outputs.body.folderPath . هاتان الخاصيتان تلتقطان معلومات blob. استخدم هذه الخصائص بدلاً من استخدام @triggerBody().fileName و@triggerBody().folderPath.
نطاق مشغل الحدث المخصص
يمكن الرجوع إلى متغيرات النظام هذه في أي مكان في مشغل JSON للمشغلات من نوع CustomEventsTrigger.
Note
تتوقع الخدمة أن يتم تنسيق الأحداث المخصصة باستخدام مخطط الحدث Azure Event Grid.
| Variable Name | Description |
|---|---|
| @triggerBody().event.eventType | نوع الأحداث التي أدت إلى تشغيل "مشغل الحدث المخصص". نوع الحدث هو حقل معرّف من قِبل العميل ويتخذ أي قيم من نوع السلسلة. |
| @triggerBody().event.subject | موضوع الحدث المخصص الذي تسبب في تشغيل المشغل. |
| @triggerBody().event.data._keyName_ | حقل البيانات في الحدث المخصص هو خالٍ من المخزن JSON، والتي يمكن للعملاء استخدامه لإرسال الرسائل والبيانات. استخدام البيانات. keyName للإشارة إلى كل حقل. على سبيل المثال، تُرجع الوظيفة @triggerBody().event.data.callback قيمة حقل callback المخزنة ضمن data. |
| @trigger().startTime | الوقت الذي تم فيه تشغيل المشغل لاستدعاء تشغيل التدفقات. |
Note
إذا كنت تقوم بإنشاء البنية الأساسية لبرنامج ربط العمليات التجارية والمشغل في Azure Synapse Analytics، فيجب عليك استخدامه @trigger().outputs.body.event كمعلمات. تلتقط هذه الخاصية معلومات الحدث. استخدم هذه الخاصية بدلا من استخدام @triggerBody().event.
Related content
- للحصول على معلومات حول كيفية استخدام هذه المتغيرات في التعبيرات، راجع لغة التعبير والدالات.
- لاستخدام متغيرات نظام نطاق المشغل في التدفقات، راجع بيانات تعريف مشغل المرجع في التدفقات