Kopiowanie danych z usługi ServiceNow przy użyciu usługi Azure Data Factory lub Synapse Analytics
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
Nowy łącznik usługi ServiceNow zapewnia ulepszoną natywną obsługę usługi ServiceNow. Jeśli używasz starszego łącznika usługi ServiceNow w swoim rozwiązaniu, zalecamy uaktualnienie łącznika usługi ServiceNow najwcześniejszą wygodą. Zapoznaj się z tą sekcją , aby uzyskać szczegółowe informacje na temat różnicy między starszą i najnowszą wersją.
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/-) | (1) (2) |
| Działanie Lookup | (1) (2) |
(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.
Użyj wartości rzeczywistej zamiast wyświetlanej wartości w usłudze ServiceNow.
Warunek wstępny
Aby użyć tego łącznika, musisz mieć rolę z co najmniej dostępem do odczytu w celu sys_db_object i sys_dictionary tabel w usłudze ServiceNow.
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.
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:
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 łą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 | Wymagania |
|---|---|---|
| type | Właściwość type musi być ustawiona na: ServiceNowV2 | 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. | Tak w przypadku uwierzytelniania OAuth |
| 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. | Tak w przypadku uwierzytelniania OAuth |
| grantType | 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 | Wymagania |
|---|---|---|
| type | Właściwość type zestawu danych musi być ustawiona na: ServiceNowV2Object | Tak |
| tableName | Nazwa tabeli. | Tak |
Przykład
{
"name": "ServiceNowDataset",
"properties": {
"type": "ServiceNowV2Object",
"typeProperties": {
"tableName": "<table name>"
},
"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 ServiceNowV2Source. 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: ServiceNowV2Source | Tak |
| wyrażenie | Użyj wyrażenia, aby odczytać dane. Wyrażenie można skonfigurować w konstruktorze zapytań. Ma to samo użycie co konstruktor warunku w usłudze ServiceNow. Aby uzyskać instrukcje dotyczące korzystania z niego, zobacz ten artykuł. Można również użyć parametrów wyrażeń. | Nie. |
Pod expression |
||
| type | 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 |
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"
}
]
}
},
"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 i usługą ServiceNow (starsza wersja)
Łącznik usługi ServiceNow oferuje nowe funkcje i jest zgodny z większością funkcji łącznika ServiceNow (starsza wersja). W poniższej tabeli przedstawiono różnice funkcji między usługą ServiceNow i usługą ServiceNow (starsza wersja).
| ServiceNow | ServiceNow (starsza wersja) |
|---|---|
| useEncryptedEndpoints, useHostVerification i usePeerVerification nie są obsługiwane w połączonej usłudze. | Obsługa użyciaEncryptedEndpoints, 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. |
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.