Kopiera data från ServiceNow V1 med Azure Data Factory eller Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Den här artikeln beskriver hur du använder pipelines för kopieringsaktivitet i Azure Data Factory och Synapse Analytics för att kopiera data från ServiceNow. Den bygger på översiktsartikeln för kopieringsaktivitet som visar en allmän översikt över kopieringsaktiviteten.

Funktioner som stöds

Den här ServiceNow-anslutningsappen stöds för följande funktioner:

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare finns i tabellen Datalager som stöds.

Tjänsten tillhandahåller en inbyggd drivrutin för att aktivera anslutning. Därför behöver du inte installera någon drivrutin manuellt med den här anslutningsappen.

Komma igång

Om du vill utföra aktiviteten Kopiera med en pipeline kan du använda något av följande verktyg eller SDK:er:

• Verktyget Kopiera data
• Azure-portalen
• The .NET SDK
• The Python SDK
• Azure PowerShell
• REST-API:et
• Azure Resource Manager-mallen

Skapa en länkad tjänst till ServiceNow med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till ServiceNow i Azure Portal användargränssnittet.

1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:

   • Azure Data Factory
   • Azure Synapse

   

2. Sök efter ServiceNow och välj ServiceNow-anslutningsprogrammet.

   

3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

   

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för ServiceNow-anslutningsprogrammet.

Länkade tjänstegenskaper

Följande egenskaper stöds för serviceNow-länkad tjänst:

Exempel:

{
    "name": "ServiceNowLinkedService",
    "properties": {
        "type": "ServiceNow",
        "typeProperties": {
            "endpoint" : "http://<instance>.service-now.com",
            "authenticationType" : "Basic",
            "username" : "<username>",
            "password": {
                 "type": "SecureString",
                 "value": "<password>"
            }
        }
    }
}

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av ServiceNow-datauppsättningen.

Om du vill kopiera data från ServiceNow anger du datauppsättningens typegenskap till ServiceNowObject. Följande egenskaper stöds:

Exempel

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ServiceNow linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av ServiceNow-källan.

ServiceNow som källa

Om du vill kopiera data från ServiceNow anger du källtypen i kopieringsaktiviteten till ServiceNowSource. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:

Observera följande när du anger schemat och kolumnen för ServiceNow i frågan och se Prestandatips om prestandakonsekvenser för kopiering.

• Schema: Ange schemat som Actual eller Display i ServiceNow-frågan, som du kan se det som parametern sysparm_display_value för som sant eller falskt när du anropar ServiceNow REST-API:er. 
• Kolumn: kolumnnamnet för det faktiska värdet under Actual schemat är [column name]_value, medan för visningsvärdet under Display schemat är [column name]_display_value. Observera att kolumnnamnet behöver mappas till schemat som används i frågan.

Exempelfråga:SELECT col_value FROM Actual.alm_asset OR SELECT col_display_value FROM Display.alm_asset

Exempel:

"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>"
            }
        }
    }
]

Prestandatips

Schema som ska användas

ServiceNow har 2 olika scheman, ett är "Actual" som returnerar faktiska data, det andra är "Display" som returnerar visningsvärdena för data.

Om du har ett filter i frågan använder du schemat "Actual" som har bättre kopieringsprestanda. Vid frågor mot "Faktiskt" schema stöder ServiceNow internt filter när du hämtar data för att endast returnera den filtrerade resultatuppsättningen, medan ADF hämtar alla data och tillämpar filtret internt när du frågar "Visa"-schema.

Index

ServiceNow-tabellindex kan hjälpa till att förbättra frågeprestanda, se Skapa ett tabellindex.

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

Relaterat innehåll

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.