Compartir a través de

使用 Azure 数据工厂或 Synapse Analytics 从 Dynamics AX 复制数据

适用于:Azure 数据工厂 Azure Synapse Analytics

本文概述如何使用 Azure 数据工厂和 Synapse Analytics 管道中的复制活动从 Dynamics AX 源复制数据。 本文是基于概括性介绍复制活动的复制活动一文编写的。

支持的功能

此 Dynamics AX 连接器支持以下功能:

支持的功能 IR
复制活动(源/-) ① ②
Lookup 活动 ① ②

① Azure 集成运行时 ② 自承载集成运行时

如需可以用作源和接收器的数据存储的列表,请参阅支持的数据存储

具体而言,此 Dynamics AX 连接器支持将 OData 协议服务主体身份验证配合使用来从 Dynamics AX 中复制数据。

提示

还可以使用此连接器从 Dynamics 365 Finance and Operations 复制数据。 请参阅 Dynamics 365 的 OData 支持身份验证方法

入门

若要使用管道执行复制活动,可以使用以下工具或 SDK 之一:

使用 UI 创建一个到 Dynamics AX 的链接服务

使用以下步骤在 Azure 门户 UI 中创建一个到 Dynamics AX 的链接服务。

  1. 浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡并选择“链接服务”,然后单击“新建”:

  2. 搜索 Dynamics 并选择 Dynamics AX 连接器。

    选择 Dynamics AX 连接器。

  3. 配置服务详细信息、测试连接并创建新的链接服务。

    配置到 Dynamics AX 的链接服务。

连接器配置详细信息

对于特定于 Dynamics AX 连接器的数据工厂实体,以下部分提供了有关用于定义这些实体的属性的详细信息。

先决条件

若要使用服务主体身份验证,请执行以下步骤:

  1. 将应用程序注册到 Microsoft 标识平台。 快速入门:通过 Microsoft 标识平台注册应用程序。 记下以下值,这些值用于定义链接服务:

    • 应用程序 ID
    • 应用程序密钥
    • 租户 ID
  2. 转到 Dynamics AX,向此服务主体授予用于访问 Dynamics AX 的正确权限。

链接服务属性

Dynamics AX 链接的服务支持以下属性:

properties 描述 必需
type type 属性必须设置为 DynamicsAX
url Dynamics AX(或 Dynamics 365 Finance and Operations)实例 OData 终结点。
servicePrincipalId 指定应用程序的客户端 ID。
servicePrincipalKey 指定应用程序的密钥。 请将此字段标记为 SecureString 以安全地存储它,或引用存储在 Azure Key Vault 中的机密
tenant 指定应用程序的租户信息(域名或租户 ID)。 将鼠标悬停在 Azure 门户右上角进行检索。
aadResourceId 指定你请求授权的 AAD 资源。 例如,如果动态 URL 为 https://sampledynamics.sandbox.operations.dynamics.com/data/,则相应的 AAD 资源通常为 https://sampledynamics.sandbox.operations.dynamics.com
connectVia 用于连接到数据存储的 Integration Runtime。 可选择 Azure Integration Runtime 或自承载集成运行时(如果数据存储位于专用网络)。 如果未指定,则使用默认 Azure Integration Runtime。

示例

{
    "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.partner.onmschina.cn>",
            "aadResourceId": "<AAD resource, e.g. https://sampledynamics.sandbox.operations.dynamics.com>"
        }
    },
    "connectVia": {
        "referenceName": "<name of Integration Runtime>",
        "type": "IntegrationRuntimeReference"
    }
}

数据集属性

本部分提供了 Dynamics AX 数据集支持的属性列表。

有关可用于定义数据集的各部分和属性的完整列表,请参阅数据集和链接服务

要从 Dynamics AX 复制数据,请将数据集的 type 属性设置为 DynamicsAXResource。 支持以下属性:

属性 描述 必需
type 数据集的 type 属性必须设置为 DynamicsAXResource
路径 Dynamics AX OData 实体的路径。

示例

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

复制活动属性

本部分提供了 Dynamics AX 源支持的属性列表。

有关可用于定义活动的各个部分和属性的完整列表,请参阅管道

作为源的 Dynamics AX

若要从 Dynamics AX 复制数据,请将复制活动中的 source 类型设置为 DynamicsAXSource。 复制活动 source 节支持以下属性:

属性 描述 必需
type 复制活动源的 type 属性必须设置为 DynamicsAXSource
query 用于筛选数据的 OData 查询选项。 示例:"?$select=Name,Description&$top=5"

注意:连接器会从以下组合 URL 复制数据:[URL specified in linked service]/[path specified in dataset][query specified in copy activity source]。 有关详细信息,请参阅 OData URL 组件
httpRequestTimeout 用于获取响应的 HTTP 请求的超时(TimeSpan 值)。 该值是获取响应而不是读取响应数据的超时。 如果未指定,默认值为“00:05:00”(5 分钟)。

示例

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

“查找”活动属性

若要了解有关属性的详细信息,请查看 Lookup 活动

有关复制活动支持作为源和接收器的数据存储的列表,请参阅支持的数据存储和格式