Kopiera data från ServiceNow med Hjälp av Azure Data Factory eller Synapse Analytics

Artikel
11/16/2023

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

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

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:

Funktioner som stöds	IR
aktiviteten Kopiera (källa/-)	① ②
Sökningsaktivitet	① ②

(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:

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 Användargränssnittet för Azure-portalen.

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
Sök efter ServiceNow och välj ServiceNow-anslutningsprogrammet.
Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

Anslut eller konfigurationsinformation

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:

Property	Beskrivning	Obligatoriskt
type	Typegenskapen måste anges till: ServiceNow	Ja
slutpunkt	Slutpunkten för ServiceNow-servern (`http://<instance>.service-now.com`).	Ja
authenticationType	Den autentiseringstyp som ska användas. Tillåtna värden är: Basic, OAuth2	Ja
användarnamn	Användarnamnet som används för att ansluta till ServiceNow-servern för Basic- och OAuth2-autentisering.	Ja
password	Lösenordet som motsvarar användarnamnet för Basic- och OAuth2-autentisering. Markera det här fältet som en SecureString för att lagra det på ett säkert sätt eller referera till en hemlighet som lagras i Azure Key Vault.	Ja
clientId	Klient-ID för OAuth2-autentisering.	Nej
clientSecret	Klienthemligheten för OAuth2-autentisering. Markera det här fältet som en SecureString för att lagra det på ett säkert sätt eller referera till en hemlighet som lagras i Azure Key Vault.	Nej
useEncryptedEndpoints	Anger om datakällans slutpunkter krypteras med HTTPS. Standardvärdet är sant.	Nej
useHostVerification	Anger om värdnamnet i serverns certifikat ska behövas för att matcha serverns värdnamn vid anslutning via TLS. Standardvärdet är sant.	Nej
usePeerVerification	Anger om serverns identitet ska verifieras vid anslutning via TLS. Standardvärdet är sant.	Nej

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:

Property	Beskrivning	Obligatoriskt
type	Datamängdens typegenskap måste anges till: ServiceNowObject	Ja
tableName	Tabellens namn.	Nej (om "fråga" i aktivitetskällan har angetts)

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:

Property	Beskrivning	Obligatoriskt
type	Typegenskapen för kopieringsaktivitetskällan måste anges till: ServiceNowSource	Ja
query	Använd den anpassade SQL-frågan för att läsa data. Exempel: `"SELECT * FROM Actual.alm_asset"`.	Nej (om "tableName" i datauppsättningen har angetts)

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.

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