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

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

تلميح

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

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

هام

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

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

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

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

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

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

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

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

المتطلبات

إذا كان مخزن البيانات الخاص بك موجوداً داخل شبكة محلية، أو شبكة Azure ظاهرية، أو Amazon Virtual Private Cloud، فأنت بحاجة إلى تكوين وقت تشغيل تكامل مستضاف ذاتياً للاتصال به.

إذا كان مخزن البيانات الخاص بك عبارة عن خدمة بيانات سحابية مُدارة، يمكنك استخدام Azure Integration Runtime. إذا كان الوصول مقتصراً على عناوين IP التي تمت الموافقة عليها في قواعد جدار الحماية، يمكنك إضافة عناوين IP لـ Azure Integration Runtime إلى قائمة السماح.

يمكنك أيضاً استخدام ميزة وقت تشغيل تكامل الشبكة الظاهرية المُدارة في Azure Data Factory للوصول إلى الشبكة المحلية دون تثبيت وقت تشغيل تكامل مستضاف ذاتياً وتكوينه.

لمزيد من المعلومات حول آليات وخيارات أمان الشبكة التي يدعمها Data Factory، راجع إستراتيجيات الوصول إلى البيانات.

إشعار

الإصدار 2.0 مدعوم مع التكامل الذاتي المستضاف في وقت التشغيل 5.56.0.0 أو أعلى.

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

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

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

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

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

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

   مصنع بيانات Azure

   

   Azure Synapse

   

2. ابحث عن Square وحدد "Square connector".

   

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

   

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

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

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

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

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

الإصدار 2.0

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: Square	‏‏نعم‬
الإصدار	الإصدار الذي تحدده. القيمة هي 2.0.	‏‏نعم‬
مضيف	عنوان URL لمثيل Square. (أي mystore.mysquare.com)	‏‏نعم‬
clientId	معرف العميل المقترن بتطبيق Square.	‏‏نعم‬
clientSecret	سر العميل المقترن بتطبيق Square. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
accessToken	الرمز المميز للوصول الذي حُصِل عليه من Square. منح حق وصول محدود إلى حساب Square عن طريق مطالبة مستخدم مصادق عليه بأذونات صريحة. تنتهي صلاحية رموز الوصول OAuth بعد 30 يوما من إصدارها، ولكن لا تنتهي صلاحية رموز التحديث المميزة. يمكن تحديث رموز الوصول المميزة بواسطة الرمز المميز للتحديث. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault. لمزيد من المعلومات حول أنواع الرموز المميزة للوصول، راجع أنواع الرموز المميزة للوصول.	‏‏نعم‬
refreshToken	الرمز المميز للتحديث الذي حُصِل عليه من Square. تستخدم للحصول على رموز وصول جديدة عند انتهاء صلاحية الرمز الحالي. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى السر المخزن في Azure Key Vault.	لا
connectVia	Integration Runtime الذي سيتم استخدامه للاتصال بمخزن البيانات. إذا لم يتم تحديده، فإنه يستخدم Azure Integration Runtime الافتراضي. يمكنك استخدام وقت تشغيل التكامل المستضاف ذاتيا ويجب أن يكون إصداره 5.56.0.0 أو أعلى.	لا

مثال:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "version": "2.0",
        "typeProperties": {
            "host": "<e.g. mystore.mysquare.com>", 
            "clientId": "<client ID>", 
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            }, 
            "accessToken": {
                "type": "SecureString",
                "value": "<access token>"
            }, 
            "refreshToken": {
                "type": "SecureString",
                "value": "<refresh token>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

الإصدار 1.0

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع إلى: Square	‏‏نعم‬
connectionProperties	مجموعة من الخصائص التي تعرف كيفية الاتصال بـ Square.	‏‏نعم‬
تحت connectionProperties:
مضيف	عنوان URL لمثيل Square. (أي mystore.mysquare.com)	‏‏نعم‬
clientId	معرف العميل المقترن بتطبيق Square.	‏‏نعم‬
clientSecret	سر العميل المقترن بتطبيق Square. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
accessToken	الرمز المميز للوصول الذي حُصِل عليه من Square. منح حق وصول محدود إلى حساب Square عن طريق مطالبة مستخدم مصادق عليه بأذونات صريحة. تنتهي صلاحية رموز الوصول OAuth بعد 30 يوما من إصدارها، ولكن لا تنتهي صلاحية رموز التحديث المميزة. يمكن تحديث رموز الوصول المميزة بواسطة الرمز المميز للتحديث. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault. لمزيد من المعلومات حول أنواع الرموز المميزة للوصول، راجع أنواع الرموز المميزة للوصول.	‏‏نعم‬
refreshToken	الرمز المميز للتحديث الذي حُصِل عليه من Square. تستخدم للحصول على رموز وصول جديدة عند انتهاء صلاحية الرمز الحالي. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى السر المخزن في Azure Key Vault.	لا
useEncryptedEndpoints	يحدد ما إذا كانت نقاط نهاية مصدر البيانات مشفرة باستخدام HTTPS. القيمة الافتراضية هي صواب.	لا
useHostVerification	يحدد ما إذا كان سيتم طلب اسم المضيف في شهادة الخادم لمطابقة اسم مُضيف الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا
usePeerVerification	يُحدد ما إذا كان سيتم التحقق من هوية الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا
connectVia	Integration Runtime الذي سيتم استخدامه للاتصال بمخزن البيانات. إذا لم يتم تحديده، فإنه يستخدم Azure Integration Runtime الافتراضي.	لا

مثال:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "typeProperties": {
            "connectionProperties": {
                "host": "<e.g. mystore.mysquare.com>", 
                "clientId": "<client ID>", 
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<clientSecret>"
                }, 
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh token>"
                }, 
                "useEncryptedEndpoints": true, 
                "useHostVerification": true, 
                "usePeerVerification": true 
            }
        }
    }
}

أنواع الرموز المميزة للوصول

يدعم Square نوعين من رمز الوصول: personalوOAuth.

• تُستخدم رموز الوصول الشخصية للحصول على وصول غير محدود لـ Connect API إلى الموارد في حسابك على Square.

• تُستخدم رموز الوصول OAuth للحصول على مصادقة ووصول Connect API إلى أي حساب على Square. استخدمها عندما يصل تطبيقك إلى الموارد في حسابات Square أخرى نيابة عن مالكي الحسابات. يمكن أيضا استخدام رموز OAuth المميزة للوصول إلى الموارد في حسابك على Square.

  هام

  لإجراء اختبار الاتصال في الخدمة المرتبطة، MERCHANT_PROFILE_READ مطلوب للحصول على رمز وصول OAuth محدد النطاق. للحصول على أذونات للوصول إلى جداول أخرى، راجع مرجع أذونات مربع OAuth.

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

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

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

لنسخ البيانات من Square، عيّن خاصية نوع مجموعة البيانات إلى SquareObject. تدعم الخصائص التالية:

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

مثال

{
    "name": "SquareDataset",
    "properties": {
        "type": "SquareObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Square linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

Square كمصدر

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

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

إشعار

query غير مدعوم في الإصدار 2.0.

مثال:

"activities":[
    {
        "name": "CopyFromSquare",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Square input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SquareSource",
                "query": "SELECT * FROM Business"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

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

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

نوع البيانات المربعة	نوع بيانات الخدمة المؤقتة (للإصدار 2.0)	نوع بيانات الخدمة المؤقتة (للإصدار 1.0)
السلسلة‬	السلسلة‬	السلسلة‬
رقم صحيح	Int32	Int32
طويل	Int64	Int64
Boolean	Boolean	Boolean
Date	السلسلة‬	‏‏غير مدعومة.
الطابع الزمني	السلسلة‬	‏‏غير مدعومة.
الطابع الزمني مع الإزاحة	السلسلة‬	‏‏غير مدعومة.
المدة (كاملة)	السلسلة‬	السلسلة‬
المدة (الوقت فقط)	السلسلة‬	السلسلة‬
مال	Int64	Int64

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

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

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

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

Version	مرحلة الإصدار	سجل التغيير
الإصدار 1.0	تمت الإزالة	غير قابل للتطبيق.
الإصدار 2.0	التوفر العام	• يجب أن يكون إصدار وقت تشغيل التكامل المستضاف ذاتيا 5.56.0.0 أو أعلى. • تتم قراءة التاريخ والطابع الزمني والطابع الزمني مع الإزاحة كنوع بيانات سلسلة. • useEncryptedEndpoints، useHostVerification، غير usePeerVerification مدعومة في الخدمة المرتبطة. • query غير مدعوم.

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

1. في صفحة تحرير الخدمة المرتبطة ، حدد 2.0 للإصدار. لمزيد من المعلومات، راجع خصائص الإصدار 2.0 من الخدمة المرتبطة.

2. يختلف تعيين نوع البيانات للإصدار 2.0 من الخدمة المرتبطة ب Square عن تعيين الإصدار 1.0. لمعرفة أحدث تعيين لنوع البيانات، راجع تعيين نوع البيانات ل Square.

3. قم بتطبيق وقت تشغيل تكامل مستضاف ذاتيا مع الإصدار 5.56.0.0 أو أعلى.

4. query مدعوم فقط في الإصدار 1.0. يجب عليك استخدام بدلا tableName من query الإصدار 2.0.

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

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