Dela via


Kopiera data från Dynamics AX med Azure Data Factory eller Synapse Analytics

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 kopieringsaktivitet i Azure Data Factory- och Synapse Analytics-pipelines för att kopiera data från Dynamics AX-källan. Artikeln bygger på kopieringsaktivitet, som visar en allmän översikt över kopieringsaktivitet.

Funktioner som stöds

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

Funktioner som stöds IR
Kopieringsaktivitet (källa/-) (1) (2)
Sökningsaktivitet (1) (2)

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

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

Mer specifikt stöder den här Dynamics AX-anslutningsappen kopiering av data från Dynamics AX med OData-protokoll med autentisering med tjänstens huvudnamn.

Dricks

Du kan också använda den här anslutningsappen för att kopiera data från Dynamics 365 Finance and Operations. Se Dynamics 365:s OData-stöd och autentiseringsmetod.

Kom 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 Dynamics AX med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till Dynamics AX i azure-portalens användargränssnitt.

  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 Dynamics och välj Dynamics AX-anslutningsappen.

    Välj Dynamics AX-anslutningsappen.

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

    Konfigurera en länkad tjänst till Dynamics AX.

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som du kan använda för att definiera Data Factory-entiteter som är specifika för Dynamics AX-anslutningsappen.

Förutsättningar

Följ dessa steg om du vill använda autentisering med tjänstens huvudnamn:

  1. Registrera ett program med Microsoft Identity-plattformen. Mer information finns i Snabbstart: Registrera ett program med Microsoft platforma za identitete. Anteckna dessa värden som du använder för att definiera den länkade tjänsten:

    • Program-ID:t
    • Programnyckel
    • Klientorganisations-ID
  2. Gå till Dynamics AX och ge tjänstens huvudnamn rätt behörighet att komma åt din Dynamics AX.

Länkade tjänstegenskaper

Följande egenskaper stöds för den länkade Dynamics AX-tjänsten:

Property Beskrivning Obligatoriskt
type Typegenskapen måste vara inställd på DynamicsAX. Ja
URL Dynamics AX-instansen (eller Dynamics 365 Finance and Operations) OData-slutpunkten. Ja
servicePrincipalId Ange programmets klient-ID. Ja
servicePrincipalKey Ange programmets nyckel. 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
tenant Ange klientinformationen (domännamn eller klient-ID) som programmet finns under. Hämta den genom att hovra musen i det övre högra hörnet i Azure-portalen. Ja
aadResourceId Ange den AAD-resurs som du begär för auktorisering. Om din Dynamics-URL till exempel är https://sampledynamics.sandbox.operations.dynamics.com/data/är motsvarande AAD-resurs vanligtvis https://sampledynamics.sandbox.operations.dynamics.com. Ja
connectVia Integration Runtime som ska användas för att ansluta till datalagret. Du kan välja Azure Integration Runtime eller en lokalt installerad integrationskörning (om ditt datalager finns i ett privat nätverk). Om det inte anges används standardkörningen för Azure Integration Runtime. Nej

Exempel

{
    "name": "DynamicsAXLinkedService",
    "properties": {
        "type": "DynamicsAX",
        "typeProperties": {
            "url": "<Dynamics AX instance OData endpoint>",
            "servicePrincipalId": "<service principal id>",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<service principal key>"
            },
            "tenant": "<tenant info, e.g. microsoft.onmicrosoft.com>",
            "aadResourceId": "<AAD resource, e.g. https://sampledynamics.sandbox.operations.dynamics.com>"
        }
    },
    "connectVia": {
        "referenceName": "<name of Integration Runtime>",
        "type": "IntegrationRuntimeReference"
    }
}

Egenskaper för datauppsättning

Det här avsnittet innehåller en lista över egenskaper som Dynamics AX-datauppsättningen stöder.

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i Datauppsättningar och länkade tjänster.

Om du vill kopiera data från Dynamics AX anger du datamängdens typegenskap till DynamicsAXResource. Följande egenskaper stöds:

Property Beskrivning Obligatoriskt
type Datamängdens typegenskap måste anges till DynamicsAXResource. Ja
path Sökvägen till Dynamics AX OData-entiteten. Ja

Exempel

{
    "name": "DynamicsAXResourceDataset",
    "properties": {
        "type": "DynamicsAXResource",
        "typeProperties": {
            "path": "<entity path e.g. dd04tentitySet>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Dynamics AX linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Egenskaper för kopieringsaktivitet

Det här avsnittet innehåller en lista över egenskaper som Dynamics AX-källan stöder.

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i Pipelines.

Dynamics AX som källa

Om du vill kopiera data från Dynamics AX anger du källtypen i Kopiera aktivitet till DynamicsAXSource. Följande egenskaper stöds i avsnittet Kopieringsaktivitetskälla:

Property Beskrivning Obligatoriskt
type Typegenskapen för kopieringsaktivitetskällan måste anges till DynamicsAXSource. Ja
query OData-frågealternativ för filtrering av data. Exempel: "?$select=Name,Description&$top=5".

Obs! Anslutningsappen kopierar data från den kombinerade URL:en: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source]. Mer information finns i OData-URL-komponenter.
Nej
httpRequestTimeout Tidsgränsen (TimeSpan-värdet ) för HTTP-begäran för att få ett svar. Det här värdet är tidsgränsen för att få ett svar, inte tidsgränsen för att läsa svarsdata. Om det inte anges är standardvärdet 00:05:00 (5 minuter). Nej

Exempel

"activities":[
    {
        "name": "CopyFromDynamicsAX",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Dynamics AX input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "DynamicsAXSource",
                "query": "$top=10"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

En lista över datalager som kopieringsaktivitet stöder som källor och mottagare finns i Datalager och format som stöds.