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

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:

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

Használja a tényleges értéket a ServiceNow-ban megjelenített érték helyett.

Előfeltétel

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 és sys_dictionary tábláihoz.

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
• Az 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.

   

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:

Példa:

{
    "name": "ServiceNowLinkedService",
    "properties": {
        "type": "ServiceNowV2",
        "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 ServiceNowV2Object értékre. A következő tulajdonságok támogatottak:

Példa

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowV2Object",
        "typeProperties": {
            "tableName": "<table name>"
        },
        "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:

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": "ServiceNowV2Source",
                "expression": {
                    "type": "Nary",
                    "operators": [
                        "<"
                    ],
                    "operands": [
                        {
                            "type": "Field",
                            "value": "u_founded"
                        },
                        {
                            "type": "Constant",
                            "value": "2000"
                        }
                    ]
                }
            },
            "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>"
            }
        }
    }
]

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:

1. Hozzon létre egy új társított szolgáltatást a csatolt szolgáltatás tulajdonságaira hivatkozva.
2. 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. Megtudhatja, hogyan konfigurálhatja a ServiceNow-ra hivatkozó forrásként.

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.

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.