Copiare dati da Dynamics AX usando Azure Data FactoryCopy data from Dynamics AX by using Azure Data Factory

Questo articolo descrive come usare l'attività di copia in Azure Data Factory per copiare dati da un'origine Dynamics AX.This article outlines how to use Copy Activity in Azure Data Factory to copy data from Dynamics AX source. È basato sull'articolo Attività di copia in Azure Data Factory, che presenta una panoramica generale dell'attività di copia.The article builds on Copy Activity in Azure Data Factory, which presents a general overview of Copy Activity.

Funzionalità supportateSupported capabilities

Questo connettore Dynamics AX è supportato per le attività seguenti:This Dynamics AX connector is supported for the following activities:

È possibile copiare dati da Dynamics AX in qualsiasi archivio dati di sink supportato.You can copy data from Dynamics AX to any supported sink data store. Per un elenco degli archivi dati supportati dall'attività di copia come origini e sink, vedere Archivi dati e formati supportati.For a list of data stores that Copy Activity supports as sources and sinks, see Supported data stores and formats.

In particolare, questo connettore Dynamics AX supporta la copia dei dati da Dynamics AX utilizzando il protocollo OData con l’autenticazione basata su entità servizio.Specifically, this Dynamics AX connector supports copying data from Dynamics AX using OData protocol with Service Principal authentication.

Suggerimento

Per copiare dati da Dynamics 365 for Finance and Operations, è possibile usare questo connettore.You can also use this connector to copy data from Dynamics 365 Finance and Operations. Fare riferimento al supporto per OData di Dynamics 365 e al metodo di autenticazione.Refer to Dynamics 365's OData support and Authentication method.

IntroduzioneGet started

È possibile usare l'attività di copia con una pipeline tramite uno degli strumenti o degli SDK seguenti.You can use one of the following tools or SDKs to use the copy activity with a pipeline. Per istruzioni dettagliate, selezionare un collegamento:Select a link for step-by-step instructions:

Le sezioni seguenti presentano informazioni dettagliate sulle proprietà che è possibile usare per definire entità di Data Factory specifiche per il connettore Dynamics AX.The following sections provide details about properties you can use to define Data Factory entities that are specific to Dynamics AX connector.

prerequisitiPrerequisites

Per usare l'autenticazione basata su entità servizio, eseguire la procedura seguente:To use service principal authentication, follow these steps:

  1. Registrare un'entità applicazione in Azure Active Directory (Azure AD) seguendo le indicazioni fornite in Registrare l'applicazione con un tenant di Azure AD.Register an application entity in Azure Active Directory (Azure AD) by following Register your application with an Azure AD tenant. Prendere nota dei valori seguenti che si usano per definire il servizio collegato:Make note of the following values, which you use to define the linked service:

    • ID applicazioneApplication ID
    • Chiave applicazioneApplication key
    • ID tenantTenant ID
  2. Passare a Dynamics AX e concedere questa autorizzazione appropriata dell'entità servizio per accedere a Dynamics AX.Go to Dynamics AX, and grant this service principal proper permission to access your Dynamics AX.

Proprietà del servizio collegatoLinked service properties

Per il servizio collegato di Dynamics AX sono supportate le proprietà seguenti:The following properties are supported for Dynamics AX linked service:

ProprietàProperty DESCRIZIONEDescription obbligatoriRequired
typetype La proprietà type deve essere impostata su: DynamicsAX.The type property must be set to DynamicsAX. Yes
URLurl L'istanza dell'endpoint OData di Dynamics AX (o Dynamics 365 Finance and Operations).The Dynamics AX (or Dynamics 365 Finance and Operations) instance OData endpoint. Yes
servicePrincipalIdservicePrincipalId Specificare l'ID client dell'applicazione.Specify the application's client ID. Yes
servicePrincipalKeyservicePrincipalKey Specificare la chiave dell'applicazione.Specify the application's key. Contrassegnare questo campo come SecureString per archiviarlo in modo sicuro in Data Factory oppure fare riferimento a un segreto archiviato in Azure Key Vault.Mark this field as a SecureString to store it securely in Data Factory, or reference a secret stored in Azure Key Vault. Yes
tenanttenant Specificare le informazioni sul tenant (nome di dominio o ID tenant) in cui si trova l'applicazione.Specify the tenant information (domain name or tenant ID) under which your application resides. Recuperarle passando il cursore del mouse sull'angolo superiore destro del portale di Azure.Retrieve it by hovering the mouse in the top-right corner of the Azure portal. Yes
aadResourceIdaadResourceId Specificare la risorsa AAD per cui si sta richiedendo l'autorizzazione.Specify the AAD resource you are requesting for authorization. Ad esempio, se è l'URL di Dynamics è https://sampledynamics.sandbox.operations.dynamics.com/data/, la risorsa AAD corrispondente è in genere https://sampledynamics.sandbox.operations.dynamics.com.For example, if your Dynamics URL is https://sampledynamics.sandbox.operations.dynamics.com/data/, the corresponding AAD resource is usually https://sampledynamics.sandbox.operations.dynamics.com. Yes
connectViaconnectVia Runtime di integrazione da usare per la connessione all'archivio dati.The Integration Runtime to use to connect to the data store. È possibile scegliere tra Azure Integration Runtime e un runtime di integrazione self-hosted (se l'archivio dati si trova in una rete privata).You can choose Azure Integration Runtime or a self-hosted Integration Runtime (if your data store is located in a private network). Se questa proprietà non è specificata, viene usato il tipo Azure Integration Runtime predefinito.If not specified, the default Azure Integration Runtime is used. NoNo

EsempioExample

{
    "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à dei set di datiDataset properties

Questa sezione presenta un elenco delle proprietà supportate dal set di dati Dynamics AX.This section provides a list of properties that the Dynamics AX dataset supports.

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione dei set di dati, vedere Set di dati e servizi collegati.For a full list of sections and properties that are available for defining datasets, see Datasets and linked services.

Per copiare dati da Dynamics AX, impostare la proprietà type del set di dati su DynamicsAXResource.To copy data from Dynamics AX, set the type property of the dataset to DynamicsAXResource. Sono supportate le proprietà seguenti:The following properties are supported:

ProprietàProperty DESCRIZIONEDescription obbligatoriRequired
typetype La proprietà type del set di dati deve essere impostata su: DynamicsAXResource.The type property of the dataset must be set to DynamicsAXResource. Yes
pathpath Percorso di entità OData Dynamics AX.The path to the Dynamics AX OData entity. Yes

EsempioExample

{
    "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 copiaCopy Activity properties

Questa sezione presenta un elenco delle proprietà supportate dall'origine Dynamics AX.This section provides a list of properties that the Dynamics AX source supports.

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere Pipelines (Pipeline).For a full list of sections and properties that are available for defining activities, see Pipelines.

Dynamics AX come origineDynamics AX as source

Per copiare dati da Dynamics AX, impostare il tipo di origine nell'attività di copia su DynamicsAXSource.To copy data from Dynamics AX, set the source type in Copy Activity to DynamicsAXSource. Nella sezione source dell'attività di copia sono supportate le proprietà seguenti:The following properties are supported in the Copy Activity source section:

ProprietàProperty DESCRIZIONEDescription obbligatoriRequired
typetype La proprietà type dell'origine dell'attività di copia deve essere impostata su DynamicsAXSource.The type property of the Copy Activity source must be set to DynamicsAXSource. Yes
queryquery Opzioni di query OData per filtrare i dati.OData query options for filtering data. Esempio: "?$select=Name,Description&$top=5".Example: "?$select=Name,Description&$top=5".

Nota: il connettore copia dati dall'URL combinato: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source].Note: The connector copies data from the combined URL: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source]. Per altre informazioni, vedere OData URL components (Componenti dell'URL di OData).For more information, see OData URL components.
NoNo

EsempioExample

"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à attività di ricercaLookup activity properties

Per informazioni dettagliate sulle proprietà, controllare l' attività di ricerca.To learn details about the properties, check Lookup activity.

Passaggi successiviNext steps

Per un elenco degli archivi dati supportati come origini o sink dall'attività di copia in Azure Data Factory, vedere Archivi dati e formati supportati.For a list of data stores that Copy Activity supports as sources and sinks in Azure Data Factory, see Supported data stores and formats.