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

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

تلميح

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   Azure Data Factory

   

   Azure Synapse

   

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

   

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

   

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

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

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

الخصائص التالية مدعومة للخدمة المرتبطة بـ ServiceNow:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع على: ServiceNow	‏‏نعم‬
نقطة النهاية	نقطة نهاية خادم ServiceNow هي (http://<instance>.service-now.com).	‏‏نعم‬
نوع المصادقة	نوع المصادقة الذي يجب استخدامه. القيم المسموح بها هي: Basic، OAuth2	‏‏نعم‬
اسم المستخدم	اسم المستخدِم المستخدَم للاتصال بخادم ServiceNow لمصادقة Basic وOAuth2.	‏‏نعم‬
كلمة المرور	كلمة المرور المطابقة لاسم المستخدم لمصادقة Basic وOAuth2. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
clientId	معرّف العميل لمصادقة OAuth2.	لا
clientSecret	سر العميل لمصادقة OAuth2. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	لا
useEncryptedEndpoints	يحدد ما إذا كانت نقاط نهاية مصدر البيانات مشفرة باستخدام HTTPS. القيمة الافتراضية هي صواب.	لا
useHostVerification	يحدد ما إذا كان سيتم طلب اسم المضيف في شهادة الخادم لمطابقة اسم مُضيف الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا
usePeerVerification	يُحدد ما إذا كان سيتم التحقق من هوية الخادم عند الاتصال عبر TLS. القيمة الافتراضية هي صواب.	لا

مثال:

{
    "name": "ServiceNowLinkedService",
    "properties": {
        "type": "ServiceNow",
        "typeProperties": {
            "endpoint" : "http://<instance>.service-now.com",
            "authenticationType" : "Basic",
            "username" : "<username>",
            "password": {
                 "type": "SecureString",
                 "value": "<password>"
            }
        }
    }
}

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

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

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

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

مثال

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ServiceNow linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

ServiceNow كمصدر

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

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

لاحظ ما يلي عند تحديد مخطط وعمود لـ ServiceNow في الاستعلام، وارجع إلى نصائح الأداء حول الآثار الضمنية لأداء النسخ.

• المخطط: حدد المخطط كـ Actual أو Display في استعلام ServiceNow، والذي يمكنك اعتباره معلمة sysparm_display_value صحيحة أو خاطئة عند الاتصال بـ واجهات برمجة تطبيقات ServiceNow REST. 
• العمود: اسم العمود للقيمة الفعلية ضمن المخطط Actual هو [column name]_value، بينما بالنسبة لقيمة العرض ضمن مخطط Display هي [column name]_display_value. لاحظ أن اسم العمود يحتاج إلى التعيين إلى المخطط المستخدم في الاستعلام.

نموذج استعلام: SELECT col_value FROM Actual.alm_asset أو SELECT col_display_value FROM Display.alm_asset

مثال:

"activities":[
    {
        "name": "CopyFromServiceNow",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ServiceNow input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ServiceNowSource",
                "query": "SELECT * FROM Actual.alm_asset"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

‏‫تلميحات الأداء

المخطط الذي يجب استخدامه

يحتوي ServiceNow على مخططين مختلفين، أحدهما "الفعلي (Actual)" يعرض البيانات الفعلية، والآخر هو "العرض (Display)" يعرض قيم عرض البيانات.

إذا كان لديك عامل تصفية في استعلامك، فاستخدم المخطط "الفعلي" الذي يتميز بأداء نسخ أفضل. عند الاستعلام عن المخطط "الفعلي"، يدعم ServiceNow في الأصل عامل التصفية عند إحضار البيانات لإرجاع مجموعة النتائج التي تمت تصفيتها فقط، بينما عند الاستعلام عن مخطط "العرض"، يقوم ملف تعريف التطبيق (ADF) باسترداد جميع البيانات وتطبيق عامل التصفية داخلياً.

الفهرس

يمكن أن يساعد فهرس جدول ServiceNow في تحسين أداء الاستعلام، راجع إنشاء فهرس جدول.

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

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

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

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