使用 Azure 数据工厂或 Synapse Analytics 从 Dynamics AX 复制数据
适用于：
Azure 数据工厂 Azure Synapse Analytics
提示
试用 Microsoft Fabric 中的数据工厂，这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用！
本文概述如何使用 Azure 数据工厂和 Synapse Analytics 管道中的复制活动从 Dynamics AX 源复制数据。 本文是基于概括性介绍复制活动的复制活动一文编写的。
支持的功能
此 Dynamics AX 连接器支持以下功能：
| 支持的功能 | IR |
|---|---|
| 复制活动（源/-） | ① ② |
| Lookup 活动 | ① ② |
① Azure 集成运行时 ② 自承载集成运行时
如需可以用作源和接收器的数据存储的列表，请参阅支持的数据存储。
具体而言，此 Dynamics AX 连接器支持将 OData 协议与服务主体身份验证配合使用来从 Dynamics AX 中复制数据。
入门
若要使用管道执行复制活动，可以使用以下工具或 SDK 之一：
使用 UI 创建一个到 Dynamics AX 的链接服务
使用以下步骤在 Azure 门户 UI 中创建一个到 Dynamics AX 的链接服务。
浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡并选择“链接服务”，然后单击“新建”：
搜索 Dynamics 并选择 Dynamics AX 连接器。
配置服务详细信息、测试连接并创建新的链接服务。
连接器配置详细信息
对于特定于 Dynamics AX 连接器的数据工厂实体，以下部分提供了有关用于定义这些实体的属性的详细信息。
先决条件
若要使用服务主体身份验证，请执行以下步骤：
将应用程序注册到 Microsoft 标识平台。 快速入门：通过 Microsoft 标识平台注册应用程序。 记下以下值，这些值用于定义链接服务：
- 应用程序 ID
- 应用程序密钥
- 租户 ID
转到 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 活动。
相关内容
有关复制活动支持作为源和接收器的数据存储的列表，请参阅支持的数据存储和格式。