Копирование данных из SAP Business Warehouse с помощью Azure Data Factory или Synapse Analytics

ПРИМЕНИМО К: Azure Data Factory Azure Synapse Analytics

Совет

Data Factory в Microsoft Fabric — это следующее поколение Azure Data Factory с более простой архитектурой, встроенным ИИ и новыми функциями. Если вы не знакомы с интеграцией данных, начните с Fabric Data Factory. Существующие рабочие нагрузки ADF могут обновляться до Fabric для доступа к новым возможностям в области обработки и анализа данных, аналитики в режиме реального времени и отчетов.

В этой статье описывается, как использовать действие копирования в конвейерах Azure Data Factory и Synapse Analytics для копирования данных из хранилища SAP Business Warehouse (BW). Это продолжение статьи об обзоре действия копирования, в которой представлены общие сведения о действии копирования.

Совет

Общие сведения о поддержке службы в сценарии интеграции данных SAP см. в статье SAP data integration using Azure Data Factory whitepaper с подробными сведениями о каждом соединителе SAP, сравнении и руководстве.

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

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

Поддерживаемые возможности IR
Copy activity (источник/-) (2)
Операция поиска (2)

(1) Azure среды выполнения интеграции (2) локальная среда выполнения интеграции

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

Этот соединитель SAP Business Warehouse поддерживает:

  • SAP Business Warehouse версии 7.x.
  • Копирование данных из InfoCubes и QueryCubes (включая запросы BEx) с помощью запросов MDX.
  • Копирование данных с помощью базовой проверки подлинности.

Примечание.

Соединитель SAP Business Warehouse в настоящее время не поддерживает параметры с MDX. Если требуется фильтрация с использованием параметров MDX, можно рассмотреть возможность использования альтернативного соединителя SAP Open Hub.

Требования

Чтобы использовать этот соединитель SAP Business Warehouse, сделайте следующее:

  • Настройте автономную среду выполнения интеграции. См. статью Self-hosted Integration Runtime для получения подробной информации.
  • Установите библиотеку SAP NetWeaver на компьютере Integration Runtime. Библиотеку SAP Netweaver можно получить у администратора SAP или непосредственно на странице SAP Software Download Center (Центр загрузки программного обеспечения SAP). Найдите примечание к SAP № 1025361, чтобы узнать адрес для скачивания самой последней версии. Убедитесь, что выбрана библиотека 64-разрядной SAP NetWeaver, соответствующая установке Среды выполнения интеграции. Установите все файлы, включенные в состав пакета SDK RFC для SAP NetWeaver, согласно примечанию к SAP. Библиотека SAP NetWeaver также включена в состав клиентских инструментов SAP.

Совет

Чтобы устранить неполадки с подключением к SAP BW, проверьте следующее:

  • В папке %windir%\system32 хранятся все библиотеки зависимостей, извлеченные из пакета SDK для NetWeaver RFC. Как правило, это библиотеки icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll и sapnwrfc.dll.
  • На компьютере с локальной средой выполнения интеграции включены порты (как правило, 3300 и 3201), необходимые для подключения к серверу SAP.

Начало работы

Для выполнения действия копирования с конвейером можно использовать один из следующих средств или пакетов SDK:

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

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

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

  2. Выполните поиск SAP и выберите коннектор SAP BW через MDX.

    Выберите SAP BW через MDX-коннектор.

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

    Выполните настройку связанной службы для SAP BW.

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

Следующие разделы содержат сведения о свойствах, которые используются для определения сущностей фабрики данных, относящихся к соединителю SAP Business Warehouse.

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

Для связанной службы SAP Business Warehouse (BW) поддерживаются следующие свойства:

Свойство Описание: Обязательное поле
тип Для свойства type необходимо задать значение SapBw Да
server Имя сервера, на котором размещен экземпляр SAP Business Warehouse. Да
СистемныйНомер Номер системы SAP Business Warehouse.
Допустимые значения: двузначное десятичное число, представленное в виде строки.
Да
clientId Идентификатор клиента в системе SAP W.
Допустимые значения: трехзначное десятичное число, представленное в виде строки.
Да
userName Имя пользователя, имеющего доступ к серверу SAP. Да
пароль Пароль для пользователя Пометьте это поле как SecureString, чтобы безопасно хранить его, или ссылаться на секрет, хранящийся в Azure Key Vault. Да
connectVia Integration Runtime для подключения к хранилищу данных. Требуется Self-hosted Integration Runtime, как упомянуто в разделе Prerequisites. Да

Пример:

{
    "name": "SapBwLinkedService",
    "properties": {
        "type": "SapBw",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client id>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

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

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

Чтобы скопировать данные из SAP BW, установите свойство типа набора данных SapBwCube. В настоящее время для набора данных SAP Business Warehouse типа RelationalTable не поддерживаются свойства, специфичные для типа.

Пример:

{
    "name": "SAPBWDataset",
    "properties": {
        "type": "SapBwCube",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP BW linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

Свойства Copy activity

Полный список разделов и свойств, используемых для определения действий, обратитесь к статье Конвейеры. Этот раздел содержит список свойств, поддерживаемых источником SAP BW.

SAP BW в качестве источника

Для копирования данных из SAP BW в разделе источник действия копирования поддерживаются следующие свойства:

Свойство Описание: Обязательное поле
тип Свойство типа источника действия копирования должно иметь значение SapBwSource Да
запрос Указывает MDX-запрос для чтения данных из экземпляра SAP BW (SAP Business Warehouse). Да

Пример:

"activities":[
    {
        "name": "CopyFromSAPBW",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP BW input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapBwSource",
                "query": "<MDX query for SAP BW>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Если вы ранее использовали типизированный источник RelationalSource, он пока поддерживается и не требует изменений, но мы рекомендуем в дальнейшем использовать более новую версию.

Сопоставление типов данных для SAP BW

При копировании данных из SAP BW используются следующие сопоставления типов данных SAP BW с промежуточными типами данных, используемыми службой для внутренних целей. См. Сопоставление схем и типов данных, чтобы узнать, как действие копирования сопоставляет исходную схему и типы данных с приемником.

Тип данных SAP BW Промежуточный тип данных службы
ACCP Int
CHAR Строка
CLNT Строка
CURR Десятичное число
CUKY Строка
декабрь Десятичное число
FLTP Двойной
INT1 Байт
INT2 Int16
INT4 Int
LANG Строка
LCHR Строка
LRAW Byte[]
PREC Int16
QUAN Десятичное число
НЕОБРАБОТАННЫЕ Byte[]
RAWSTRING Byte[]
STRING Строка
ЮНИТ Строка
DATS Строка
NUMC Строка
TIMS Строка

Свойства операции поиска

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

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