نسخ البيانات من جدول SAP باستخدام Azure Data Factory أو Azure Synapse Analytics

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

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

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

موصل جدول الويب هذا مدعوم للقدرات التالية:

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

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

وبوجه خاص، يدعم موصل جدول SAP هذا ما يلي:

• نسخ البيانات من جدول SAP في:

  • SAP ERP المكون المركزي (SAP ECC) الإصدار 7.01 أو أحدث (في مكدس حزمة دعم SAP الأخيرة الصادر بعد عام 2015).
  • SAP مستودع الأعمال (SAP BW) الإصدار 7.01 أو أحدث (في مكدس حزمة دعم SAP الأخيرة الصادر بعد عام 2015).
  • SAP S/4HANA.
  • منتجات أخرى في SAP Business Suite إصدار 7.01 أو أحدث (في مكدس حزمة دعم SAP الأخيرة الصادر بعد عام 2015).

• نسخ البيانات من كل من جدول SAP شفاف وجدول مجمع وجدول عنقودي وطريقة عرض.

• نسخ البيانات باستخدام المصادقة الأساسية أو اتصالات الشبكة الآمنة (SNC)، إذا تم تكوين SNC.

• الاتصال بخادم تطبيقات SAP أو خادم رسائل SAP.

• استرداد البيانات عن طريق RFC الافتراضي أو المخصص.

لمزيد من المعلومات حول SNC، راجع بدء استخدام SAP SNC لتكاملات RFC - مدونة SAP.

الإصدار 7.01 أو أحدث يشير إلى إصدار SAP NetWeaver بدلاً من إصدار SAP ECC. على سبيل المثال، يحتوي SAP ECC 6.0 EHP 7 بشكل عام على إصدار NetWeaver> =7.4. في حال كنت غير متأكد من البيئة الخاصة بك، إليك خطوات تأكيد الإصدار من نظام SAP الخاص بك:

1. استخدم SAP GUI للاتصال بنظام SAP.
2. انتقل إلى System ->Status.
3. تحقق من إصدار SAP_BASIS، تأكد من أنه يساوي أو أكبر من 701.
   

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

لاستخدام موصل جدول SAP هذا، تحتاج إلى:

• إعداد وقت تشغيل تكامل مستضاف ذاتياً (الإصدار 3.17 أو أحدث). للمزيد من المعلومات، راجع إنشاء وتكوين وقت تشغيل التكامل ذاتي الاستضافة.

• قم بتحميل موصل SAP 64 بت لـ Microsoft.NET 3.0 من موقع SAP وتثبيته على جهاز وقت تشغيل التكامل المستضاف ذاتياً. أثناء التثبيت، تأكد من تحديد الخيار Install Assemblies to GAC في النافذة Optional setup steps.

  

• يجب أن يكون لدى مستخدم SAP الذي يتم استخدامه في موصل جدول SAP الأذونات التالية:

  • التخويل لاستخدام وجهات استدعاء الدالة البعيدة (RFC).
  • أذونات تنفيذ نشاط كائن التخويل S_SDSAUTH. يمكنك الرجوع إلى SAP Note 460089 على كائنات تخويل الأغلبية. بعض RFCs مطلوبة بواسطة موصل NCo الأساسي، على سبيل المثال RFC_FUNCTION_SEARCH.

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

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

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

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

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

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

   • Azure Data Factory
   • Azure Synapse

   

2. ابحث عن SAP وحدد موصل جدول SAP.

   

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

   

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

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

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

يتم دعم الخصائص التالية لخدمة SAP BW Open Hub المرتبطة:

مثال 1: الاتصال بخادم تطبيق SAP

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

مثال 2: الاتصال بخادم رسائل SAP

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "messageServer": "<message server name>",
            "messageServerService": "<service name or port>",
            "systemId": "<system ID>",
            "logonGroup": "<logon group>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

مثال 3: الاتصال باستخدام SNC

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            },
            "sncMode": 1,
            "sncMyName": "<SNC myname>",
            "sncPartnerName": "<SNC partner name>",
            "sncLibraryPath": "<SNC library path>",
            "sncQop": "8"
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

لمزيد من المعلومات حول SNC، راجع بدء استخدام SAP SNC لتكاملات RFC - مدونة SAP.

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

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

لنسخ البيانات من وإلى خدمة SAP BW Open Hub المرتبطة، يتم دعم الخصائص التالية:

مثال

{
    "name": "SAPTableDataset",
    "properties": {
        "type": "SapTableResource",
        "typeProperties": {
            "tableName": "<SAP table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP table linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

جدول SAP كمصدر

لنسخ البيانات من جدول SAP، يتم دعم الخصائص التالية:

في rfcTableOptions، يمكنك استخدام عوامل تشغيل استعلام SAP المشتركة التالية لتصفية الصفوف:

مثال

"activities":[
    {
        "name": "CopyFromSAPTable",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP table input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapTableSource",
                "partitionOption": "PartitionOnInt",
                "partitionSettings": {
                     "partitionColumnName": "<partition column name>",
                     "partitionUpperBound": "2000",
                     "partitionLowerBound": "1",
                     "maxPartitionsNumber": 500
                 }
            },
            "sink": {
                "type": "<sink type>"
            },
            "parallelCopies": 4
        }
    }
]

الانضمام إلى جداول SAP

يدعم موصل جدول SAP حالياً جدول واحد فقط مع الوحدة الوظيفية الافتراضية. للحصول على البيانات المشتركة من جداول متعددة، يمكنك تفعيل خاصية customRfcReadTableFunctionModule في موصل جدول SAP باتباع الخطوات التالية:

• اكتب وحدة وظيفية مخصصة، والتي يمكن أن تأخذ استعلاماً كـ OPTIONS وتطبق المنطق الخاص بك لاسترداد البيانات.
• بالنسبة إلى "الوحدة الوظيفة المخصصة"، أدخل اسم الوحدة الوظيفية المخصصة الخاص بك.
• لـ "خيارات جدول RFC"، حدد عبارة ربط الجدول لإدخاله في الوحدة الوظيفية الخاصة بك كـ OPTIONS، مثل "<TABLE1>INNER JOIN<TABLE2>ON COLUMN0".

وفيما يلي مثال على ذلك:

إنشاء وحدة وظيفية مخصصة

لجدول SAP، حالياً نحن ندعم خاصية customRfcReadTableFunctionModule في مصدر النسخ، والذي يسمح لك بتفعيل المنطق الخاص بك ومعالجة البيانات.

كإرشادات سريعة، إليك بعض المتطلبات للبدء في "الوحدة الوظيفية الخاصة":

• التعريف:

  

• تصدير البيانات إلى أحد الجداول أدناه:

  

  

فيما يلي توضيحات حول كيفية عمل موصل جدول SAP مع وحدة وظيفية مخصصة:

1. إنشاء اتصال مع خادم SAP عبر SAP NCO.

2. استدعاء "وحدة وظيفية مخصصة" مع تعيين المعلمات كما يلي:

   • QUERY_TABLE: اسم الجدول الذي قمت بتعيينه في مجموعة بيانات جدول SAP;
   • محدِّد: محدِّد تعيين في مصدر جدول SAP;
   • ROWCOUNT/الخيار/الحقول: عدد الصفوف/ حقول/ خيار مجمع الذي قمت بتعيينه في مصدر الجدول.

3. احصل على النتيجة ووزع البيانات بالطرق التالية:

   1. وزِّع القيمة في جدول الحقول للحصول على المخططات.

      

   2. الحصول على قيم جدول الإخراج لمعرفة الجدول الذي يحتوي على هذه القيم.

      

   3. احصل على القيم في OUT_TABLE، وقم بتوزيع البيانات ثم اكتبها في المتلقي.

تعيينات نوع البيانات لجدول SAP

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

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

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

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

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