Compartilhar via

使用 Azure 数据工厂 或 Synapse Analytics 从 SAP Business Warehouse 复制数据

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

本文概述了如何使用 Azure 数据工厂 和 Synapse Analytics 管道中的复制活动从 SAP Business Warehouse (BW) 复制数据。 基于提供复制活动一般概述的复制活动概述一文。

提示

若要了解该服务对 SAP 数据集成方案的总体支持,请参阅 SAP 数据集成(使用Azure 数据工厂白皮书,并详细介绍了每个 SAP 连接器、比较和指南。

支持的功能

此 SAP Business Warehouse 连接器支持以下功能:

支持的功能 IR
复制操作 (source/-)
查询活动

(1) Azure集成运行时 (2) 自承载集成运行时

要获取复制活动支持的源/汇的数据存储列表,请参阅支持的数据存储表。

具体而言,此 SAP Business Warehouse 连接器支持:

  • SAP Business Warehouse 版本 7.x
  • 使用 MDX 查询从 InfoCubes 和 QueryCubes 复制数据(包括 BEx 查询)。
  • 使用基本身份验证复制数据。

注意

SAP Business Warehouse 连接器当前不支持使用 MDX 的参数。 如果需要使用 MDX 参数进行筛选,可以考虑改为使用备用 SAP Open Hub 连接器

先决条件

若要使用此 SAP Business Warehouse 连接器,需要:

  • 设置本地集成运行时。 有关详细信息,请参阅 自承载的 Integration Runtime 一文。
  • 在 Integration Runtime 计算机上安装 SAP NetWeaver 库。 可以从 SAP 管理员处或直接从 SAP 软件下载中心获取 SAP Netweaver 库。 搜索“SAP Note #1025361” 获取最新版本的下载位置。 请确保选取与Integration Runtime安装匹配的 64 位 SAP NetWeaver 库。 然后,按照 SAP 说明安装 SAP NetWeaver RFC SDK 中包含的所有文件。 SAP NetWeaver 库也包括在 SAP 客户端工具安装中。

提示

要解决 SAP BW 的连接问题,请确保:

  • 从 NetWeaver RFC SDK 中提取的所有依赖项库都位于 %windir%\system32 文件夹中。 通常它有 icudt34.dll、icuin34.dll、icuuc34.dll、libicudecnumber.dll、librfc32.dll、libsapucum.dll、sapcrypto.dll、sapcryto_old.dll、sapnwrfc.dll。
  • 用于连接 SAP 服务器的所需端口在自承载 IR 计算机上启用,通常是端口 3300 和 3201。

入门

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

使用 UI 创建到 SAP BW 的链接服务

在 Azure 门户界面中,使用以下步骤创建与 SAP BW 的链接服务。

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

  2. 搜索“SAP”并选择“SAP BW via MDX”连接器。

    选择 SAP BW via MDX 连接器。

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

    配置到 SAP BW 的链接服务。

连接器配置详细信息

用于定义特定于 SAP Business Warehouse 连接器的数据工厂实体的属性的详细信息将在以下部分提供。

连接的服务属性

SAP Business Warehouse (BW) 链接服务支持以下属性:

属性 描述 必需
类型 type 属性必须设置为:SapBw
服务器 SAP BW 实例所驻留的服务器的名称。
系统编号 SAP BW 系统的系统编号。
允许值:用字符串表示的两位十进制数。
clientId SAP W 系统中客户的客户端 ID。
允许值:用字符串表示的三位十进制数。
userName 有权访问 SAP 服务器的用户名。
密码 用户密码。 将此字段标记为 SecureString 以安全地存储它,或引用存储在 Azure 密钥保管库 中的机密。
connectVia 连接到数据存储时要使用的Integration RuntimePrerequisites中所述,需要自托管型集成运行时。

示例:

{
    "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 复制数据,请将数据集的 type 属性设置为“SapBwCube” 。 RelationalTable 类型的 SAP BW 数据集不支持任何类型特定的属性。

示例:

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

如果使用 RelationalTable 类型数据集,该数据集仍按原样受支持,但我们建议今后使用新数据集。

复制活动 属性

有关可用于定义活动的各部分和属性的完整列表,请参阅管道一文。 本部分提供 SAP BW 源支持的属性列表。

SAP BW 作为源

若要从 SAP BW 复制数据,复制活动的 source 节支持以下属性:

属性 描述 必需
类型 复制活动源的 type 属性必须设置为:SapBwSource
查询 指定要从 SAP BW 实例读取数据的 MDX 查询。

示例:

"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 字符串
DEC 小数
FLTP 双倍
INT1 字节
INT2 Int16
INT4 int
LANG 字符串
LCHR 字符串
LRAW Byte[]
PREC Int16
QUAN 小数
RAW Byte[]
RAWSTRING Byte[]
STRING 字符串
单元 字符串
DATS 字符串
NUMC 字符串
TIMS 字符串

查找活动属性

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

为了获取复制活动支持的数据源和汇集列表,请参阅支持的数据存储