Kopírování dat z ServiceNow pomocí Azure Data Factory nebo Synapse Analytics
PLATÍ PRO: Azure Data Factory Azure Synapse Analytics
Tip
Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.
Tento článek popisuje, jak pomocí aktivity kopírování v kanálech Azure Data Factory a Synapse Analytics kopírovat data z ServiceNow. Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.
Důležité
Nový konektor ServiceNow poskytuje vylepšenou nativní podporu ServiceNow. Pokud ve svém řešení používáte starší konektor ServiceNow, doporučujeme nejdříve upgradovat konektor ServiceNow. Podrobnosti o rozdílu mezi starší verzí a nejnovější verzí najdete v této části .
Podporované funkce
Tento konektor ServiceNow je podporovaný pro následující funkce:
Podporované funkce | IR |
---|---|
aktivita Copy (zdroj/-) | (1) (2) |
Aktivita Lookup | (1) (2) |
(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime
Seznam úložišť dat podporovaných jako zdroje nebo jímky najdete v tabulce Podporované úložiště dat.
Služba poskytuje integrovaný ovladač, který umožňuje připojení. Proto nemusíte ručně instalovat žádný ovladač pomocí tohoto konektoru.
Místo zobrazené hodnoty v ServiceNow použijte skutečnou hodnotu.
Požadavek
Pokud chcete tento konektor použít, musíte mít roli s alespoň přístupem pro čtení pro sys_db_object a sys_dictionary tabulky ve službě ServiceNow.
Začínáme
K provedení aktivita Copy s kanálem můžete použít jeden z následujících nástrojů nebo sad SDK:
- Nástroj pro kopírování dat
- Azure Portal
- Sada .NET SDK
- Sada Python SDK
- Azure PowerShell
- Rozhraní REST API
- Šablona Azure Resource Manageru
Vytvoření propojené služby do ServiceNow pomocí uživatelského rozhraní
Pomocí následujícího postupu vytvořte propojenou službu serviceNow v uživatelském rozhraní webu Azure Portal.
Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:
Vyhledejte ServiceNow a vyberte konektor ServiceNow.
Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.
Podrobnosti konfigurace konektoru
Následující části obsahují podrobnosti o vlastnostech, které slouží k definování entit služby Data Factory specifických pro konektor ServiceNow.
Vlastnosti propojené služby
Pro propojenou službu ServiceNow se podporují následující vlastnosti:
Vlastnost | Popis | Povinní účastníci |
---|---|---|
type | Vlastnost typu musí být nastavená na: ServiceNowV2. | Ano |
endpoint | Koncový bod serveru ServiceNow (http://<instance>.service-now.com ). |
Ano |
authenticationType | Typ ověřování, který se má použít. Povolené hodnoty jsou: Basic, OAuth2 |
Ano |
username | Uživatelské jméno použité pro připojení k serveru ServiceNow pro základní ověřování a ověřování OAuth2. | Ano |
Heslo | Heslo odpovídající uživatelskému jménu pro ověřování Basic a OAuth2. Označte toto pole jako securestring, abyste ho mohli bezpečně uložit, nebo odkazovat na tajný klíč uložený ve službě Azure Key Vault. | Ano |
clientId | ID klienta pro ověřování OAuth2. | Ano pro ověřování OAuth |
clientSecret | Tajný klíč klienta pro ověřování OAuth2. Označte toto pole jako securestring, abyste ho mohli bezpečně uložit, nebo odkazovat na tajný klíč uložený ve službě Azure Key Vault. | Ano pro ověřování OAuth |
grantType | Určuje typ toku OAuth2.0, který klientská aplikace používá pro přístup k tokenu. Výchozí hodnota je heslo. | Ano pro ověřování OAuth |
Příklad:
{
"name": "ServiceNowLinkedService",
"properties": {
"type": "ServiceNowV2",
"typeProperties": {
"endpoint" : "http://<instance>.service-now.com",
"authenticationType" : "Basic",
"username" : "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
Vlastnosti datové sady
Úplný seznam oddílů a vlastností dostupných pro definování datových sad najdete v článku o datových sadách . Tato část obsahuje seznam vlastností podporovaných datovou sadou ServiceNow.
Pokud chcete kopírovat data z ServiceNow, nastavte vlastnost typu datové sady na ServiceNowV2Object. Podporují se následující vlastnosti:
Vlastnost | Popis | Povinní účastníci |
---|---|---|
type | Vlastnost typu datové sady musí být nastavena na: ServiceNowV2Object. | Ano |
tableName | Název tabulky. | Ano |
Příklad
{
"name": "ServiceNowDataset",
"properties": {
"type": "ServiceNowV2Object",
"typeProperties": {
"tableName": "<table name>"
},
"schema": [],
"linkedServiceName": {
"referenceName": "<ServiceNow linked service name>",
"type": "LinkedServiceReference"
}
}
}
Vlastnosti aktivity kopírování
Úplný seznam oddílů a vlastností dostupných pro definování aktivit najdete v článku Pipelines . Tato část obsahuje seznam vlastností podporovaných zdrojem ServiceNow.
ServiceNow jako zdroj
Pokud chcete kopírovat data z ServiceNow, nastavte typ zdroje v aktivitě kopírování na ServiceNowV2Source. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:
Vlastnost | Popis | Povinní účastníci |
---|---|---|
type | Vlastnost typu zdroje aktivity kopírování musí být nastavena na: ServiceNowV2Source. | Ano |
výraz | Pomocí výrazu můžete číst data. Výraz můžete nakonfigurovat v Tvůrci dotazů. Má stejné využití jako tvůrce podmínek v ServiceNow. Pokyny k jeho použití najdete v tomto článku. | No |
Pod expression |
||
type | Typ výrazu. Hodnoty můžou být konstanta (výchozí), unární, binární a pole. | No |
hodnota | Konstantní hodnota. | Ano, pokud je typ výrazu Konstantní nebo Pole |
operátory | Hodnota operátoru. Další informace o operátorech naleznete v části Operátory dostupné pro pole voleb obsahující řetězce v tomto článku. | Ano, pokud je typ výrazu unární nebo binární |
operandy | Seznam výrazů, u kterých je operátor použit. | Ano, pokud je typ výrazu unární nebo binární |
Příklad:
"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>"
}
}
}
]
Vlastnosti aktivity vyhledávání
Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.
Upgrade konektoru ServiceNow
Tady jsou kroky, které vám pomůžou upgradovat konektor ServiceNow:
- Vytvořte novou propojenou službu odkazem na vlastnosti propojené služby.
- Dotaz ve zdroji se upgraduje na Tvůrce dotazů, který má stejné použití jako tvůrce podmínek ve službě ServiceNow. Zjistěte, jak ho nakonfigurovat tak, aby odkazoval na ServiceNow jako zdroj.
Rozdíly mezi ServiceNow a ServiceNow (starší verze)
Konektor ServiceNow nabízí nové funkce a je kompatibilní s většinou funkcí konektoru ServiceNow (starší verze). Následující tabulka ukazuje rozdíly mezi ServiceNow a ServiceNow (starší verze).
ServiceNow | ServiceNow (starší verze) |
---|---|
PoužitíEncryptedEndpoints, useHostVerification a usePeerVerification nejsou podporovány v propojené službě. | Podpora useEncryptedEndpoints, useHostVerification a usePeerVerification v propojené službě. |
Podpora Tvůrce dotazů ve zdroji | Tvůrce dotazů není ve zdroji podporován. |
Dotazy založené na SQL nejsou podporovány. | Podpora dotazů založených na SQL |
Tvůrce dotazů nepodporuje dotazy sortBy. | Podpora dotazů sortBy v dotazu |
Schéma můžete zobrazit v datové sadě. | Schéma v datové sadě nemůžete zobrazit. |
Související obsah
Seznam úložišť dat podporovaných jako zdroje a jímky aktivitou kopírování najdete v podporovaných úložištích dat.