Freigeben über

Kopieren von Daten aus ServiceNow mithilfe von Azure Data Factory oder Synapse Analytics

  • Artikel

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

In diesem Artikel wird beschrieben, wie Sie die Copy-Aktivität in Azure Data Factory- und Synapse Analytics-Pipelines verwenden, um Daten aus ServiceNow zu kopieren. Er baut auf dem Artikel zur Übersicht über die Kopieraktivität auf, der eine allgemeine Übersicht über die Kopieraktivität enthält.

Wichtig

Der neue ServiceNow-Connector bietet verbesserte native ServiceNow-Unterstützung. Wenn Sie den Legacy-ServiceNow-Connector in Ihrer Lösung verwenden, sollten Sie möglichst bald ein Upgrade Ihres ServiceNow-Connectors durchführen. Ausführliche Informationen zum Unterschied zwischen der Legacy- und der neuesten Version finden Sie in diesem Abschnitt .

Unterstützte Funktionen

Dieser ServiceNow-Connector wird für die folgenden Funktionen unterstützt:

Unterstützte Funktionen IR
Kopieraktivität (Quelle/-) ① ②
Lookup-Aktivität ① ②

① Azure Integration Runtime ② Selbstgehostete Integration Runtime

Eine Liste der Datenspeicher, die als Quellen/Senken unterstützt werden, finden Sie in der Tabelle Unterstützte Datenspeicher.

Der Dienst enthält einen integrierten Treiber zum Herstellen der Konnektivität. Daher müssen Sie keinen Treiber manuell installieren, wenn dieser Connector verwendet wird.

Verwenden Sie den tatsächlichen Wert anstelle des in ServiceNow angezeigten Werts.

Voraussetzungen

Um diesen Connector zu verwenden, benötigen Sie eine Rolle mit mindestens Lesezugriff auf sys_db_object- und sys_dictionary-Tabellen in ServiceNow.

Erste Schritte

Sie können eines der folgenden Tools oder SDKs verwenden, um die Kopieraktivität mit einer Pipeline zu verwenden:

Erstellen eines mit ServiceNow verknüpften Dienstes über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um einen mit ServiceNow verknüpften Dienst in der Azure-Portal-Benutzeroberfläche zu erstellen.

  1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zur Registerkarte „Verwalten“, wählen Sie „Verknüpfte Dienste“ aus, und klicken Sie auf „Neu“:

  2. Suchen Sie nach „ServiceNow“, und wählen Sie den ServiceNow-Connector aus.

    Screenshot des ServiceNow-Connectors.

  3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

    Screenshot der Konfiguration des verknüpften Diensts für ServiceNow

Details zur Connector-Konfiguration

Die folgenden Abschnitte enthalten Details zu Eigenschaften, die zum Definieren von Data Factory-Entitäten speziell für den ServiceNow-Connector verwendet werden.

Eigenschaften des verknüpften Diensts

Folgende Eigenschaften werden für den mit ServiceNow verknüpften Dienst unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die type-Eigenschaft muss auf ServiceNowV2 festgelegt sein. Ja
endpoint Der Endpunkt des ServiceNow-Servers (http://<instance>.service-now.com). Ja
authenticationType Der zu verwendende Authentifizierungstyp.
Zulässige Werte sind: Basic, OAuth2		 Ja
username Der Benutzername, der für die Verbindung mit dem ServiceNow-Server für die Authentifizierung „Basic“ und „OAuth2“ verwendet wird. Ja
password Das Kennwort für den Benutzernamen für die Authentifizierung „Basic“ und „OAuth2“. Markieren Sie dieses Feld als einen „SecureString“, um es sicher zu speichern, oder verweisen Sie auf ein in Azure Key Vault gespeichertes Geheimnis. Ja
clientId Die Client-ID für die Authentifizierung „OAuth2“. Ja, für die OAuth-Authentifizierung
clientSecret Der geheime Clientschlüssel für die Authentifizierung „OAuth2“. Markieren Sie dieses Feld als einen „SecureString“, um es sicher zu speichern, oder verweisen Sie auf ein in Azure Key Vault gespeichertes Geheimnis. Ja, für die OAuth-Authentifizierung
grantType Gibt den Typ des OAuth 2.0-Flows an, den die Client-App für den Zugriff auf Token verwendet. Der Standardwert ist „password“. Ja, für die OAuth-Authentifizierung

Beispiel:

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

Dataset-Eigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie im Artikel zu Datasets. Dieser Abschnitt enthält eine Liste der Eigenschaften, die vom ServiceNow-Dataset unterstützt werden.

Legen Sie zum Kopieren von Daten aus ServiceNow die type-Eigenschaft des Datasets auf ServiceNowV2Object fest. Folgende Eigenschaften werden unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die type-Eigenschaft des Datasets muss auf ServiceNowV2Object festgelegt werden. Ja
tableName Der Name der Tabelle. Ja

Beispiel

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

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie im Artikel Pipelines. Dieser Abschnitt enthält eine Liste der Eigenschaften, die von der ServiceNow-Quelle unterstützt werden.

ServiceNow als Quelle

Legen Sie zum Kopieren von Daten aus ServiceNow den Quelltyp in der Copy-Aktivität auf ServiceNowV2Source fest. Folgende Eigenschaften werden im Abschnitt source der Kopieraktivität unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die type-Eigenschaft der Quelle der Copy-Aktivität muss auf ServiceNowV2Source festgelegt werden. Ja
expression Verwenden Sie den Ausdruck zum Lesen von Daten. Sie können den Ausdruck im Abfrage-Generator konfigurieren. Die Verwendung entspricht der des Bedingungs-Generators in ServiceNow. Anweisungen zur Verwendung finden Sie in diesem Artikel. Sie können auch Ausdrucksparameter verwenden. No
Unter expression
Typ Der Ausdruckstyp. Mögliche Werte sind Constant (Standardwert), Unary, Binary, Field und Nary. No
value Der konstante Wert. Ja, wenn der Ausdruckstyp „Constant“ oder „Field“ ist
– Operatoren Der Operatorwert. Weitere Informationen zu Operatoren finden Sie im Abschnitt Verfügbare Operatoren für Auswahlfelder mit Zeichenfolgen in diesem Artikel. Ja, wenn der Ausdruckstyp „Unary“ oder „Binary“ ist
Operanden Liste der Ausdrücke, auf die der Operator angewandt wird. Ja, wenn der Ausdruckstyp „Unary“ oder „Binary“ ist

Beispiel:

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

Verwenden von Ausdrucksparametern

Sie können den Ausdrucksparameter im Abfrage-Generator konfigurieren, indem Sie Dynamischen Inhalt hinzufügen auswählen. Der Parametertyp sollte Object sein, und der Wert sollte das Format im folgenden JSON-Beispiel aufweisen:

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

Nachfolgend sehen Sie ein Beispiel für den JSON-Quellcode mit dem Ausdrucksparameter:

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

Eigenschaften der Lookup-Aktivität

Ausführliche Informationen zu den Eigenschaften finden Sie unter Lookup-Aktivität.

Aktualisieren des ServiceNow-Connectors

Die Schritte helfen Ihnen beim Upgraden Ihres ServiceNow-Connectors:

  1. Erstellen Sie einen neuen verknüpften Dienst mithilfe der Informationen unter Eigenschaften verknüpfter Dienste.
  2. Die Abfrage in der Quelle wird auf den Abfrage-Generator aktualisiert, der wie der Bedingungs-Generator in ServiceNow verwendet wird. Erfahren Sie, wie Sie ihn so konfigurieren, dass auf ServiceNow als Quelle verwiesen wird.

Unterschiede zwischen ServiceNow und ServiceNow (Legacy)

Der ServiceNow-Connector bietet neue Funktionen und ist mit den meisten Features des ServiceNow-Connectors (Legacy) kompatibel. Die folgende Tabelle zeigt Featureunterschiede zwischen ServiceNow und ServiceNow (Legacy).

ServiceNow ServiceNow (Legacy)
useEncryptedEndpoints, useHostVerification und usePeerVerification werden im verknüpften Dienst nicht unterstützt. useEncryptedEndpoints, useHostVerification und usePeerVerification werden im verknüpften Dienst unterstützt.
Unterstützung des Abfrage-Generators in der Quelle. Der Abfrage-Generator wird in der Quelle nicht unterstützt.
SQL-basierte Abfragen werden nicht unterstützt. SQL-basierte Abfragen werden unterstützt.
sortBy-Abfragen werden im Abfrage-Generator nicht unterstützt. sortBy-Abfragen werden in Abfragen unterstützt.
Sie können das Schema im Dataset anzeigen. Sie können das Schema im Dataset nicht anzeigen.

Zugehöriger Inhalt

Eine Liste der Datenspeicher, die als Quelles und Senken für die Kopieraktivität unterstützt werden, finden Sie in der Dokumentation für Unterstützte Datenspeicher.