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

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

تلميح

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

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

هام

موصل Shopify إصدار 1.0 في مرحلة الإزالة. يوصى بترقية موصل Shopify من الإصدار 1.0 إلى 2.0.

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

يتم اعتماد هذا الرابط Shopify للقدرات التالية:

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

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

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

توفر الخدمة برنامج تشغيل مضمناً لتمكين الاتصال، وبالتالي لا تحتاج إلى تثبيت أي برنامج تشغيل يدوياً باستخدام هذا الموصل.

يدعم الموصل إصدارات Windows في هذه المقالة.

تمت إزالة خاصية العمود billing_on من جدولي Recurring_Application_Charges و UsageCharge بسبب إهمال Shopify الرسمي لحقل billing_on.

Note

في الإصدار 2.0، تحتفظ أسماء الأعمدة بهيكل Shopify GraphQL، مثل data.customers.edges.node.createdAt. بالنسبة للإصدار 1.0، تستخدم أسماء الأعمدة أسماء مبسطة، على سبيل المثال، Created_At.

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

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

• أداة نسخ البيانات
• مدخل Microsoft Azure
• .NET SDK
• حزمة تطوير التطوير الخاصة لبايثون
• Azure PowerShell
• واجهة برمجة التطبيقات REST
• قالب Azure Resource Manager

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

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

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

   مصنع بيانات Azure

   

   Azure Synapse

   

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

   

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

   

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

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

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

يدعم موصل شوبيفاي الآن الإصدار 2.0. راجع هذا القسم لترقية إصدار موصل Shopify الخاص بك من الإصدار 1.0. للحصول على تفاصيل الخاصية، راجع الأقسام المقابلة.

• الإصدار 2.0
• الإصدار 1.0

الإصدار 2.0

تدعم خدمة Shopify المرتبطة الخصائص التالية عند تطبيق الإصدار 2.0:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: Shopify	‏‏نعم‬
الإصدار	الإصدار الذي تحدده. القيمة هي 2.0.	‏‏نعم‬
مضيف	نقطة النهاية لخادم Shopify. (أي mystore.myshopify.com)	‏‏نعم‬
accessToken	الرمز المميز للوصول إلى واجهة برمجة التطبيقات الذي يمكن استخدامه للوصول إلى بيانات Shopify. لا تنتهي صلاحية الرمز المميز إذا كان وضع عدم الاتصال فعالاً. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬

مثال:

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "version": "2.0",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

الإصدار 1.0

تدعم الخدمة المرتبطة Shopify الخصائص التالية عند تطبيق الإصدار 1.0:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: Shopify	‏‏نعم‬
مضيف	نقطة النهاية لخادم Shopify. (أي mystore.myshopify.com)	‏‏نعم‬
accessToken	الرمز المميز للوصول إلى واجهة برمجة التطبيقات الذي يمكن استخدامه للوصول إلى بيانات Shopify. لا تنتهي صلاحية الرمز المميز إذا كان وضع عدم الاتصال فعالاً. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
useEncryptedEndpoints	يحدد ما إذا كانت نقاط نهاية مصدر البيانات مشفرة باستخدام HTTPS. القيمة الافتراضية هي صواب.	لا
useHostVerification	يحدد ما إذا كان سيتم طلب اسم المضيف في شهادة الخادم لمطابقة اسم مُضيف الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا
usePeerVerification	يُحدد ما إذا كان سيتم التحقق من هوية الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا

مثال:

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

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

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

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مجموعة البيانات إلى: ShopifyObject	‏‏نعم‬
اسم الجدول	ضع اسمًا للجدول. في الإصدار 2.0، تحتفظ أسماء الجداول بهيكل Shopify GraphQL، على سبيل المثال customers. بالنسبة للإصدار 1.0، تستخدم أسماء الجداول أسماء مبسطة مع بادئات، على سبيل المثال، "Shopify"."Customers".	لا (إذا تم تحديد "الاستعلام" في مصدر النشاط)

Note

لا يمكن قراءة عمود العلامات عند التحديد tableName في مجموعة البيانات. لقراءة هذا العمود، استخدم query.

مثال

{
    "name": "ShopifyDataset",
    "properties": {
        "type": "ShopifyObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Shopify linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

Shopify كمصدر

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مصدر نشاط النسخ إلى: ShopifySource	‏‏نعم‬
استعلام	بالنسبة للإصدار 2.0، استخدم استعلام GraphQL لقراءة البيانات. لمعرفة المزيد حول هذا الاستعلام، راجع هذه المقالة. لاحظ أن استعلام ترقيم الصفحات مدعوم فقط للجداول الخارجية، ويمكن أن يتضمن كل سجل في الجدول الخارجي ما يصل إلى 250 سجلا من سجلات الجدول الداخلي. بالنسبة للإصدار 1.0، استخدم استعلام SQL المخصص لقراءة البيانات. على سبيل المثال: "SELECT * FROM "Products" WHERE Product_Id = '123'".	لا (إذا تم تحديد "tableName" في مجموعة البيانات)

مثال:

"activities":[
    {
        "name": "CopyFromShopify",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Shopify input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ShopifySource"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

تعيين نوع البيانات ل Shopify

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

Shopify نوع البيانات	نوع بيانات الخدمة المؤقتة (للإصدار 2.0)	نوع بيانات الخدمة المؤقتة (للإصدار 1.0)
Boolean	Boolean	Boolean
الباحث	الباحث	الباحث
غير موقعInt64	UInt64	UInt64
Decimal	Decimal	Decimal
طفا	Double	Double
String	String	String
التاريخ	التاريخ	التاريخ
DateTime	DateTime	DateTime
معرف	String	String
URL	String	String
رمز البلد	String	String
أنواع البيانات المخصصة الأخرى	String	String

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

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

Shopify دورة حياة الموصل وترقيته

يوضح الجدول التالي مرحلة الإصدار وسجلات التغيير لإصدارات مختلفة من Shopify الموصل:

الإصدار	مرحلة الإصدار	سجل التغيير
الإصدار 1.0	تمت الإزالة	غير قابل للتطبيق.
الإصدار 2.0	التوفر العام	• تحتفظ أسماء الجداول والأعمدة بهيكل Shopify GraphQL. • دعم استعلام GraphQL فقط. • useEncryptedEndpoints، useHostVerification، غير usePeerVerification مدعومة في الخدمة المرتبطة.

قم بترقية موصل Shopify من الإصدار 1.0 إلى الإصدار 2.0

1. في صفحة تحرير الخدمة المرتبطة ، حدد 2.0 للإصدار. لمزيد من المعلومات، راجع خصائص الإصدار 2.0 من الخدمة المرتبطة.
2. بالنسبة للإصدار 2.0، لاحظ أن أسماء الجداول والأعمدة تحتفظ بهيكل Shopify GraphQL.
3. إذا كنت تستخدم استعلام SQL في مصدر نشاط النسخ أو نشاط البحث الذي يشير إلى الخدمة المرتبطة بالإصدار 1.0 ، فستحتاج إلى تحويلها إلى استعلام GraphQL. لمعرفة المزيد حول هذا الاستعلام، راجع هذه المقالة

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

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