نسخ البيانات من Concur باستخدام مصنع بيانات Azure أوSynapse Analytics (معاينة)

  • مقالة

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

تلميح

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

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

هام

هذا الموصل قيد المعاينة حاليًا. يمكنك تجربته وإعطائنا ملاحظات. إذا كنت تريد أن تأخذ تبعية على موصلات الإصدار الأولي في حلك، يرجى الاتصال بدعم Azure.

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

يُعتمد موصل Concur في الإمكانيات التالية:

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

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

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

إشعار

حساب الشريك غير مدعوم حالياً.

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

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

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

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

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

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

    Screenshot of the Concur connector.

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

    Screenshot of linked service configuration for Concur.

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

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

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

تُدعم الخصائص التالية لخدمة الارتباط Concur:

الخاصية الوصف مطلوب
النوع يجب تعيين خاصية النوع إلى: Concur ‏‏نعم‬
connectionProperties مجموعة من الخصائص التي تعرف كيفية الاتصال بـ Concur. ‏‏نعم‬
تحت connectionProperties:
نوع المصادقة القيم المسموح بها هي OAuth_2.0_Bearer وOAuth_2.0 (legacy). يعمل خيار المصادقة OAuth 2.0 مع واجهة برمجة تطبيقات Concur القديمة التي أُهملت منذ فبراير 2017. ‏‏نعم‬
مضيف نقطة النهاية لخادم Concur، على سبيل المثالimplementation.concursolutions.com. ‏‏نعم‬
baseUrl عنوان URL الأساسي لعنوان URL الخاص بتخويل Concur. نعم OAuth_2.0_Bearer للمصادقة
clientId معرف عميل التطبيق الذي أتاحهConcur App Management. ‏‏نعم‬
clientSecret سر العميل المطابق لمعرف العميل. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault. نعم OAuth_2.0_Bearer للمصادقة
اسم المستخدم اسم المستخدم الذي تستخدمه للوصول إلى خدمة Concur. ‏‏نعم‬
كلمة المرور كلمة المرور المطابقة لاسم المستخدم الذي قدمته في حقل اسم المُستخدم. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault. ‏‏نعم‬
useEncryptedEndpoints يحدد ما إذا كانت نقاط نهاية مصدر البيانات مشفرة باستخدام HTTPS. القيمة الافتراضية هي صواب. لا
useHostVerification يحدد ما إذا كان سيتم طلب اسم المضيف في شهادة الخادم لمطابقة اسم مُضيف الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب. لا
usePeerVerification يُحدد ما إذا كان سيتم التحقق من هوية الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب. لا

مثال:

{ 
    "name": "ConcurLinkedService", 
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "connectionProperties": {
                "host":"<host e.g. implementation.concursolutions.com>",
                "baseUrl": "<base URL for authorization e.g. us-impl.api.concursolutions.com>",
                "authenticationType": "OAuth_2.0_Bearer",
                "clientId": "<client id>",
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "username": "fakeUserName",
                "password": {
                    "type": "SecureString",
                    "value": "<password>"
                },
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

مثال (legacy):

لاحظ أن ما يلي هو نموذج خدمة مرتبط قديم دون connectionPropertiesOAuth_2.0 مصادقة أو استخدامها.

{
    "name": "ConcurLinkedService",
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "clientId" : "<clientId>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

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

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

لنسخ البيانات من Concur، عّين خاصية نوع مجموعة البيانات إلى ConcurObject. لا توجد خاصية خاصة إضافية خاصة بالنوع في هذا النوع من مجموعة البيانات. تدعم الخصائص التالية:

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

مثال

{
    "name": "ConcurDataset",
    "properties": {
        "type": "ConcurObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Concur linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

ConcurSource كمصدر

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

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

مثال:

"activities":[
    {
        "name": "CopyFromConcur",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Concur input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ConcurSource",
                "query": "SELECT * FROM Opportunities where Id = xxx"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

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

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

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

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