نسخ البيانات من Dynamics AX باستخدام Azure Data Factory أو تحليلات Synapse

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

تلميح

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

توضح هذه المقالة كيفية استخدام نشاط النسخ في Azure Data Factory والبنية الأساسية لبرنامج ربط العمليات التجارية لتحليلات Synapse لنسخ البيانات من مصدر Dynamics AX. تعتمد هذه المقالة على مقالة نشاط النسخ التي تقدم نظرة عامة على نشاط النسخ.

القدرات المدعومة

يتم اعتماد موصل Dynamics AX هذا للإمكانيات التالية:

القدرات المدعومة	IR
نشاط النسخ (مصدر/-)	① ②
نشاط البحث	① ②

① وقت تشغيل تكامل Azure ② وقت تشغيل التكامل المستضاف ذاتيًا

للحصول على قائمة مخازن البيانات التي تدعم كمصادر ومواضع تلقي، راجع جدول مخازن البيانات المعتمدة.

وبشكل خاص، يدعم موصل Dynamics AX هذا نسخ البيانات من Dynamics AX باستخدام بروتوكول OData مع مصادقة كيان الخدمة.

تلميح

يمكنك أيضاً استخدام هذا الموصل لنسخ البيانات من Dynamics 365 Finance and Operations. راجع دعم OData Dynamics 365 وأسلوب المصادقة.

الشروع في العمل

لتنفيذ نشاط النسخ باستخدام أحد المسارات، يمكنك استخدام إحدى الأدوات أو عدد تطوير البرامج التالية:

• أداة نسخ البيانات
• مدخل Azure
• The .NET SDK
• عدة تطوير برامج Python
• Azure PowerShell
• واجهة برمجة تطبيقات REST
• قالب Azure Resource Manager

إنشاء خدمة مرتبطة بـDynamics AX باستخدام واجهة المستخدم

استخدم الخطوات التالية لإنشاء خدمة مرتبطة بـ Dynamics AX في واجهة مستخدم مدخل Microsoft Azure.

1. استعرض للوصول إلى علامة التبويب "Manage" في مصنع بيانات Azure أو مساحة عمل Synapse، وحدد "Linked Services"، ثم انقر فوق "New":

   Azure Data Factory

   

   Azure Synapse

   

2. ابحث عن Dynamics وحدد موصل Dynamics AX.

   

3. قم بتكوين تفاصيل الخدمة، واختبر الاتصال، وأنشئ الخدمة المرتبطة الجديدة.

   

تفاصيل تكوين الموصل

توفر المقاطع التالية تفاصيل حول الخصائص التي يمكنك استخدامها لتعريف كيانات مصنع البيانات الخاصة بموصل Dynamics AX.

المتطلبات الأساسية

لاستخدام المصادقة الأساسية للخدمة، اتبع الخطوات التالية:

1. تسجيل تطبيق مع النظام الأساسي للهويات في Microsoft. لمعرفة كيفية إجراء ذلك، راجع التشغيل السريع: تسجيل تطبيق باستخدام النظام الأساسي للهويات في Microsoft. دون هذه القيم التي تستخدمها لتعريف الخدمة المرتبطة:

   • مُعرّف التطبيق
   • مفتاح التطبيق
   • معرِّف المستأجر

2. انتقل إلى Dynamics AX، وامنح كيان الخدمة هذا الإذن الصحيح للوصول إلى Dynamics AX.

خصائص الخدمة المرتبطة

يتم دعم الخصائص التالية لخدمة الارتباط Dynamics AX:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى DynamicsAX.	‏‏نعم‬
عنوان URL	مثيل نقطة نهاية OData لـ Dynamics AX (أو Dynamics 365 Finance and Operations).	‏‏نعم‬
servicePrincipalId	حدد معرّف عميل التطبيق.	‏‏نعم‬
servicePrincipalKey	حدِّد مفتاح التطبيق. ضَع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو أشر إلى أحد بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
tenant	حدد معلومات المستأجر (اسم المجال أو معرف المستأجر) التي يوجد داخلها التطبيق. يمكنك إستردادها عن طريق تحريك الماوس في الركن العلوي الأيمن من بوابة Azure.	‏‏نعم‬
aadResourceId	حدد مورد AAD الذي تطلبه للتخويل. على سبيل المثال، إذا كان عنوان Dynamics URL الخاص بك هو https://sampledynamics.sandbox.operations.dynamics.com/data/، فإن مورد AAD (دليل Azure النشط) المطابق عادة https://sampledynamics.sandbox.operations.dynamics.com.	‏‏نعم‬
connectVia	وقت تشغيل التكامل المطلوب استخدامه للاتصال بمخزن البيانات. يمكنك اختيار وقت تشغيل تكامل Azure أو وقت تشغيل التكامل المستضاف ذاتياً (إذا كان مخزن البيانات موجوداً في شبكة اتصال خاصة). إذا لم يتم التحديد، يتم استخدام وقت تشغيل تكامل Azure الافتراضي.	لا

مثال

{
    "name": "DynamicsAXLinkedService",
    "properties": {
        "type": "DynamicsAX",
        "typeProperties": {
            "url": "<Dynamics AX instance OData endpoint>",
            "servicePrincipalId": "<service principal id>",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<service principal key>"
            },
            "tenant": "<tenant info, e.g. microsoft.onmicrosoft.com>",
            "aadResourceId": "<AAD resource, e.g. https://sampledynamics.sandbox.operations.dynamics.com>"
        }
    },
    "connectVia": {
        "referenceName": "<name of Integration Runtime>",
        "type": "IntegrationRuntimeReference"
    }
}

خصائص مجموعة البيانات

يوفر هذا القسم قائمة من الخصائص التي تدعم مجموعة بيانات Dynamics AX.

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

لنسخ البيانات من Dynamics AX، قم بتعيين خاصية النوع لمجموعة البيانات إلى DynamicsAXResource. تدعم الخصائص التالية:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع لمجموعة البيانات إلى DynamicsAXResource.	‏‏نعم‬
path	المسار إلى كيان Dynamics AX OData.	‏‏نعم‬

مثال

{
    "name": "DynamicsAXResourceDataset",
    "properties": {
        "type": "DynamicsAXResource",
        "typeProperties": {
            "path": "<entity path e.g. dd04tentitySet>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Dynamics AX linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

خصائص نشاط النسخ

يوفر هذا القسم قائمة بالخصائص التي يدعمها مصدر Dynamics AX.

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

Dynamics AX كمصدر

لنسخ البيانات من Dynamics AX، قم بتعيين نوع المصدر في نشاط النسخ إلى DynamicsAXSource. يتم اعتماد الخصائص التالية في قسم مصدر نشاط النسخ:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مصدر نشاط النسخ إلى DynamicsAXSource.	‏‏نعم‬
استعلام	خيارات استعلام OData لتصفية البيانات. مثال:"?$select=Name,Description&$top=5". ملاحظة:ينسخ الموصل البيانات من URL المدمج: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source]. لمزيد من المعلومات، راجع مكونات عنوان URL OData.	لا
httpRequestTimeout	المهلة (قيمة TimeSpan) لطلب HTTP للحصول على استجابة. هذه القيمة هي المهلة للحصول على استجابة، وليست المهلة لقراءة بيانات الاستجابة. إذا لم يتم تحديدها، فإن القيمة الافتراضية هي 00:05:00 (5 دقائق).	لا

مثال

"activities":[
    {
        "name": "CopyFromDynamicsAX",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Dynamics AX input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "DynamicsAXSource",
                "query": "$top=10"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

بحث عن خصائص النشاط

لمعرفة تفاصيل حول الخصائص، تحقق من نشاط البحث.

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

للحصول على قائمة مخازن البيانات المعتمدة كمصادر ومواضع تلقٍّ، راجع مخازن البيانات المعتمدة والتنسيقات.