Copiar dados do Dynamics AX usando o Azure Data FactoryCopy data from Dynamics AX by using Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como usar a Atividade de Cópia no Azure Data Factory para copiar dados de uma fonte Dynamics AX.This article outlines how to use Copy Activity in Azure Data Factory to copy data from Dynamics AX source. O artigo baseia-se em Atividade de Cópia no Azure Data Factory, que apresenta uma visão geral da Atividade de Cópia.The article builds on Copy Activity in Azure Data Factory, which presents a general overview of Copy Activity.

Funcionalidades com suporteSupported capabilities

Há suporte para este conector do Dynamics AX nas seguintes atividades:This Dynamics AX connector is supported for the following activities:

Você pode copiar dados do Dynamics AX para qualquer armazenamento de dados de coletor com suporte.You can copy data from Dynamics AX to any supported sink data store. Para obter uma lista de armazenamentos de dados que o Copy Activity suporta como fontes e coletores, consulte Armazenamentos de dados e formatos compatíveis.For a list of data stores that Copy Activity supports as sources and sinks, see Supported data stores and formats.

Especificamente, este conector do Dynamics AX é compatível com à cópia de dados do Dynamics AX usando o protocolo OData com Autenticação de Entidade de serviço .Specifically, this Dynamics AX connector supports copying data from Dynamics AX using OData protocol with Service Principal authentication .

Dica

Você também pode usar esse conector para copiar dados do Dynamics 365 Finance and Operations .You can also use this connector to copy data from Dynamics 365 Finance and Operations . Consulte o suporte OData e o método de autenticação do Dynamic 365.Refer to Dynamics 365's OData support and Authentication method.

IntroduçãoGet started

Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:To perform the Copy activity with a pipeline, you can use one of the following tools or SDKs:

As seções a seguir fornecem detalhes sobre propriedades que você pode usar para definir entidades do Data Factory específicas do conector Dynamics AX.The following sections provide details about properties you can use to define Data Factory entities that are specific to Dynamics AX connector.

Pré-requisitosPrerequisites

Para usar a autenticação de entidade de serviço, siga estas etapas:To use service principal authentication, follow these steps:

  1. Registre uma entidade de aplicativo no Azure Active Directory (Azure AD) seguindo Registre o aplicativo com um locatário do Azure AD.Register an application entity in Azure Active Directory (Azure AD) by following Register your application with an Azure AD tenant. Anote os seguintes valores, que são usados para definir o serviço vinculado:Make note of the following values, which you use to define the linked service:

    • ID do aplicativoApplication ID
    • Chave do aplicativoApplication key
    • ID do locatárioTenant ID
  2. Vá para o Dynamics AX e conceda essa permissão adequada de entidade de serviço para acessar o Dynamics AX.Go to Dynamics AX, and grant this service principal proper permission to access your Dynamics AX.

Propriedades do serviço vinculadoLinked service properties

As propriedades a seguir têm suporte no serviço vinculado do Dynamics AX:The following properties are supported for Dynamics AX linked service:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade tipo deve ser definida como: DynamicsAX .The type property must be set to DynamicsAX . SimYes
urlurl Ponto de extremidade OData da instância do Dynamics AX (ou Dynamics 365 Finance and Operations).The Dynamics AX (or Dynamics 365 Finance and Operations) instance OData endpoint. SimYes
servicePrincipalIdservicePrincipalId Especifique a ID do cliente do aplicativo.Specify the application's client ID. SimYes
servicePrincipalKeyservicePrincipalKey Especifique a chave do aplicativo.Specify the application's key. Marque esse campo como SecureString para armazená-lo com segurança no Data Factory ou referencie um segredo armazenado no Cofre de Chaves do Azure.Mark this field as a SecureString to store it securely in Data Factory, or reference a secret stored in Azure Key Vault. SimYes
locatáriotenant Especifique as informações de locatário (domínio nome ou ID do Locatário) em que o aplicativo reside.Specify the tenant information (domain name or tenant ID) under which your application resides. Para recuperá-lo, passe o mouse no canto superior direito do portal do Azure.Retrieve it by hovering the mouse in the top-right corner of the Azure portal. SimYes
aadResourceIdaadResourceId Especifique o recurso do AAD ao qual você está solicitando autorização.Specify the AAD resource you are requesting for authorization. Por exemplo, se a URL do Dynamics é https://sampledynamics.sandbox.operations.dynamics.com/data/, o recurso do AAD correspondente é geralmente 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. SimYes
connectViaconnectVia O runtime de integração a ser usado para se conectar ao armazenamento de dados.The Integration Runtime to use to connect to the data store. Você pode escolher o Azure Integration Runtime ou o Integration Runtime auto-hospedado (se o armazenamento de dados estiver localizado em uma rede privada).You can choose Azure Integration Runtime or a self-hosted Integration Runtime (if your data store is located in a private network). Se não especificado, o Azure Integration Runtime padrão será usado.If not specified, the default Azure Integration Runtime is used. NãoNo

ExemploExample

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

Propriedades do conjunto de dadosDataset properties

Esta seção fornece uma lista de propriedades compatíveis com o conjunto de dados Dynamics AX.This section provides a list of properties that the Dynamics AX dataset supports.

Para obter uma lista completa de seções e propriedades disponíveis para definição de conjuntos de dados, consulte Conjuntos de dados e serviços vinculados.For a full list of sections and properties that are available for defining datasets, see Datasets and linked services.

Para copiar dados do Dynamics AX, defina a propriedade tipo do conjunto de dados como DynamicsAXResource .To copy data from Dynamics AX, set the type property of the dataset to DynamicsAXResource . Há suporte para as seguintes propriedades:The following properties are supported:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade tipo do conjunto de dados deve ser definida como DynamicsAXResource .The type property of the dataset must be set to DynamicsAXResource . SimYes
caminhopath Caminho para a entidade OData do Dynamics AX.The path to the Dynamics AX OData entity. SimYes

ExemploExample

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

Propriedades da Atividade de CópiaCopy Activity properties

Esta seção fornece uma lista de propriedades compatíveis com a fonte Dynamics AX.This section provides a list of properties that the Dynamics AX source supports.

Para obter uma lista completa de seções e propriedades que estão disponíveis para definir atividades, consulte Pipelines.For a full list of sections and properties that are available for defining activities, see Pipelines.

Dynamics AX como fonteDynamics AX as source

Para copiar dados do Dynamics AX, defina o tipo de fonte em Copiar atividade para DynamicsAXSource .To copy data from Dynamics AX, set the source type in Copy Activity to DynamicsAXSource . As seguintes propriedades são suportadas na seção source da atividade de cópia:The following properties are supported in the Copy Activity source section:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
typetype A propriedade tipo da fonte Copiar atividade deve ser definida como DynamicsAXSource .The type property of the Copy Activity source must be set to DynamicsAXSource . SimYes
Consultaquery Opções de consulta OData para filtrar dados.OData query options for filtering data. Exemplo: "?$select=Name,Description&$top=5".Example: "?$select=Name,Description&$top=5".

Observação : O conector copia os dados da URL combinada: [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]. Para saber mais, confira as Componentes da URL do OData.For more information, see OData URL components.
NãoNo
httpRequestTimeouthttpRequestTimeout O tempo limite (o valor TimeSpan ) para a solicitação HTTP para obter uma resposta.The timeout (the TimeSpan value) for the HTTP request to get a response. Esse valor é o tempo limite para obter uma resposta, não o tempo limite para ler os dados da resposta.This value is the timeout to get a response, not the timeout to read response data. Se não for especificado, o valor padrão será 00:30:00 (30 minutos).If not specified, the default value is 00:30:00 (30 minutes). NãoNo

ExemploExample

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

Pesquisar propriedades de atividadeLookup activity properties

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.To learn details about the properties, check Lookup activity.

Próximas etapasNext steps

Para obter uma lista de armazenamentos de dados que o Copy Activity suporta como fontes e coletores no Azure Data Factory, consulte Armazenamentos e formatos de dados compatíveis.For a list of data stores that Copy Activity supports as sources and sinks in Azure Data Factory, see Supported data stores and formats.