Копирование данных из Dynamics AX с помощью Фабрики данных Azure или Synapse Analytics

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

Совет

Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !

В этой статье описано, как с помощью действия Copy в конвейерах Фабрики данных Azure и Synapse Analytics копируются данные из Dynamics AX. Это продолжение статьи о действии копирования в Фабрике данных Azure, в которой представлены общие сведения о действии копирования.

Поддерживаемые возможности

Соединитель Dynamics AX поддерживается для следующих возможностей:

Поддерживаемые возможности IR
Действие копирования (источник/-) (1) (2)
Действие поиска (1) (2)

① Среда выполнения интеграции Azure ② Локальная среда выполнения интеграции

Список хранилищ данных, которые поддерживаются в качестве источников и приемников, см. в разделе Поддерживаемые хранилища данных.

В частности, этот соединитель Dynamics AX поддерживает копирование данных из Dynamics AX с помощью протокола OData с проверкой подлинности субъекта-службы.

Совет

Этот соединитель также можно использовать для копирования данных из Dynamics 365 Finance and Operations. Ознакомьтесь со сведениями о поддержке OData Dynamics 365 и методе проверки подлинности.

Начать

Чтобы выполнить действие копирования с конвейером, можно воспользоваться одним из приведенных ниже средств или пакетов SDK:

Создание связанной службы для Dynamics AX с помощью пользовательского интерфейса

Выполните следующие действия, чтобы создать связанную службу для Dynamics AX с помощью пользовательского интерфейса на портале Azure.

  1. Перейдите на вкладку "Управление" в рабочей области Фабрики данных Azure или Synapse и выберите "Связанные службы", после чего нажмите "Создать":

  2. Выполните поиск по запросу Dynamics и выберите соединитель Dynamics AX.

    Выберите соединитель Dynamics AX.

  3. Настройте сведения о службе, проверьте подключение и создайте связанную службу.

    Настройте связанную службу для Dynamics AX.

Сведения о конфигурации соединителя

В разделах ниже приведены сведения о свойствах, которые используются для определения сущностей Фабрики данных, относящихся к соединителю Dynamics AX.

Необходимые компоненты

Чтобы использовать проверку подлинности субъекта-службы, выполните следующие действия.

  1. Зарегистрируйте приложение с помощью платформы удостоверений Майкрософт. Дополнительные сведения см. в кратком руководстве. Регистрация приложения с помощью платформа удостоверений Майкрософт. Запишите эти значения, которые используются для определения связанной службы:

    • Application ID
    • ключ приложения.
    • Идентификатор клиента
  2. Перейдите к Dynamics AX и предоставьте субъекту-службе правильное разрешение для доступа к Dynamics AX.

Свойства связанной службы

Для связанной службы Dynamics AX поддерживаются следующие свойства:

Свойство Описание: Обязательное поле
type Для свойстваtype необходимо задать значение DynamicsAX. Да
URL-адрес Конечная точка OData экземпляра Dynamics AX (или Dynamics 365 Finance and Operations). Да
servicePrincipalId Укажите идентификатора клиента приложения. Да
servicePrincipalKey Укажите ключ приложения. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. Да
tenant Укажите сведения о клиенте (доменное имя или идентификатор клиента), в котором находится приложение. Его можно получить, наведя указатель мыши на правый верхний угол страницы портала Azure. Да
aadResourceId Укажите ресурс AAD, для которого запрашивается авторизация. Например, если Dynamics имеет URL-адрес https://sampledynamics.sandbox.operations.dynamics.com/data/, то обычно соответствующий ресурс AAD имеет адрес https://sampledynamics.sandbox.operations.dynamics.com. Да
connectVia Среда выполнения интеграции, используемая для подключения к хранилищу данных. Вы можете выбрать среду выполнения интеграции Azure или локальную среду IR (если хранилище данных расположено в частной сети). Если не указано другое, по умолчанию используется интегрированная Azure Integration Runtime. No

Пример

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

Свойства набора данных

Этот раздел содержит список свойств, поддерживаемых набором данных Dynamics AX.

Полный список разделов и свойств, используемых для определения наборов данных, приведен в статье Наборы данных и связанные службы в фабрике данных Azure.

Чтобы скопировать данные из Dynamics, установите для свойства type набора данных значение DynamicsAXResource. Поддерживаются следующие свойства:

Свойство Описание: Обязательное поле
type Свойство type набора данных должно быть со значением DynamicsAXResource. Да
path Путь к сущности OData Dynamics AX. Да

Пример

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

Свойства действия копирования

Этот раздел содержит список свойств, поддерживаемых источником данных Dynamics AX.

Полный список разделов и свойств, доступных для определения действий, см. в статье, посвященной конвейерам и действиям в Фабрике данных Azure.

Использование Dynamics AX в качестве источника

Чтобы копировать данные из Dynamics AX, установите для типа источника в действии копирования значение 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]. Дополнительные сведения см. в статье о компонентах URL-адреса OData.
No
httpRequestTimeout Время ожидания (значение Временной диапазон) ответа для HTTP-запроса. Это значение является интервалом времени для получения ответа, а не считывания данных ответа. Если значение не указано, значение по умолчанию равно 00:05:00 (5 минут). No

Пример

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

Свойства действия поиска

Подробные сведения об этих свойствах см. в разделе Действие поиска.

Список хранилищ данных, поддерживаемых действием копирования в качестве источников и приемников, приведен в разделе Поддерживаемые хранилища данных и форматы.