Copia de datos de Dynamics AX mediante Azure Data Factory o Synapse Analytics

SE APLICA A: Azure Data Factory Azure Synapse Analytics

En este artículo se describe cómo usar la actividad de copia en las canalizaciones de Azure Data Factory y Synapse Analytics para copiar datos desde una fuente de Dynamics AX. El artículo se basa en Actividad de copia, en el que se ofrece información general acerca de la actividad de copia.

Funcionalidades admitidas

Este conector de Dynamics AX se admite para las siguientes funcionalidades:

① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado

Para obtener una lista de almacenes de datos que se admiten como orígenes y receptores, consulte los almacenes de datos admitidos.

En concreto, este conector de Dynamics AX admite la copia de datos de Dynamics AX mediante el protocolo OData con la autenticación del Principal del servicio Service Principal.

Primeros pasos

Para realizar la actividad de copia con una canalización, puede usar una de las siguientes herramientas o SDK:

• Herramienta Copiar datos
• Azure Portal
• SDK de .NET
• SDK de Python
• Azure PowerShell
• REST API
• plantilla Azure Resource Manager

Creación de un servicio vinculado para Dynamics AX mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado para Dynamics AX en la interfaz de usuario del portal de Azure.

1. Vaya a la pestaña Administrar del área de trabajo de Azure Data Factory o Synapse y seleccione Servicios vinculados y haga clic en Nuevo:

   • Azure Data Factory
   • Azure Synapse

   

2. Busque Dynamics y seleccione el conector Dynamics AX.

   

3. Configure los detalles del servicio, pruebe la conexión y cree el servicio vinculado.

   

Detalles de configuración del conector

En las secciones siguientes se proporcionan detalles sobre las propiedades que puede usar para definir entidades de Data Factory específicas de Dynamics AX conector.

Requisitos previos

Antes de usar la autenticación de entidad de servicio, siga estos pasos:

1. Registre una aplicación con la plataforma Microsoft Identity. Para obtener información sobre cómo, consulte Quickstart: Registrar una aplicación con el Microsoft identity platform. Anote estos valores; los usará para definir el servicio vinculado:

   • Identificador de aplicación
   • Clave de la aplicación
   • Id. de inquilino

2. Vaya a Dynamics AX y conceda a este principal de servicio los permisos apropiados para acceder a su Dynamics AX.

Propiedades del servicio vinculado

Se admiten las siguientes propiedades para el servicio vinculado de Dynamics AX:

Ejemplo

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

Propiedades del conjunto de datos

En esta sección se proporciona una lista de las propiedades que admite el conjunto de datos de Dynamics AX.

Para ver una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte Conjuntos de datos y servicios vinculados.

Para copiar datos de Dynamics AX, establezca la propiedad type del conjunto de datos en DynamicsAXResource. Se admiten las siguientes propiedades:

Ejemplo

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

Propiedades de la actividad de copia

En esta sección se proporciona una lista de las propiedades que admite el origen de Dynamics AX.

Para ver una lista completa de las secciones y propiedades que hay disponibles para definir actividades, consulte Canalizaciones.

Dynamics AX como origen

Para copiar datos de Dynamics AX, establezca el tipo source en Actividad de copia en DynamicsAXSource. La sección source de la actividad de copia admite las siguientes propiedades:

Ejemplo

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

Propiedades de la actividad de búsqueda

Para obtener información detallada sobre las propiedades, consulte Actividad de búsqueda.

Contenido relacionado

Para obtener una lista de almacenes de datos que la actividad de copia admite como orígenes y receptores, consulte Almacenes de datos y formatos que se admiten.