Kopiera data från Concur med hjälp av Azure Data Factory eller Synapse Analytics (förhandsversion)

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

Tips

Data Factory i Microsoft Fabric är nästa generations Azure Data Factory, med en enklare arkitektur, inbyggd AI och nya funktioner. Om dataintegrering är nytt för dig börjar du med Fabric Data Factory. Befintliga ADF-arbetsbelastningar kan uppgraderas till Fabric för att få åtkomst till nya funktioner inom datavetenskap, realtidsanalys och rapportering.

Viktigt!

Den här anslutningsappen är i slutet av supportfasen. Du rekommenderas att migrera till ODBC-anslutningsprogrammet genom att installera en drivrutin.

Den här artikeln beskriver hur du använder kopieringsaktiviteten i en Azure Data Factory- eller Synapse Analytics-pipeline för att kopiera data från Concur. Den bygger på artikeln kopieringsaktivitet översikt som ger en allmän bild av kopieringsaktivitet.

Funktioner som stöds

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

Funktioner som stöds IR
Copy activity (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.

Anslutningen stöder Windows-versioner i den här artikeln.

Kommentar

Partnerkontot stöds för närvarande inte.

Komma igång

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

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

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

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

  2. Sök efter Concur och välj Concur-anslutningsappen.

    Skärmbild av Concur-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 Concur.

Konfigurationsdetaljer för anslutning

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

Länkade tjänstegenskaper

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

Egenskap Beskrivning Obligatoriskt
typ Typegenskapen måste anges till: Concur Ja
anslutningsegenskaper En grupp med egenskaper som definierar hur du ansluter till Concur. Ja
Under connectionProperties:
autentiseringstyp Tillåtna värden är OAuth_2.0_Bearer och OAuth_2.0 (äldre). Autentiseringsalternativet OAuth 2.0 fungerar med det gamla Concur-API:et som har varit inaktuellt sedan februari 2017. Ja
värd Slutpunkten för Concur-servern, t.ex. implementation.concursolutions.com. Ja
baseUrl Bas-URL:en för din Concurs auktoriserings-URL. Ja för OAuth_2.0_Bearer autentisering
clientId Programklient-ID som tillhandahålls av Concur App Management. Ja
klienthemlighet Klienthemligheten som motsvarar klient-ID:t. Markera det här fältet som en SecureString för att lagra det på ett säkert sätt, eller referera en hemlighet som lagras i Azure Key Vault. Ja för OAuth_2.0_Bearer autentisering
användarnamn Det användarnamn som du använder för att få åtkomst till Concur-tjänsten. Ja
lösenord Lösenordet som motsvarar användarnamnet som du angav i användarnamnsfältet. Markera det här fältet som en SecureString för att lagra det på ett säkert sätt, eller referera en hemlighet som lagras i Azure Key Vault. Ja
användKrypteradeSlutpunkter 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": "ConcurLinkedService", 
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "connectionProperties": {
                "host":"<host e.g. implementation.concursolutions.com>",
                "baseUrl": "<base URL for authorization e.g. us-impl.api.concursolutions.com>",
                "authenticationType": "OAuth_2.0_Bearer",
                "clientId": "<client id>",
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "username": "fakeUserName",
                "password": {
                    "type": "SecureString",
                    "value": "<password>"
                },
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
} 

Exempel (äldre):

Observera att följande är en äldre länkad tjänstmodell utan connectionProperties och med OAuth_2.0 autentisering.

{
    "name": "ConcurLinkedService",
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "clientId" : "<clientId>",
            "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 Concur-datauppsättningen.

Om du vill kopiera data från Concur anger du datamängdens typegenskap till ConcurObject. Det finns ingen ytterligare typspecifik egenskap i den här typen av datauppsättning. Följande egenskaper stöds:

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

Exempel

{
    "name": "ConcurDataset",
    "properties": {
        "type": "ConcurObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Concur linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Egenskaper av kopieringsaktivitet

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 Concur-källan.

ConcurSource som källa

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

Egenskap Beskrivning Obligatoriskt
typ Typegenskapen för kopieringsaktivitetskällan måste anges till: ConcurSource Ja
query Använd den anpassade SQL-frågan för att läsa data. Exempel: "SELECT * FROM Opportunities where Id = xxx ". Nej (om "tableName" har angetts i datauppsättningen)

Exempel:

"activities":[
    {
        "name": "CopyFromConcur",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Concur input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ConcurSource",
                "query": "SELECT * FROM Opportunities where Id = xxx"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

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 under stödda datalager.