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

2025-05-07

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

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.

Ważne

Łącznik serviceNow v2 zapewnia ulepszoną natywną obsługę usługi ServiceNow. Jeśli używasz łącznika ServiceNow V1 w swoim rozwiązaniu, zaleca się uaktualnienie łącznika usługi ServiceNow przed 30 czerwca 2025 r. Zapoznaj się z tą sekcją , aby uzyskać szczegółowe informacje na temat różnic między wersjami V2 i V1.

Obsługiwane możliwości

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

Obsługiwane możliwości	IR
działanie kopiowania (źródło/-)	(1) (2)
Działanie wyszukiwania	(1) (2)

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

Warunek wstępny

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

Wprowadzenie

Aby wykonać czynność kopiowania za pomocą rurociągu kontrolnego, możesz użyć jednego z następujących narzędzi lub SDK:

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.

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
Wyszukaj ServiceNow i wybierz łącznik ServiceNow.
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:

Właściwości	Opis	Wymagane
typ	Właściwość type musi być ustawiona na: ServiceNowV2	Tak
punkt końcowy	Punkt końcowy serwera ServiceNow (`http://<instance>.service-now.com`).	Tak
typ uwierzytelniania	Typ uwierzytelniania do użycia. Dozwolone wartości to: Basic, OAuth2	Tak
nazwa użytkownika	Nazwa użytkownika używana do nawiązywania połączenia z serwerem ServiceNow na potrzeby uwierzytelniania podstawowego i OAuth2.	Tak
hasło	Hasło odpowiadające nazwie użytkownika uwierzytelniania podstawowego i OAuth2. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault.	Tak
clientId (identyfikator klienta)	Identyfikator klienta uwierzytelniania OAuth2.	Tak w przypadku uwierzytelniania OAuth
tajemnica klienta	Tajemnica klienta dla uwierzytelniania OAuth2. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault.	Tak w przypadku uwierzytelniania OAuth
typ_grantu	Określa typ przepływu OAuth2.0, którego aplikacja kliencka używa do uzyskiwania dostępu do tokenu. Wartość domyślna to hasło.	Tak w przypadku uwierzytelniania OAuth

Przykład:

{
    "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:

Właściwości	Opis	Wymagane
typ	Właściwość type zestawu danych musi być ustawiona na: ServiceNowV2Object	Tak
nazwaTabeli	Nazwa tabeli.	Tak
typ wartości	Typ wartości tabeli ServiceNow. Wartość tej właściwości może być `display` lub `actual` (wartość domyślna). Można to traktować jako parametr `sysparm_display_value` o wartości true lub false podczas wywoływania interfejsów API REST usługi ServiceNow.	Nie.

Przykład

{
    "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:

Właściwości	Opis	Wymagane
typ	Właściwość typu źródła działania kopiowania musi być ustawiona na: ServiceNowV2Source	Tak
wyrażenie	Użyj wyrażenia, aby odczytać dane. Wyrażenie można skonfigurować w konstruktorze zapytań. Ma takie samo zastosowanie jak konstruktor warunków w ServiceNow. Aby uzyskać instrukcje dotyczące korzystania z niego, zobacz ten artykuł. Można również użyć parametrów wyrażeń. Należy pamiętać, że należy użyć wartości rzeczywistej zamiast wartości wyświetlanej.	Nie.
Pod `expression`
typ	Typ wyrażenia. Wartości mogą być stałe (domyślne), jednoargumentowe, binarne, pola i nary.	Nie.
wartość	Stała wartość.	Tak, gdy typ wyrażenia ma wartość Stała lub Pole
operatory	Wartość operatora. Aby uzyskać więcej informacji na temat operatorów, zobacz Operatory dostępne dla pól wyboru zawierających sekcję ciągów w tym artykule.	Tak, gdy typ wyrażenia jest jednoargumentowy lub binarny
Operandy	Lista wyrażeń, na których jest stosowany operator.	Tak, gdy typ wyrażenia jest jednoargumentowy lub binarny

Rozmiar strony	Liczba dokumentów na stronę wyniku zapytania.	Nie. (wartość domyślna to 300)

Przykład:

"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:

Utwórz nową połączoną usługę, odwołując się do właściwości połączonej usługi.
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.

ServiceNow V2	ServiceNow V1
useEncryptedEndpoints, useHostVerification i usePeerVerification nie są obsługiwane w połączonej usłudze.	Obsługa useEncryptedEndpoints, useHostVerification i usePeerVerification w połączonej usłudze.
Obsługa konstruktora zapytań w źródle.	Konstruktor zapytań nie jest obsługiwany w źródle.
Zapytania oparte na języku SQL nie są obsługiwane.	Obsługa zapytań opartych na języku SQL.
Zapytania sortBy nie są obsługiwane w konstruktorze zapytań.	Obsługa zapytań sortBy w zapytaniu.
Schemat można wyświetlić w zestawie danych.	Nie można wyświetlić schematu w zestawie danych.
Można skonfigurować `valueType` do `display` lub `actual` w zestawach danych. Jako wartość `tableName` używana jest wyświetlana lub aktualna nazwa tabeli. Nazwa kolumny jest `[column name]` zarówno dla wartości wyświetlanej, jak i rzeczywistej.	Wyświetlana lub rzeczywista nazwa tabeli z dołączonym prefiksem "Display" lub "Actual" jest używana jako wartość `tableName`. Nazwa kolumny dla wartości rzeczywistej to `[column name]_value`, a dla wartości wyświetlanej to `[column name]_display_value`.

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