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

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

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

支持的功能

以下功能支持此SAP HANA连接器：

（1） Azure集成运行时 （2） 自承载集成运行时

有关复制活动支持作为源/接收器的数据存储列表，请参阅支持的数据存储表。

具体而言，此SAP HANA连接器支持：

• 从任何版本的 SAP HANA 数据库复制数据。
• 从 HANA 信息模型（如分析和计算视图）和行/列表中复制数据。
• 使用 Basic 或 Windows 身份验证复制数据。
• 从SAP HANA源进行并行复制。 详情请参阅 从 SAP HANA 平行复制 一节。

先决条件

若要使用此SAP HANA连接器，需要：

• 设置本地集成运行时。 有关详细信息，请参阅 自承载的 Integration Runtime 一文。
• 在 Integration Runtime 计算机上安装 SAP HANA ODBC 驱动程序。 可以从 SAP 软件下载中心下载 SAP HANA ODBC 驱动程序。 使用关键字 SAP HANA CLIENT for Windows 进行搜索。

入门

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

• 复制数据工具
• Azure 门户
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure 资源管理器 模板

使用 UI 创建指向SAP HANA的链接服务

使用以下步骤在 Azure 门户 UI 中创建到 SAP HANA 的链接的服务。

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

   • Azure 数据工厂
   • Azure Synapse

   

2. 搜索 SAP 并选择SAP HANA连接器。

   

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

   

连接器配置详细信息

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

连接的服务属性

SAP HANA链接服务支持以下属性：

示例：使用基本身份验证

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "connectionString": "SERVERNODE=<server>:<port (optional)>;UID=<userName>;PWD=<Password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

示例：使用 Windows 身份验证

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "connectionString": "SERVERNODE=<server>:<port (optional)>;",
            "userName": "<username>", 
            "password": { 
                "type": "SecureString", 
                "value": "<password>" 
            } 
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

如果您使用含有以下有效负载的SAP HANA连接服务，仍然可以按原样支持，同时建议您今后使用新的连接服务。

示例：

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "server": "<server>:<port (optional)>",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

数据集属性

有关可用于定义数据集的各部分和属性的完整列表，请参阅数据集一文。 本部分提供SAP HANA数据集支持的属性列表。

若要从SAP HANA复制数据，支持以下属性：

示例：

{
    "name": "SAPHANADataset",
    "properties": {
        "type": "SapHanaTable",
        "typeProperties": {
            "schema": "<schema name>",
            "table": "<table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP HANA linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

复制活动 属性

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

SAP HANA作为源

若要从 SAP HANA 复制数据，复制活动 source 节支持以下属性：

示例：

"activities":[
    {
        "name": "CopyFromSAPHANA",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP HANA input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapHanaSource",
                "query": "<SQL query for SAP HANA>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

如果使用 RelationalSource 类型复制源，该源仍按原样受支持，但我们建议今后使用新源。

从SAP HANA并行复制

SAP HANA连接器提供内置的数据分区，以并行复制SAP HANA中的数据。 可以在复制活动的“源”表中找到数据分区选项。

启用分区复制时，服务会针对SAP HANA源运行并行查询，以便按分区检索数据。 可通过复制活动中的 parallelCopies 设置来控制并行度。 例如，如果将 parallelCopies 设置为 4，则服务会根据指定的分区选项和设置同时生成并运行四个查询，并且每个查询从SAP HANA检索一部分数据。

建议使用数据分区启用并行复制，尤其是在从SAP HANA引入大量数据时。 下面是适用于不同方案的建议配置。 将数据复制到基于文件的数据存储中时，建议将数据作为多个文件写入文件夹（仅指定文件夹名称），在这种情况下，性能优于写入单个文件。

示例：使用表的物理分区进行查询

"source": {
    "type": "SapHanaSource",
    "partitionOption": "PhysicalPartitionsOfTable"
}

示例：使用动态范围分区进行查询

"source": {
    "type": "SapHanaSource",
    "query": "SELECT * FROM <TABLENAME> WHERE (?AdfHanaDynamicRangePartitionCondition) AND <your_additional_where_clause>",
    "partitionOption": "SapHanaDynamicRange",
    "partitionSettings": {
        "partitionColumnName": "<Partition_column_name>"
    }
}

SAP HANA的数据类型映射

从SAP HANA复制数据时，以下映射用于从SAP HANA数据类型映射到服务内部使用的临时数据类型。 若要了解复制活动如何将源架构和数据类型映射到接收器，请参阅架构和数据类型映射。

SAP HANA接收器

目前不支持SAP HANA连接器作为接收器，而可以将通用 ODBC 连接器与SAP HANA驱动程序配合使用，将数据写入SAP HANA。

按照先决条件设置自托管集成运行时，然后首先安装 SAP HANA ODBC 驱动程序。 创建 ODBC 链接服务以连接到SAP HANA数据存储，如以下示例所示，然后相应地创建包含 ODBC 类型的数据集和复制活动接收器。 若要了解详细信息，请参阅 ODBC 连接器一文。

{
    "name": "SAPHANAViaODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "Driver={HDBODBC};servernode=<HANA server>.clouddatahub-int.net:30015",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

查找活动属性

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

相关内容

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