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

Artykuł
11/16/2023

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.

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 Kopiuj (źródło/-)	① ②
Działanie Lookup	① ②

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

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.

Wprowadzenie

Aby wykonać działanie Kopiuj za pomocą potoku, możesz użyć jednego z następujących narzędzi lub zestawów 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 ciąg ServiceNow i wybierz łącznik ServiceNow.
Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

szczegóły konfiguracji Połączenie or

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	Wymagania
type	Właściwość type musi być ustawiona na: ServiceNow	Tak
endpoint	Punkt końcowy serwera ServiceNow (`http://<instance>.service-now.com`).	Tak
authenticationType	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 uwierzytelniania OAuth2.	Nie.
clientSecret	Wpis tajny klienta na potrzeby 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.	Nie.
useEncryptedEndpoints	Określa, czy punkty końcowe źródła danych są szyfrowane przy użyciu protokołu HTTPS. Wartość domyślna to true.	Nie.
useHostVerification	Określa, czy nazwa hosta w certyfikacie serwera ma być zgodna z nazwą hosta serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true.	Nie.
usePeerVerification	Określa, czy należy zweryfikować tożsamość serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true.	Nie.

Przykład:

{
    "name": "ServiceNowLinkedService",
    "properties": {
        "type": "ServiceNow",
        "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 ServiceNowObject. Obsługiwane są następujące właściwości:

Właściwości	Opis	Wymagania
type	Właściwość type zestawu danych musi być ustawiona na: ServiceNowObject	Tak
tableName	Nazwa tabeli.	Nie (jeśli określono "zapytanie" w źródle działania)

Przykład

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowObject",
        "typeProperties": {},
        "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 (Potoki ). 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 wartość ServiceNowSource. Następujące właściwości są obsługiwane w sekcji źródło działania kopiowania:

Właściwości	Opis	Wymagania
type	Właściwość type źródła działania kopiowania musi być ustawiona na: ServiceNowSource	Tak
zapytanie	Użyj niestandardowego zapytania SQL, aby odczytać dane. Na przykład: `"SELECT * FROM Actual.alm_asset"`.	Nie (jeśli określono "tableName" w zestawie danych)

Podczas określania schematu i kolumny dla usługi ServiceNow w zapytaniu zapoznaj się z poradami dotyczącymi wydajności kopiowania.

Schemat: określ schemat jako Actual lub Display w zapytaniu usługi ServiceNow, które można sprawdzić jako parametr sysparm_display_value true lub false podczas wywoływania interfejsów API REST usługi ServiceNow.
Kolumna: nazwa kolumny dla wartości rzeczywistej w Actual schemacie to [column name]_value, a wartość wyświetlana w Display schemacie to [column name]_display_value. Zwróć uwagę, że nazwa kolumny musi być mapowana na schemat używany w zapytaniu.

Przykładowe zapytanie:SELECT col_value FROM Actual.alm_asset OR SELECT col_display_value FROM Display.alm_asset

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": "ServiceNowSource",
                "query": "SELECT * FROM Actual.alm_asset"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Wskazówki dotyczące wydajności

Schemat do użycia

Usługa ServiceNow ma 2 różne schematy, jedna to "Rzeczywista" , która zwraca rzeczywiste dane, a druga to "Wyświetl" , która zwraca wartości wyświetlane danych.

Jeśli masz filtr w zapytaniu, użyj schematu "Rzeczywiste", który ma lepszą wydajność kopiowania. Podczas wykonywania zapytań względem schematu "Rzeczywiste" usługa ServiceNow natywnie obsługuje filtr podczas pobierania danych w celu zwrócenia tylko filtrowanego zestawu wyników, podczas gdy podczas wykonywania zapytania względem schematu "Wyświetlanie" usługa ADF pobiera wszystkie dane i stosuje filtr wewnętrznie.

Indeks

Indeks tabeli usługi ServiceNow może pomóc zwiększyć wydajność zapytań, zobacz Tworzenie indeksu tabeli.

Właściwości działania wyszukiwania

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

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