Adatok másolása a ServiceNow-ból az Azure Data Factory vagy a Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan másolhat adatokat a ServiceNow-ból az Azure Data Factory és a Synapse Analytics-folyamatok másolási tevékenységével. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Támogatott képességek

Ez a ServiceNow-összekötő a következő képességeket támogatja:

Támogatott képességek	IR
Copy tevékenység (forrás/-)	① ②
Keresési tevékenység	① ②

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

A szolgáltatás egy beépített illesztőprogramot biztosít a kapcsolat engedélyezéséhez. Ezért nem kell manuálisan telepítenie egyetlen illesztőprogramot sem ezzel az összekötővel.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

• Az Adatok másolása eszköz
• The Azure portal
• A .NET SDK
• A Python SDK
• Azure PowerShell
• A REST API
• Az Azure Resource Manager-sablon

Társított szolgáltatás létrehozása a ServiceNow-hoz felhasználói felülettel

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást a ServiceNow-hoz az Azure Portal felhasználói felületén.

1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

   Azure Data Factory

   

   Azure Synapse

   

2. Keresse meg a ServiceNow-t, és válassza ki a ServiceNow-összekötőt.

   

3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

   

Csatlakozás or konfigurációjának részletei

Az alábbi szakaszok a ServiceNow-összekötőre jellemző Data Factory-entitások definiálásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

A ServiceNow társított szolgáltatás esetében a következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	A típustulajdonságnak a következőre kell állítania: ServiceNow	Igen
endpoint	A ServiceNow-kiszolgáló végpontja (http://<instance>.service-now.com).	Igen
authenticationType	A használni kívánt hitelesítési típus. Az engedélyezett értékek a következők: Alapszintű, OAuth2	Igen
username	A ServiceNow-kiszolgálóhoz való csatlakozáshoz használt felhasználónév alapszintű és OAuth2 hitelesítéshez.	Igen
jelszó	Az alapszintű és az OAuth2 hitelesítés felhasználónévnek megfelelő jelszó. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
clientId	Az OAuth2-hitelesítés ügyfélazonosítója.	Nem
clientSecret	Az OAuth2-hitelesítés ügyfélkódja. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Nem
useEncryptedEndpoints	Megadja, hogy az adatforrásvégpontok HTTPS használatával vannak-e titkosítva. Az alapértelmezett érték igaz.	Nem
useHostVerification	Megadja, hogy a kiszolgáló tanúsítványában szereplő gazdagépnévnek meg kell-e egyeznie a kiszolgáló gazdagépnevével, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz.	Nem
usePeerVerification	Megadja, hogy ellenőrizze-e a kiszolgáló identitását, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz.	Nem

Példa

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

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz a ServiceNow-adathalmaz által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a ServiceNow-ból, állítsa az adathalmaz típustulajdonságát ServiceNowObject értékre. A következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie: ServiceNowObject	Igen
tableName	A tábla neve.	Nem (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

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

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a ServiceNow-forrás által támogatott tulajdonságok listáját tartalmazza.

ServiceNow mint forrás

Ha adatokat szeretne másolni a ServiceNow-ból, állítsa be a másolási tevékenység forrástípusát a ServiceNowSource-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: ServiceNowSource	Igen
Lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. For example: "SELECT * FROM Actual.alm_asset".	Nem (ha "tableName" van megadva az adathalmazban)

A ServiceNow sémájának és oszlopának lekérdezésben való megadásakor vegye figyelembe az alábbiakat, és tekintse meg a másolási teljesítményre vonatkozó teljesítménytippeket.

• Séma: adja meg a sémát a ServiceNow-lekérdezésben vagy Display annak Actual részeként, amelyet a ServiceNow REST API-k meghívásakor sysparm_display_valueigaz vagy hamis paraméterként tekinthet rá. 
• Oszlop: a séma [column name]_valuetényleges Actual értékének oszlopneve, míg a séma alatti Display megjelenítési érték.[column name]_display_value Vegye figyelembe, hogy az oszlop nevének le kell képeznie a lekérdezésben használt sémát.

Minta lekérdezés:SELECT col_value FROM Actual.alm_asset VAGY SELECT col_display_value FROM Display.alm_asset

Példa

"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>"
            }
        }
    }
]

Teljesítménnyel kapcsolatos tippek

Használandó séma

A ServiceNow 2 különböző sémával rendelkezik, az egyik " Tényleges" , amely tényleges adatokat ad vissza, a másik a "Megjelenítés" , amely az adatok megjelenítési értékeit adja vissza.

Ha rendelkezik szűrővel a lekérdezésben, használjon "Tényleges" sémát, amely jobb másolási teljesítménnyel rendelkezik. A "Tényleges" sémára való lekérdezéskor a ServiceNow natív módon támogatja a szűrőt az adatok beolvasásakor, hogy csak a szűrt eredményhalmazt adja vissza, míg a "Megjelenítés" séma lekérdezésekor az ADF lekéri az összes adatot, és belsőleg alkalmazza a szűrőt.

Index

A ServiceNow táblaindex segíthet a lekérdezési teljesítmény javításában, lásd : Táblaindex létrehozása.

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

Kapcsolódó tartalom

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a támogatott adattárakban találja.