Kopiowanie danych z usługi ServiceNow v2 przy użyciu usługi Azure Data Factory lub Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

W tym artykule opisano sposób używania działania kopiowania w potokach usługi Azure Data Factory i Synapse Analytics do kopiowania danych z usługi ServiceNow. Jest on oparty na artykule omówienie działania kopiowania , który przedstawia ogólne omówienie działania kopiowania.

Obsługiwane możliwości

Ten łącznik usługi ServiceNow jest obsługiwany w następujących możliwościach:

(1) Środowisko uruchomieniowe integracji Azure (2) Środowisko uruchomieniowe integracji lokalnej

Aby uzyskać listę magazynów danych obsługiwanych jako źródła/ujścia, zobacz tabelę Obsługiwane magazyny danych .

Usługa udostępnia wbudowany sterownik umożliwiający łączność. W związku z tym nie trzeba ręcznie instalować żadnego sterownika przy użyciu tego łącznika.

Prerequisite

Aby użyć tego łącznika, musisz mieć rolę z co najmniej dostępem do odczytu w celu sys_db_object, sys_db_view i tabel sys_dictionary w usłudze ServiceNow.

Aby uzyskać dostęp do widoków w usłudze ServiceNow, musisz mieć rolę z co najmniej dostępem do odczytu w celu sys_db_view_table i sys_db_view_table_field tabel.

Wprowadzenie

Aby wykonać działanie kopiowania za pomocą pipeline'u, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

• Narzędzie do kopiowania danych
• Portal Azure
• zestawu SDK platformy .NET
• Zestaw SDK dla języka Python
• Azure PowerShell
• API REST
• Szablon usługi Azure Resource Manager

Tworzenie połączonej usługi z usługą ServiceNow przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z usługą ServiceNow w interfejsie użytkownika witryny Azure Portal.

1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

   • Azure Data Factory
   • Azure Synapse

   

2. Wyszukaj ServiceNow i wybierz łącznik ServiceNow.

   

3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

   

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika usługi ServiceNow.

Właściwości połączonej usługi

Następujące właściwości są obsługiwane w przypadku połączonej usługi ServiceNow:

Example:

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

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych . Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych usługi ServiceNow.

Aby skopiować dane z usługi ServiceNow, ustaw właściwość type zestawu danych na ServiceNowV2Object. Obsługiwane są następujące właściwości:

Example

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

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines. Ta sekcja zawiera listę właściwości obsługiwanych przez źródło usługi ServiceNow.

Usługa ServiceNow jako źródło

Aby skopiować dane z usługi ServiceNow, ustaw typ źródła w działaniu kopiowania na ServiceNowV2Source. Następujące właściwości są obsługiwane w sekcji źródło działania kopiowania:

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

Używanie parametrów wyrażenia

Możesz skonfigurować parametr wyrażenia w konstruktorze zapytań , wybierając pozycję Dodaj zawartość dynamiczną. Typ parametru powinien mieć wartość Object (Obiekt), a wartość powinna być zgodna z formatem pokazanym w poniższym przykładzie JSON:

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

Oto przykład kodu JSON źródłowego przy użyciu parametru wyrażenia:

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

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Uaktualnianie łącznika usługi ServiceNow

Poniżej przedstawiono kroki ułatwiające uaktualnienie łącznika usługi ServiceNow:

1. Utwórz nową połączoną usługę, odwołując się do właściwości połączonej usługi.
2. Zapytanie w źródle zostało uaktualnione do konstruktora zapytań, który ma takie samo użycie jak konstruktor warunku w usłudze ServiceNow. Dowiedz się, jak skonfigurować usługę ServiceNow jako źródło.

Różnice między usługą ServiceNow V2 i V1

Łącznik serviceNow v2 oferuje nowe funkcje i jest zgodny z większością funkcji łącznika ServiceNow V1. W poniższej tabeli przedstawiono różnice funkcji między wersjami 2 i V1.

Treści powiązane

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.