انسخ البيانات من سحابة SAP للعميل (C4C) باستخدام Azure Data Factory أو تحليلات Synapse

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

تلميح

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

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

تلميح

لمعرفة الدعم الكلي للخدمة في سيناريو تكامل بيانات SAP، راجع تكامل بيانات SAP باستخدام المستند التقني لـAzure Data Factory مع مقدمة مفصلة حول كل موصل SAP والمقارنة والتوجيه.

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

يتم دعم موصل SAP Cloud for Customer هذا للإمكانيات التالية:

القدرات المدعومة	IR
Copy activity (المصدر/المتلق)	(1) (2)
نشاط البحث	(1) (2)

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

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

على وجه التحديد، يمكن هذا الموصل الخدمة من نسخ البيانات من سحابة SAP للعميل وإليها بما في ذلك سحابة SAP للمبيعات وسحابة SAP للخدمة وسحابة SAP لحلول التفاعل الاجتماعي.

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

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

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

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

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

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

   Azure Data Factory

   

   Azure Synapse

   

2. ابحث عن SAP وحدد موصل سحابة SAP للعميل.

   

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

   

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

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

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

يتم دعم الخصائص التالية لخدمة سحابة SAP للعميل المرتبطة:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: SapCloudForCustomer.	‏‏نعم‬
عنوان URL	عنوان URL لخدمة SAP C4C OData.	‏‏نعم‬
اسم المستخدم	حدد اسم المستخدم للاتصال بـ SAP C4C.	‏‏نعم‬
كلمة المرور	حدد كلمة المرور لحساب المستخدم الذي حددته لاسم المستخدم. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
connectVia	Integration Runtime الذي سيتم استخدامه للاتصال بمخزن البيانات. إذا لم يتم تحديده، فإنه يستخدم Azure Integration Runtime الافتراضي.	لا

مثال:

{
    "name": "SAPC4CLinkedService",
    "properties": {
        "type": "SapCloudForCustomer",
        "typeProperties": {
            "url": "https://<tenantname>.crm.ondemand.com/sap/c4c/odata/v1/c4codata/" ,
            "username": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

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

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

لنسخ البيانات من سحابة SAP للعميل، قم بتعيين خاصية نوع مجموعة البيانات إلى SapCloudForCustomerResource. تدعم الخصائص التالية:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مجموعة البيانات إلى: SapCloudForCustomerResource	‏‏نعم‬
path	تحديد مسار كيان SAP C4C OData.	‏‏نعم‬

مثال:

{
    "name": "SAPC4CDataset",
    "properties": {
        "type": "SapCloudForCustomerResource",
        "typeProperties": {
            "path": "<path e.g. LeadCollection>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP C4C linked service>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

SAP C4C كمصدر

لنسخ البيانات من سحابة SAP للعميل، قم بتعيين نوع المصدر في نشاط النسخ إلى SapCloudForCustomerSource. تُدعم الخصائص التالية في قسم مصدر نشاط النسخ:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: SapCloudForCustomerSource	‏‏نعم‬
استعلام	حدد استعلام OData المخصص لقراءة البيانات.	لا
httpRequestTimeout	المهلة (قيمة TimeSpan) لطلب HTTP للحصول على استجابة. هذه القيمة هي المهلة للحصول على استجابة، وليست المهلة لقراءة بيانات الاستجابة. إذا لم يتم التحديد، فإن القيمة الافتراضية هي 00:30:00 (30 دقيقة).	لا

عينة الاستعلام للحصول على بيانات ليوم معين: "query": "$filter=CreatedOn ge datetimeoffset'2017-07-31T10:02:06.4202620Z' and CreatedOn le datetimeoffset'2017-08-01T10:02:06.4202620Z'"

مثال:

"activities":[
    {
        "name": "CopyFromSAPC4C",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP C4C input dataset>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapCloudForCustomerSource",
                "query": "<custom query e.g. $top=10>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

SAP C4C كمتلقي

لنسخ البيانات من سحابة SAP للعميل، قم بتعيين نوع المتلقي في نشاط النسخ إلى SapCloudForCustomerSink. تُدعم الخصائص التالية في قسم متلقي نشاط النسخ:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: SapCloudForCustomerSink	‏‏نعم‬
writeBehavior	سلوك الكتابة للعملية. يمكن أن يكون "إدراج"، "تحديث".	‏‏لا. الافتراضي هو "إدراج".
writeBatchSize	حجم الدُفعة لعملية الكتابة. قد يختلف حجم الدُفعة للحصول على أفضل أداء لجدول أو خادم مختلف.	‏‏لا. الافتراضي 10.
maxConcurrentConnections	الحد الأعلى للاتصالات المتزامنة التي تم إنشاؤها إلى مخزن البيانات أثناء تشغيل النشاط. حدد قيمة فقط عندما تريد تحديد الاتصالات المتزامنة.	لا

مثال:

"activities":[
    {
        "name": "CopyToSapC4c",
        "type": "Copy",
        "inputs": [{
            "type": "DatasetReference",
            "referenceName": "<dataset type>"
        }],
        "outputs": [{
            "type": "DatasetReference",
            "referenceName": "SapC4cDataset"
        }],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "SapCloudForCustomerSink",
                "writeBehavior": "Insert",
                "writeBatchSize": 30
            },
            "parallelCopies": 10,
            "dataIntegrationUnits": 4,
            "enableSkipIncompatibleRow": true,
            "redirectIncompatibleRowSettings": {
                "linkedServiceName": {
                    "referenceName": "ErrorLogBlobLinkedService",
                    "type": "LinkedServiceReference"
                },
                "path": "incompatiblerows"
            }
        }
    }
]

تخطيط نوع البيانات لسحابة SAP للعميل

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

نوع بيانات SAP C4C OData	نوع بيانات الخدمة المؤقتة
Edm.Binary	بايت[]
Edm.Boolean	مجموعة
Edm.Byte	بايت[]
Edm.DateTime	DateTime
Edm.Decimal	عدد عشري
Edm.Double	مزدوج
Edm.Single	فردي
Edm.Guid	المعرف الفريد العمومي
Edm.Int16	Int16
Edm.Int32	Int32
Edm.Int64	Int64
Edm.SByte	Int16
Edm.String	السلسلة‬
Edm.Time	TimeSpan
Edm.DateTimeOffset	DateTimeOffset

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

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

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

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