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

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

Tip

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.

Important

A ServiceNow V1-összekötő eltávolítási szakaszban van. Javasoljuk, hogy frissítse a ServiceNow-összekötőt v1-ről V2-re.

Támogatott képességek

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

Támogatott képességek	integrációs modul
Másolási tevékenység (forrás/-)	(1) (2)
Keresési tevékenység	(1) (2)

(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.

Prerequisite

Az összekötő használatához rendelkeznie kell egy olyan szerepkörrel, amely legalább olvasási hozzáféréssel rendelkezik a ServiceNow sys_db_object, sys_db_view és sys_dictionary tábláihoz.

A ServiceNow nézeteinek eléréséhez olyan szerepkörrel kell rendelkeznie, amely legalább olvasási hozzáféréssel rendelkezik sys_db_view_table és sys_db_view_table_field táblákhoz.

Kezdő lépések

A másolási tevékenység végrehajtásához egy folyamattal használhatja az alábbi eszközök vagy SDK-k egyikét:

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.

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
Keresse meg a ServiceNow-t, és válassza ki a ServiceNow-összekötőt.
Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

Az összekötő 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	Description	Required
típus	A típustulajdonságnak a következőnek kell lennie: ServiceNowV2	Yes
végpont	A ServiceNow-kiszolgáló végpontja (`http://<instance>.service-now.com`).	Yes
authenticationType	A használni kívánt hitelesítési típus. Az engedélyezett értékek a következők: Alapszintű, OAuth2	Yes
felhasználónév	A ServiceNow-kiszolgálóhoz való csatlakozáshoz használt felhasználónév alapszintű és OAuth2 hitelesítéshez.	Yes
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.	Yes
clientId	Az OAuth2-hitelesítés ügyfélazonosítója.	OAuth-hitelesítés esetén igen
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.	OAuth-hitelesítés esetén igen
grantType	Az ügyfélalkalmazás által a jogkivonat eléréséhez használt OAuth2.0-folyamat típusát adja meg. Az alapértelmezett érték a jelszó.	OAuth-hitelesítés esetén igen

Example:

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

Adatkészlet 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 ServiceNowV2Object értékre. A következő tulajdonságok támogatottak:

Property	Description	Required
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie: ServiceNowV2Object	Yes
tableName	A tábla neve.	Yes
valueType	A ServiceNow táblaértékek típusa. Ennek a tulajdonságnak az értéke lehet `display` vagy `actual` (alapértelmezett). Úgy tekinthet a `sysparm_display_value` paraméterre, mint igaz vagy hamis értékre, amikor a ServiceNow REST API-kat meghívja.	No

Example

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowV2Object",
        "typeProperties": {
            "tableName": "<table name>",
            "valueType": "actual"
        },
        "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 ServiceNowV2Source-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

Property	Description	Required
típus	A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: ServiceNowV2Source	Yes
kifejezés	A kifejezéssel adatokat olvashat. A kifejezést a Lekérdezésszerkesztőben konfigurálhatja. Ugyanazzal a használattal rendelkezik, mint a ServiceNow feltételszerkesztője. A használati útmutatót ebben a cikkben találja. Kifejezésparamétereket is használhat. Vegye figyelembe, hogy a megjelenítési érték helyett a tényleges értéket kell használnia.	No
Alatt `expression`
típus	A kifejezés típusa. Az értékek lehetnek állandók (alapértelmezett), Unary, Bináris, Mező és Nary.	No
value	Az állandó érték.	Igen, ha a kifejezés típusa állandó vagy mező
operators	Az operátor értéke. Az operátorokkal kapcsolatos további információkért tekintse meg a jelen cikk sztringeket tartalmazó választható mezőihez elérhető operátorokat.	Igen, ha a kifejezés típusa unáris vagy bináris
operands	Azon kifejezések listája, amelyekre az operátort alkalmazza.	Igen, ha a kifejezés típusa unáris vagy bináris

pageSize	A lekérdezés eredményének oldalankénti dokumentumok száma. A többszálas olvasás engedélyezéséhez ajánlott 5000 és 10 000 közötti oldalméretet beállítani.	No (az alapértelmezett érték 300)

Example:

"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"
                        }
                    ]
                },
                "pageSize": 300
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Kifejezésparaméterek használata

A kifejezésparamétert a Lekérdezésszerkesztőben a Dinamikus tartalom hozzáadása lehetőséget választva konfigurálhatja. A paramétertípusnak objektumnak kell lennie, és az értéknek az alábbi JSON-példában látható formátumot kell követnie:

 {
	"type": "Nary",
	"operators": [
		"="
	],
	"operands": [
		{
			"type": "Field",
			"value": "col"
		},
		{
			"type": "Constant",
			"value": "val"
		}
	]
}

Íme egy példa a forrás JSON-jára a kifejezésparaméter használatával:

"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": "Expression",
                    "value": "@pipeline().parameters.expressionParameter"
                }
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Megjegyzés:

Az oszlop sys_tags és a származtatott oszlopai a ServiceNow API korlátozásai miatt nem kérhetők le.

Keresési tevékenység tulajdonságai

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

A ServiceNow-összekötő frissítése

A ServiceNow-összekötő frissítésének lépései a következők:

Hozzon létre egy új társított szolgáltatást a csatolt szolgáltatás tulajdonságaira hivatkozva.
A forrásban lévő lekérdezés a Lekérdezésszerkesztőre frissül, amelynek a használata megegyezik a ServiceNow feltételszerkesztőjének használatával. Megtanulhatja, hogyan konfigurálhatja azt, hivatkozva a ServiceNow-ra mint forrásra.

A ServiceNow V2 és a V1 közötti különbségek

A ServiceNow V2-összekötő új funkciókat kínál, és kompatibilis a ServiceNow V1-összekötő legtöbb funkciójával. Az alábbi táblázat a V2 és az 1. virtuális gép közötti funkcióbeli különbségeket mutatja be.

ServiceNow V2	ServiceNow V1
a useEncryptedEndpoints, a useHostVerification és a usePeerVerification nem támogatott a társított szolgáltatásban.	A useEncryptedEndpoints, a useHostVerification és a usePeerVerification támogatása a társított szolgáltatásban.
A forrás lekérdezésszerkesztőjének támogatása.	A lekérdezésszerkesztő nem támogatott a forrásban.
Az SQL-alapú lekérdezések nem támogatottak.	Sql-alapú lekérdezések támogatása.
A SortBy lekérdezések nem támogatottak a Lekérdezésszerkesztőben.	A SortBy lekérdezések támogatása a Lekérdezésben.
A sémát az adathalmazban tekintheti meg.	A séma nem tekinthető meg az adathalmazban.
Konfigurálhatja a `valueType` elemet `display` vagy `actual` elemekre adathalmazokban. A rendszer a megjelenítendő vagy a tényleges táblanevet használja az értékként `tableName`. Az oszlop neve mind a megjelenítendő, mind a tényleges érték esetében `[column name]`.	A megjelenítési vagy tényleges táblanév előtaggal ellátva ("Megjelenítés" vagy "Tényleges") szolgál az értékként `tableName`. A tényleges érték oszlopneve `[column name]_value`, míg a megjelenítési értéké `[column name]_display_value`.

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.

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-12-18