Copiare dati da Dynamics AX usando Azure Data Factory o Synapse Analytics

APPLICABILE A: Azure Data Factory Azure Synapse Analytics

Questo articolo illustra come usare l'attività di copia nelle pipeline di Azure Data Factory e Synapse Analytics per copiare dati dall'origine Dynamics AX. L'articolo è basato su Attività Copy, dove viene presentata una panoramica generale dell'attività Copy.

Funzionalità supportate

Questo connettore Dynamics AX è supportato per le funzionalità seguenti:

(1) Runtime di integrazione Azure (2) Runtime di integrazione self-hosted

Per un elenco degli archivi dati supportati come origini e sink, vedere archivi dati supportati.

In particolare, questo connettore Dynamics AX supporta la copia di dati da Dynamics AX usando il protocollo OData con l'autenticazione Service Principal.

Inizia

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

• Strumento Copia Dati
• portale Azure
• .NET SDK
• Python SDK
• Azure PowerShell
• API REST
• modello Azure Resource Manager

Creare un servizio collegato per Dynamics AX usando l'interfaccia utente

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

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

   • Azure Data Factory
   • Azure Synapse

   

2. Cercare Dynamics e selezionare il connettore Dynamics AX.

   

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

   

Dettagli di configurazione del connettore

Le sezioni seguenti forniscono informazioni dettagliate sulle proprietà che è possibile usare per definire entità di Data Factory specifiche per Dynamics AX connettore.

Prerequisiti

Per usare l'autenticazione basata su principale servizio, seguire i seguenti passaggi:

1. Registrare un'applicazione con Microsoft Identity Platform. Per informazioni su come, vedere Quickstart: Registrare un'applicazione con il Microsoft Identity Platform. Prendere nota di questi valori che si usano per definire il servizio collegato:

   • ID dell'applicazione
   • Chiave applicazione
   • ID del tenant

2. Passare a Dynamics AX e concedere a questa principale del servizio le autorizzazioni appropriate per accedere a Dynamics AX.

Proprietà del servizio collegato

Per Dynamics AX servizio collegato sono supportate le proprietà seguenti:

Esempio

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

Proprietà del set di dati

In questa sezione viene fornito un elenco di proprietà supportate dal set di dati Dynamics AX.

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione dei set di dati, vedere Set di dati e servizi collegati.

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

Esempio

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

Proprietà dell'attività di copia

In questa sezione viene fornito un elenco di proprietà supportate dall'origine Dynamics AX.

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere Pipeline.

Dynamics AX come sorgente

Per copiare dati da Dynamics AX, impostare il tipo source nell'attività di copia su DynamicsAXSource. Nella sezione source dell'attività di copia sono supportate le proprietà seguenti:

Esempio

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

Proprietà dell'attività Lookup

Per conoscere i dettagli delle proprietà, vedere Attività di ricerca.

Contenuto correlato

Per un elenco degli archivi dati supportati dall'attività di copia come origini e sink, vedere Archivi dati e formati supportati.