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

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

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

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

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

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

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

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

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

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

• أداة نسخ البيانات
• مدخل 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:

مثال

{
    "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. تدعم الخصائص التالية:

مثال

{
    "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. يتم اعتماد الخصائص التالية في قسم مصدر نشاط النسخ:

مثال

"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>"
            }
        }
    }
]

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

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

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

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