نسخ البيانات من 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 الجديد دعما أصليا محسنا ل ServiceNow. إذا كنت تستخدم موصل ServiceNow القديم في الحل الخاص بك، فمن المستحسن ترقية موصل ServiceNow في أقرب وقت ممكن. راجع هذا القسم للحصول على تفاصيل حول الفرق بين الإصدار القديم والأحدث.

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

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

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

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

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

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

الرجاء استخدام القيمة الفعلية بدلا من القيمة المعروضة في ServiceNow.

المتطلب الأساسي

لاستخدام هذا الموصل، تحتاج إلى دور مع حق الوصول للقراءة على الأقل إلى sys_db_object والجداول sys_dictionary في ServiceNow.

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

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

• أداة نسخ البيانات
• مدخل 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:

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

مثال:

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

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

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

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مجموعة البيانات إلى: ServiceNowV2Object	‏‏نعم‬
اسم الجدول	ضع اسمًا للجدول.	‏‏نعم‬

مثال

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

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

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

ServiceNow كمصدر

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية نوع مصدر نشاط النسخ إلى: ServiceNowV2Source	‏‏نعم‬
تعبير	استخدم التعبير لقراءة البيانات. يمكنك تكوين التعبير في منشئ الاستعلام. له نفس استخدام منشئ الشروط في ServiceNow. للحصول على إرشادات حول كيفية استخدامه، راجع هذه المقالة.	لا
ضمن expression
النوع	نوع التعبير. يمكن أن تكون القيم ثابتة (افتراضية) و أحادية و ثنائية وحقل.	لا
قيمة	القيمة الثابتة.	نعم عندما يكون نوع التعبير ثابتا أو حقلا
عوامل التشغيل	قيمة عامل التشغيل. لمزيد من المعلومات حول عوامل التشغيل، راجع قسم عوامل التشغيل المتوفرة لحقول الاختيار التي تحتوي على سلاسل في هذه المقالة.	نعم عندما يكون نوع التعبير أحادي أو ثنائي
المعاملات	قائمة التعبيرات التي يتم تطبيق عامل التشغيل عليها.	نعم عندما يكون نوع التعبير أحادي أو ثنائي

مثال:

"activities": [
    {
        "name": "CopyFromServiceNow",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ServiceNow input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ServiceNowV2Source",
                "expression": {
                    "type": "Nary",
                    "operators": [
                        "<"
                    ],
                    "operands": [
                        {
                            "type": "Field",
                            "value": "u_founded"
                        },
                        {
                            "type": "Constant",
                            "value": "2000"
                        }
                    ]
                }
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

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

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

ترقية موصل ServiceNow

فيما يلي الخطوات التي تساعدك على ترقية موصل ServiceNow:

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

الاختلافات بين ServiceNow وServiceNow (قديم)

يوفر موصل ServiceNow وظائف جديدة وهو متوافق مع معظم ميزات موصل ServiceNow (القديم). يعرض الجدول أدناه اختلافات الميزات بين ServiceNow وServiceNow (قديم).

ServiceNow	ServiceNow (قديم)
useEncryptedEndpoints, useHostVerification and usePeerVerification are not supported in the linked service.	دعم useEncryptedEndpoints، واستخدامHostVerification واستخدامPeerVerification في الخدمة المرتبطة.
دعم منشئ الاستعلام في المصدر.	منشئ الاستعلام غير معتمد في المصدر.
الاستعلامات المستندة إلى SQL غير مدعومة.	دعم الاستعلامات المستندة إلى SQL.
استعلامات sortBy غير معتمدة في منشئ الاستعلام.	دعم sortBy queries في Query.
يمكنك عرض المخطط في مجموعة البيانات.	لا يمكنك عرض المخطط في مجموعة البيانات.

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

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