Partilhar via

Copiar dados do Dynamics AX usando o Azure Data Factory ou o Synapse Analytics

  • Artigo

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Este artigo descreve como usar a Atividade de Cópia no Azure Data Factory e nos pipelines do Synapse Analytics para copiar dados da fonte do Dynamics AX. O artigo baseia-se na Atividade de Cópia, que apresenta uma visão geral da Atividade de Cópia.

Capacidades suportadas

Este conector do Dynamics AX é suportado para os seguintes recursos:

Capacidades suportadas IR
Atividade de cópia (fonte/-) (1) (2)
Atividade de Pesquisa (1) (2)

(1) Tempo de execução de integração do Azure (2) Tempo de execução de integração auto-hospedado

Para obter uma lista de armazenamentos de dados que oferecem suporte como fontes e coletores, consulte Armazenamentos de dados suportados.

Especificamente, esse conector do Dynamics AX oferece suporte à cópia de dados do Dynamics AX usando o protocolo OData com autenticação da entidade de serviço.

Gorjeta

Você também pode usar esse conector para copiar dados do Dynamics 365 Finance and Operations. Consulte o método de suporte e autenticação OData do Dynamics 365.

Começar agora

Para executar a atividade Copiar com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:

Criar um serviço vinculado ao Dynamics AX usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado ao Dynamics AX na interface do usuário do portal do Azure.

  1. Navegue até a guia Gerenciar em seu espaço de trabalho do Azure Data Factory ou Synapse e selecione Serviços Vinculados e clique em Novo:

  2. Procure Dynamics e selecione o conector Dynamics AX.

    Selecione o conector do Dynamics AX.

  3. Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

    Configure um serviço vinculado ao Dynamics AX.

Detalhes de configuração do conector

As seções a seguir fornecem detalhes sobre as propriedades que você pode usar para definir entidades do Data Factory que são específicas para o conector do Dynamics AX.

Pré-requisitos

Para usar a autenticação da entidade de serviço, siga estas etapas:

  1. Registre um aplicativo com a plataforma Microsoft Identity. Para saber como, consulte Guia de início rápido: registrar um aplicativo com a plataforma de identidade da Microsoft. Anote estes valores, que você usa para definir o serviço vinculado:

    • ID da aplicação
    • Chave de aplicação
    • ID de Inquilino do

  2. Vá para Dynamics AX e conceda a esta entidade de serviço a permissão adequada para acessar seu Dynamics AX.

Propriedades do serviço vinculado

As seguintes propriedades são suportadas para o serviço vinculado do Dynamics AX:

Property Descrição Obrigatório
tipo A propriedade type deve ser definida como DynamicsAX. Sim
url O ponto de extremidade OData da instância do Dynamics AX (ou Dynamics 365 Finance and Operations). Sim
servicePrincipalId Especifique o ID do cliente do aplicativo. Sim
servicePrincipalKey Especifique a chave do aplicativo. Marque este campo como um SecureString para armazená-lo com segurança ou faça referência a um segredo armazenado no Cofre de Chaves do Azure. Sim
inquilino Especifique as informações do locatário (nome de domínio ou ID do locatário) sob as quais seu aplicativo reside. Recupere-o passando o mouse no canto superior direito do portal do Azure. Sim
aadResourceId Especifique o recurso do AAD que você está solicitando para autorização. Por exemplo, se a URL do Dynamics for https://sampledynamics.sandbox.operations.dynamics.com/data/, o recurso AAD correspondente geralmente é https://sampledynamics.sandbox.operations.dynamics.com. Sim
ConecteVia O tempo de execução de integração a ser usado para se conectar ao armazenamento de dados. Você pode escolher o Tempo de Execução de Integração do Azure ou um Tempo de Execução de Integração auto-hospedado (se seu armazenamento de dados estiver localizado em uma rede privada). Se não for especificado, o Tempo de Execução de Integração do Azure padrão será usado. Não

Exemplo

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

Esta seção fornece uma lista de propriedades suportadas pelo conjunto de dados do Dynamics AX.

Para obter uma lista completa de seções e propriedades disponíveis para definir conjuntos de dados, consulte Conjuntos de dados e serviços vinculados.

Para copiar dados do Dynamics AX, defina a propriedade type do conjunto de dados como DynamicsAXResource. As seguintes propriedades são suportadas:

Property Descrição Obrigatório
tipo A propriedade type do conjunto de dados deve ser definida como DynamicsAXResource. Sim
path O caminho para a entidade OData do Dynamics AX. Sim

Exemplo

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

Copiar propriedades da atividade

Esta seção fornece uma lista de propriedades suportadas pela fonte do Dynamics AX.

Para obter uma lista completa de seções e propriedades disponíveis para definir atividades, consulte Pipelines.

Dynamics AX como origem

Para copiar dados do Dynamics AX, defina o tipo de origem em Copiar atividade como DynamicsAXSource. As seguintes propriedades são suportadas na seção Copiar fonte de atividade:

Property Descrição Obrigatório
tipo A propriedade type da fonte Copy Activity deve ser definida como DynamicsAXSource. Sim
query Opções de consulta OData para filtrar dados. Exemplo: "?$select=Name,Description&$top=5".

Nota: O conector copia dados do URL combinado: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source]. Para obter mais informações, consulte Componentes de URL OData.		 Não
httpRequestTimeout O tempo limite (o valor TimeSpan ) para a solicitação HTTP obter uma resposta. Esse valor é o tempo limite para obter uma resposta, não o tempo limite para ler os dados da resposta. Se não for especificado, o valor padrão será 00:05:00 (5 minutos). Não

Exemplo

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

Propriedades da atividade de pesquisa

Para saber detalhes sobre as propriedades, verifique Atividade de pesquisa.

Conteúdos relacionados

Para obter uma lista de armazenamentos de dados que a Atividade de Cópia suporta como fontes e coletores, consulte Formatos e armazenamentos de dados suportados.