Kopiowanie danych z usługi ServiceNow v1 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 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:

• Narzędzie do kopiowania danych
• Witryna Azure Portal
• Zestaw SDK platformy .NET
• Zestaw SDK języka Python
• Azure PowerShell
• Interfejs 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 ciąg 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:

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:

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:

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.

Powiązana zawartość

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