Gegevens kopiëren uit ServiceNow V1 met behulp van Azure Data Factory of Synapse Analytics

Artikel
10/16/2024

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u de kopieeractiviteit in Azure Data Factory- en Synapse Analytics-pijplijnen gebruikt om gegevens van ServiceNow te kopiëren. Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Belangrijk

De ServiceNow V2-connector biedt verbeterde systeemeigen ServiceNow-ondersteuning. Als u de ServiceNow V1-connector in uw oplossing gebruikt, wordt u aangeraden om uw ServiceNow-connector zo snel mogelijk bij te werken. Raadpleeg deze sectie voor meer informatie over het verschil tussen V2 en V1.

Ondersteunde mogelijkheden

Deze ServiceNow-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden	IR
Copy-activiteit (bron/-)	(1) (2)
Activiteit Lookup	(1) (2)

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

De service biedt een ingebouwd stuurprogramma om connectiviteit mogelijk te maken. Daarom hoeft u geen stuurprogramma handmatig te installeren met deze connector.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

Een gekoppelde service maken voor ServiceNow met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor ServiceNow in de gebruikersinterface van Azure Portal.

Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:
- Azure Data Factory
- Azure Synapse
Zoek naar ServiceNow en selecteer de ServiceNow-connector.
Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

Configuratiedetails van connector

De volgende secties bevatten details over eigenschappen die worden gebruikt voor het definiëren van Data Factory-entiteiten die specifiek zijn voor de ServiceNow-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde ServiceNow-service:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap moet worden ingesteld op: ServiceNow	Ja
endpoint	Het eindpunt van de ServiceNow-server (`http://<instance>.service-now.com`).	Ja
authenticationType	Het verificatietype dat moet worden gebruikt. Toegestane waarden zijn: Basic, OAuth2	Ja
gebruikersnaam	De gebruikersnaam die wordt gebruikt om verbinding te maken met de ServiceNow-server voor Basic- en OAuth2-verificatie.	Ja
password	Het wachtwoord dat overeenkomt met de gebruikersnaam voor Basis- en OAuth2-verificatie. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault.	Ja
clientId	De client-id voor OAuth2-verificatie.	Nee
clientSecret	Het clientgeheim voor OAuth2-verificatie. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault.	Nee
useEncryptedEndpoints	Hiermee geeft u op of de eindpunten van de gegevensbron zijn versleuteld met HTTPS. De standaardwaarde is waar.	Nee
useHostVerification	Hiermee geeft u op of de hostnaam in het certificaat van de server moet overeenkomen met de hostnaam van de server wanneer u verbinding maakt via TLS. De standaardwaarde is waar.	Nee
usePeerVerification	Hiermee geeft u op of de identiteit van de server moet worden gecontroleerd bij het maken van verbinding via TLS. De standaardwaarde is waar.	Nee

Voorbeeld:

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

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de ServiceNow-gegevensset.

Als u gegevens van ServiceNow wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op ServiceNowObject. De volgende eigenschappen worden ondersteund:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de gegevensset moet zijn ingesteld op: ServiceNowObject	Ja
tableName	Naam van de tabel.	Nee (als 'query' in de activiteitsbron is opgegeven)

Voorbeeld

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

Eigenschappen van de kopieeractiviteit

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de ServiceNow-bron.

ServiceNow als bron

Als u gegevens van ServiceNow wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op ServiceNowSource. De volgende eigenschappen worden ondersteund in de sectie bron van kopieeractiviteit:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: ServiceNowSource	Ja
query	Gebruik de aangepaste SQL-query om gegevens te lezen. Voorbeeld: `"SELECT * FROM Actual.alm_asset"`.	Nee (als 'tableName' in de gegevensset is opgegeven)

Let op het volgende bij het opgeven van het schema en de kolom voor ServiceNow in de query en raadpleeg prestatietips voor het kopiëren van prestaties.

Schema: geef het schema op als Actual of Display in de ServiceNow-query, die u kunt bekijken als de parameter waar of onwaar bij het aanroepen van sysparm_display_valueServiceNow REST API's.
Kolom: de kolomnaam voor de werkelijke waarde onder Actual schema is [column name]_value, terwijl voor weergavewaarde onder Display schema .[column name]_display_value Let op: de kolomnaam moet worden toegewezen aan het schema dat in de query wordt gebruikt.

Voorbeeldquery:SELECT col_value FROM Actual.alm_asset OR SELECT col_display_value FROM Display.alm_asset

Voorbeeld:

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

Prestatietips

Schema dat moet worden gebruikt

ServiceNow heeft twee verschillende schema's, een is 'Werkelijk' die werkelijke gegevens retourneert, de andere is 'Display' die de weergavewaarden van gegevens retourneert.

Als u een filter in uw query hebt, gebruikt u het werkelijke schema met betere kopieerprestaties. Bij het uitvoeren van query's op het werkelijke schema, ondersteunt ServiceNow systeemeigen het filter bij het ophalen van de gegevens om alleen de gefilterde resultatenset te retourneren, terwijl ADF bij het uitvoeren van query's op 'Display'-schema alle gegevens ophaalt en intern filter toepast.

Index

ServiceNow-tabelindex kan helpen bij het verbeteren van de queryprestaties. Raadpleeg een tabelindex maken.

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.

Delen via

Gegevens kopiëren uit ServiceNow V1 met behulp van Azure Data Factory of Synapse Analytics

Ondersteunde mogelijkheden

Aan de slag

Een gekoppelde service maken voor ServiceNow met behulp van de gebruikersinterface

Configuratiedetails van connector

Eigenschappen van gekoppelde service

Eigenschappen van gegevensset

Eigenschappen van de kopieeractiviteit

ServiceNow als bron

Prestatietips

Schema dat moet worden gebruikt

Index

Eigenschappen van opzoekactiviteit

Feedback

Aanvullende resources

Delen via

Gegevens kopiëren uit ServiceNow V1 met behulp van Azure Data Factory of Synapse Analytics

Ondersteunde mogelijkheden

Aan de slag

Een gekoppelde service maken voor ServiceNow met behulp van de gebruikersinterface

Configuratiedetails van connector

Eigenschappen van gekoppelde service

Eigenschappen van gegevensset

Eigenschappen van de kopieeractiviteit

ServiceNow als bron

Prestatietips

Schema dat moet worden gebruikt

Index

Eigenschappen van opzoekactiviteit

Gerelateerde inhoud

Feedback

Aanvullende resources