الإشارة إلى بيانات تعريف المشغل في عمليات تشغيل التدفق

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

تلميح

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

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

يحتاج المسار أحيانا إلى فهم بيانات التعريف وقراءتها من المشغل الذي يستدعيها. على سبيل المثال، مع تشغيل مشغل نافذة التدوير، استنادا إلى وقت بدء النافذة ووقت الانتهاء، يعالج المسار شرائح بيانات أو مجلدات مختلفة. في Azure Data Factory، نستخدم معلمات ومتغيرات النظام لتمرير بيانات التعريف من المشغلات إلى المسارات.

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

إشعار

توفر أنواع المشغلات المختلفة معلومات بيانات تعريف مختلفة. لمزيد من المعلومات، راجع متغيرات النظام.

واجهة المستخدم لمصنع البيانات

يوضح لك هذا القسم كيفية تمرير معلومات بيانات التعريف من المشغلات إلى المسارات، داخل واجهة مستخدم Data Factory (UI).

1. انتقل إلى لوحة التأليف وقم بتحرير البنية الأساسية لبرنامج ربط العمليات التجارية.

2. حدد اللوحة الفارغة لإظهار إعدادات البنية الأساسية لبرنامج ربط العمليات التجارية. لا تحدد أي نشاط. قد تحتاج إلى سحب جزء الإعداد من أسفل اللوحة لأنه قد يتم طيه.

3. حدد علامة التبويب Parameters وحدد + New لإضافة معلمات.

   

4. إضافة مشغلات إلى البنية الأساسية لبرنامج ربط العمليات التجارية عن طريق تحديد + Trigger.

5. قم بإنشاء مشغل أو إرفاقه بالبنية الأساسية لبرنامج ربط العمليات التجارية وحدد موافق.

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

   

7. لاستخدام القيم في البنية الأساسية لبرنامج ربط العمليات التجارية، استخدم المعلمات، مثل @pipeline().parameters.parameterName، وليس متغيرات النظام، في تعريفات البنية الأساسية لبرنامج ربط العمليات التجارية. على سبيل المثال، في هذه الحالة، لقراءة وقت بدء المشغل، نشير إلى @pipeline().parameters.parameter_1.

مخطط JSON

لتمرير معلومات المشغل إلى تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية، يجب تحديث كل من المشغل والمسار JSON مع parameters القسم .

تعريف المسار

ضمن properties القسم ، أضف تعريفات المعلمات إلى parameters القسم .

{
    "name": "demo_pipeline",
    "properties": {
        "activities": [
            {
                "name": "demo_activity",
                "type": "WebActivity",
                "dependsOn": [],
                "policy": {
                    "timeout": "7.00:00:00",
                    "retry": 0,
                    "retryIntervalInSeconds": 30,
                    "secureOutput": false,
                    "secureInput": false
                },
                "userProperties": [],
                "typeProperties": {
                    "url": {
                        "value": "@pipeline().parameters.parameter_1",
                        "type": "Expression"
                    },
                    "method": "GET"
                }
            }
        ],
        "parameters": {
            "parameter_1": {
                "type": "string"
            },
            "parameter_2": {
                "type": "string"
            },
            "parameter_3": {
                "type": "string"
            },
            "parameter_4": {
                "type": "string"
            },
            "parameter_5": {
                "type": "string"
            }
        },
        "annotations": [],
        "lastPublishTime": "2021-02-24T03:06:23Z"
    },
    "type": "Microsoft.DataFactory/factories/pipelines"
}

تعريف المشغل

ضمن pipelines القسم ، قم بتعيين قيم المعلمات في parameters القسم . لا تحتاج إلى ملء المعلومات لجميع المعلمات. ما عليك سوى تعبئة تلك التي ستفترض قيم بيانات التعريف المشغلة.

{
    "name": "trigger1",
    "properties": {
        "annotations": [],
        "runtimeState": "Started",
        "pipelines": [
            {
                "pipelineReference": {
                    "referenceName": "demo_pipeline",
                    "type": "PipelineReference"
                },
                "parameters": {
                    "parameter_1": "@trigger().startTime"
                }
            }
        ],
        "type": "ScheduleTrigger",
        "typeProperties": {
            "recurrence": {
                "frequency": "Minute",
                "interval": 15,
                "startTime": "2021-03-03T04:38:00Z",
                "timeZone": "UTC"
            }
        }
    }
}

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

لاستخدام القيم في البنية الأساسية لبرنامج ربط العمليات التجارية، استخدم المعلمات، مثل @pipeline().parameters.parameterName، وليس متغيرات النظام، في تعريفات البنية الأساسية لبرنامج ربط العمليات التجارية.

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

لمزيد من المعلومات حول المشغلات، راجع تنفيذ البنية الأساسية لبرنامج ربط العمليات التجارية والمشغلات.