نسخ البيانات من سحابة تسويق Salesforce باستخدام مصنع بيانات Azure أو تحليلات Synapse

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

تلميح

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

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

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

موصل Salesforce Marketing Cloud هذا مدعوم للإمكانيات التالية:

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

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

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

يدعم موصل Salesforce Marketing Cloud مصادقة OAuth 2، ويدعم كلاً من أنواع الحزم القديمة والمحسنة. تم إنشاء الموصل أعلى واجهة برمجة تطبيقات REST لسحابة تسويق Salesforce.

إشعار

لا يدعم هذا الموصل استرداد طرق العرض أو الكائنات المخصصة أو ملحقات البيانات المخصصة.

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

يمكنك إنشاء مسار مع نشاط النسخ باستخدام .NET SDK أو Python SDK أو Azure PowerShell أو واجهة برمجة تطبيقات REST أو قالب Azure Resource Manager. راجع نسخ البرنامج التعليمي للنشاط للحصول على إرشادات خطوة بخطوة لإنشاء مسار مع نشاط نسخ.

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

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

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

   Azure Data Factory

   

   Azure Synapse

   

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

   

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

   

إشعار

يجب تعيين نطاق تكامل واجهة برمجة التطبيقات على Salesforce Marketing Cloud إلى Hub | حملة | اقرأ لكي ينجح الموصل.

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

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

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

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: SalesforceMarketingCloud	‏‏نعم‬
connectionProperties	مجموعة من الخصائص التي تحدد كيفية الاتصال بسحابة تسويق Salesforce.	‏‏نعم‬
تحت connectionProperties:
نوع المصادقة	تحديد طريقة المصادقة التي سيتم استخدامها. القيم المسموح بها هي Enhanced sts OAuth 2.0 أو OAuth_2.0. الحزمة القديمة من Salesforce Marketing Cloud تدعم فقط OAuth_2.0، بينما تحتاج الحزمة المحسنة إلى Enhanced sts OAuth 2.0. منذ 1 أغسطس 2019، أزالت Salesforce Marketing Cloud القدرة على إنشاء حزم قديمة. جميع الحزم الجديدة هي حزم محسنة.	‏‏نعم‬
مضيف	لحزمة محسنة، يجب أن يكون المضيف النطاق الفرعي الخاص بك الذي يمثله سلسلة أحرف من 28 حرفاً بدءاً من الحروف "mc"، على سبيل المثال mc563885gzs27c5t9-63k636ttgm. بالنسبة لحزمة قديمة، حدد www.exacttargetapis.com.	‏‏نعم‬
clientId	معرف العميل المقترن بتطبيق سحابة تسويق Salesforce.	‏‏نعم‬
clientSecret	سر العميل المقترن بتطبيق سحابة تسويق Salesforce. يمكنك اختيار وضع علامة على هذا الحقل كـ SecureString لتخزينه بشكل آمن في الخدمة، أو تخزين السر في Azure Key Vault والسماح لنشاط نسخ الخدمة بالسحب من هناك عند إجراء نسخة البيانات - تعرف على المزيد من بيانات اعتماد المتجر في Key Vault.	‏‏نعم‬
useEncryptedEndpoints	يحدد ما إذا كانت نقاط نهاية مصدر البيانات مشفرة باستخدام HTTPS. القيمة الافتراضية هي صواب.	لا
useHostVerification	يحدد ما إذا كان سيتم طلب اسم المضيف في شهادة الخادم لمطابقة اسم مُضيف الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا
usePeerVerification	يُحدد ما إذا كان سيتم التحقق من هوية الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا

مثال: استخدام مصادقة STS OAuth 2 المحسنة لحزمة محسنة

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "connectionProperties": {
                "host": "<subdomain e.g. mc563885gzs27c5t9-63k636ttgm>",
                "authenticationType": "Enhanced sts OAuth 2.0",
                "clientId": "<clientId>",
                "clientSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

مثال: استخدام مصادقة OAuth 2 لحزمة قديمة

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "connectionProperties": {
                "host": "www.exacttargetapis.com",
                "authenticationType": "OAuth_2.0",
                "clientId": "<clientId>",
                "clientSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

إذا كنت تستخدم Salesforce Marketing Cloud المرتبطة بالخدمة مع البيانات الأساسية التالية، فإنه لا يزال مدعماً كما هو، بينما يقترح عليك استخدام الخدمة الجديدة للمضي قدماً والتي تضيف دعماً محسناً للحزمة.

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "clientId": "<clientId>",
            "clientSecret": {
                 "type": "SecureString",
                 "value": "<clientSecret>"
            },
            "useEncryptedEndpoints": true,
            "useHostVerification": true,
            "usePeerVerification": true
        }
    }
}

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

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

لنسخ البيانات من Salesforce Marketing Cloud، قم بتعيين خاصية نوع مجموعة البيانات إلى SalesforceMarketingCloudObject. تدعم الخصائص التالية:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مجموعة البيانات إلى: SalesforceMarketingCloudObject	‏‏نعم‬
اسم الجدول	ضع اسمًا للجدول.	لا (إذا تم تحديد "الاستعلام" في مصدر النشاط)

مثال

{
    "name": "SalesforceMarketingCloudDataset",
    "properties": {
        "type": "SalesforceMarketingCloudObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SalesforceMarketingCloud linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

سحابة تسويق Salesforce كمصدر

لنسخ البيانات من Salesforce Marketing Cloud، قم بتعيين نوع المصدر في نشاط النسخ إلى SalesforceMarketingCloudSource. تُدعم الخصائص التالية في قسم مصدر نشاط النسخ:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مصدر نشاط النسخ إلى: SalesforceMarketingCloudSource	‏‏نعم‬
استعلام	استخدم استعلام SQL المخصص لقراءة البيانات. على سبيل المثال: "SELECT * FROM MyTable".	لا (إذا تم تحديد "tableName" في مجموعة البيانات)

مثال:

"activities":[
    {
        "name": "CopyFromSalesforceMarketingCloud",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SalesforceMarketingCloud input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SalesforceMarketingCloudSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

إشعار

جدول جهات الاتصال مدعوم.

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

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

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

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