Copiare dati da ServiceNow V2 usando Azure Data Factory o Synapse Analytics

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Questo articolo illustra come usare l'attività Copy nelle pipeline di Azure Data Factory e Synapse Analytics per copiare dati da ServiceNow. Si basa sull'articolo di panoramica dell'attività di copia che presenta una panoramica generale dell'attività di copia.

Funzionalità supportate

Questo connettore ServiceNow è supportato per le funzionalità seguenti:

① Runtime di integrazione di Azure ② Runtime di integrazione autogestito

Per un elenco degli archivi dati supportati come origini/sink, vedere la tabella Archivi dati supportati .

Il servizio fornisce un driver predefinito per abilitare la connettività. Non è pertanto necessario installare manualmente un driver tramite questo connettore.

Prerequisito

Per usare questo connettore, è necessario avere un ruolo con almeno l'accesso in lettura alle tabelle sys_db_object e sys_dictionary in ServiceNow.

Introduzione

Per eseguire l'attività di copia con una pipeline, è possibile usare uno degli strumenti o SDK seguenti:

• Lo strumento Copia dati
• Portale di Azure
• The .NET SDK
• The Python SDK
• Azure PowerShell
• API REST
• Modello di Azure Resource Manager

Creare un servizio collegato a ServiceNow tramite l'interfaccia utente

Usare la procedura seguente per creare un servizio collegato a ServiceNow nell'interfaccia utente del portale di Azure.

1. Passare alla scheda Gestisci nell'area di lavoro di Azure Data Factory o Synapse e selezionare Servizi collegati, quindi fare clic su Nuovo:

   • Azure Data Factory
   • Azure Synapse

   

2. Cercare ServiceNow e selezionare il relativo connettore.

   

3. Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.

   

Dettagli di configurazione del connettore

Le sezioni seguenti riportano informazioni dettagliate sulle proprietà che vengono usate per definire entità di Data Factory specifiche per il connettore ServiceNow.

Proprietà del servizio collegato

Per il servizio collegato ServiceNow sono supportate le proprietà seguenti:

Esempio:

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

Proprietà del set di dati

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione dei set di dati, vedere l'articolo set di dati . Questa sezione presenta un elenco delle proprietà supportate dal set di dati di ServiceNow.

Per copiare dati da ServiceNow, impostare la proprietà type del set di dati su ServiceNowV2Object. Sono supportate le proprietà seguenti:

Esempio

{
    "name": "ServiceNowDataset",
    "properties": {
        "type": "ServiceNowV2Object",
        "typeProperties": {
            "tableName": "<table name>",
            "valueType": "actual"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ServiceNow linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Proprietà dell'attività di copia

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo Pipelines . Questa sezione presenta un elenco delle proprietà supportate dall'origine ServiceNow.

ServiceNow come origine

Per copiare dati da ServiceNow, impostare il tipo di origine nell'attività di copia su ServiceNowV2Source. Nella sezione origine dell'attività di copia sono supportate le proprietà seguenti:

Esempio:

"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"
                        }
                    ]
                },
                "pageSize": 300
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Uso dei parametri di espressione

È possibile configurare il parametro di espressione in Generatore query selezionando Aggiungi contenuto dinamico. Il tipo di parametro deve essere Object e il valore deve seguire il formato illustrato nell'esempio JSON seguente:

 {
	"type": "Nary",
	"operators": [
		"="
	],
	"operands": [
		{
			"type": "Field",
			"value": "col"
		},
		{
			"type": "Constant",
			"value": "val"
		}
	]
}

Di seguito è riportato un esempio del codice JSON di origine usando il parametro expression:

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

Proprietà dell'attività Lookup

Per informazioni dettagliate sulle proprietà, vedere Attività di ricerca.

Aggiornare il connettore ServiceNow

Ecco i passaggi che consentono di aggiornare il connettore ServiceNow:

1. Creare un nuovo servizio collegato facendo riferimento alle proprietà del servizio collegato.
2. La query nella fonte viene aggiornata a Generatore di query, che ha lo stesso utilizzo del generatore di condizioni in ServiceNow. Informazioni su come configurarla facendo riferimento a ServiceNow come origine.

Differenze tra ServiceNow V2 e V1

Il connettore ServiceNow V2 offre nuove funzionalità ed è compatibile con la maggior parte delle funzionalità del connettore ServiceNow V1. La tabella seguente illustra le differenze di funzionalità tra V2 e V1.

Contenuto correlato

Per un elenco degli archivi dati supportati come sorgenti e destinazioni dall'attività di copia, consultare archivi dati supportati.