Dela via

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

  • Artikel

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.

Viktigt!

Den nya ServiceNow-anslutningsappen ger förbättrat inbyggt ServiceNow-stöd. Om du använder den äldre ServiceNow-anslutningsappen i din lösning rekommenderar vi att du uppgraderar Din ServiceNow-anslutning så snart som möjligt. Mer information om skillnaden mellan den äldre och den senaste versionen finns i det här avsnittet .

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/-) (1) (2)
Sökningsaktivitet (1) (2)

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

Använd det faktiska värdet i stället för det visade värdet i ServiceNow.

Förutsättningar

Om du vill använda den här anslutningsappen måste du ha en roll med minst läsbehörighet till sys_db_object - och sys_dictionary-tabeller i ServiceNow.

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

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

    Skärmbild av ServiceNow-anslutningsappen.

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

    Skärmbild av konfiguration av länkad tjänst för ServiceNow.

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:

Property Beskrivning Obligatoriskt
type Typegenskapen måste anges till: ServiceNowV2 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. Ja för OAuth-autentisering
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. Ja för OAuth-autentisering
grantType Anger vilken typ av OAuth2.0-flöde som klientappen använder för att komma åt token. Standardvärdet är lösenord. Ja för OAuth-autentisering

Exempel:

{
    "name": "ServiceNowLinkedService",
    "properties": {
        "type": "ServiceNowV2",
        "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 ServiceNowV2Object. Följande egenskaper stöds:

Property Beskrivning Obligatoriskt
type Typegenskapen för datauppsättningen måste anges till: ServiceNowV2Object Ja
tableName Tabellens namn. Ja

Exempel

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowV2Object",
        "typeProperties": {
            "tableName": "<table name>"
        },
        "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 ServiceNowV2Source. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:

Property Beskrivning Obligatoriskt
type Typegenskapen för kopieringsaktivitetskällan måste anges till: ServiceNowV2Source Ja
uttryck Använd uttrycket för att läsa data. Du kan konfigurera uttrycket i Query Builder. Den har samma användning som villkorsverktyget i ServiceNow. Anvisningar om hur du använder den finns i den här artikeln. Nej
Under expression
type Uttryckstypen. Värden kan vara Konstant (standard), Unary, Binary och Field. Nej
värde Konstantvärdet. Ja när uttryckstypen är Konstant eller Fält
Operatörer Operatorvärdet. Mer information om operatorer finns i Operatorer som är tillgängliga för valfält som innehåller strängar i den här artikeln. Ja när uttryckstypen är Unary eller Binary
Operander Lista över uttryck som operatorn tillämpas på. Ja när uttryckstypen är Unary eller Binary

Exempel:

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

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

Uppgradera ServiceNow-anslutningsappen

Här är de steg som hjälper dig att uppgradera din ServiceNow-anslutning:

  1. Skapa en ny länkad tjänst genom att referera till egenskaper för länkad tjänst.
  2. Frågan i källan uppgraderas till Query Builder, som har samma användning som villkorsverktyget i ServiceNow. Lär dig hur du konfigurerar det med hjälp av ServiceNow som källa.

Skillnader mellan ServiceNow och ServiceNow (äldre)

ServiceNow-anslutningsappen erbjuder nya funktioner och är kompatibel med de flesta funktioner i ServiceNow-anslutningsprogrammet (äldre). Tabellen nedan visar funktionsskillnaderna mellan ServiceNow och ServiceNow (äldre).

ServiceNow ServiceNow (äldre)
useEncryptedEndpoints, useHostVerification och usePeerVerification stöds inte i den länkade tjänsten. Support useEncryptedEndpoints, useHostVerification och usePeerVerification i den länkade tjänsten.
Support Query Builder i källan. Frågeverktyget stöds inte i källan.
SQL-baserade frågor stöds inte. Stöd för SQL-baserade frågor.
sortBy-frågor stöds inte i Query Builder. Stöd för sortBy-frågor i Fråga.
Du kan visa schemat i datauppsättningen. Du kan inte visa schemat i datauppsättningen.

Relaterat innehåll

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