配置 SAP Hana 数据源

SAP HANA 数据源为您提供读取 SAP HANA 数据的数据集成通道能力，实现将读取出来的数据，写入到不同的目标数据源中。
本文为您介绍 DataSail 的 SAP HANA 数据同步的能力支持情况。

1 使用限制

1. 当前仅支持离线读 SAP HANA 数据。
2. 子账号新建数据源时，需要有项目的管理员角色，方可以进行新建数据源操作。各角色对应权限说明，详见：管理成员

2 支持的字段类型

SAP HANA 离线读字段数据类型支持情况如下：

3 数据同步任务开发

3.1 数据源注册

新建数据源操作详见配置数据源，下面为您介绍用连接串方式配置 Hana 数据源信息：

3.2 新建离线任务

Hana 数据源测试连通性成功后，进入到数据开发界面，开始新建 Hana 相关通道任务。
新建任务方式详见离线数据同步。

3.3 可视化配置说明

任务创建成功后，您可根据实际场景，配置 Hana 离线读通道任务。

3.3.1 Hana 离线读

数据来源选择 Hana，并完成以下相关参数配置：
其中参数名称前带 * 的为必填参数，名称前未带 * 的为可选填参数。

3.3.2 Hana 离线写

数据目标端选择 Hana，并完成以下相关参数配置：
其中参数名称前带 * 的为必填参数，名称前未带 * 的为可选填参数。

3.3.3 字段映射

数据来源和目标端配置完成后，需要指定来源和目标端的字段映射关系，根据字段映射关系，数据集成任务将源端字段中的数据，写入到目标端对应字段中。
字段映射支持选择基础模式和转换模式配置映射：

• 转换模式：
  字段映射支持数据转换，您可根据实际业务需求进行配置，将源端采集的数据，事先通过数据转换后，以指定格式输入到目标端数据库中。
  转换模式详细操作说明详见4.1 转换模式
  在转换模式中，你可依次配置：来源节点、数据转换、目标节点信息：

  配置节点	说明
  来源节点	配置数据来源 Source 节点信息： 节点名称：自定义输入来源节点名称信息，只允许由数字、字母、下划线、-和.组成；且长度不能超过10。 数据字段：通过自动添加、手动添加等方式添加数据来源字段信息。 配置完成后，单击确认按钮，完成来源节点配置。
  数据转换	单击数据转换右侧添加按钮，选择 SQL 转换方式，配置转换信息和规则： 节点名称：自定义输入来源节点名称信息，只允许由数字、字母、下划线、-和.组成；且长度不能超过10。 SQL 脚本：输入 SQL 脚本转换规则，目前仅支持添加一个转换的 SQL 语句，且不能包括 “;”。 配置完成后，单击确认按钮，完成数据转换节点配置。SQL 脚本示例详见4.1.2 添加转换节点。
  目标节点	配置目标节点 Sink 信息： 节点名称：自定义输入来源节点名称信息，只允许由数字、字母、下划线、-和.组成；且长度不能超过10。 数据字段：通过自动添加、手动添加等方式添加数据目标字段信息。 配置完成后，单击确认按钮，完成目标节点配置。

• 基础模式：

  您可通过以下三种方式操作字段映射关系：

  • 自动添加：单击自动添加按钮，根据两端数据表信息，可以自动填充来源和目标的字段信息。
  • 手动添加：单击手动添加按钮，可以手动编辑来源和目标的字段信息，可以逐个添加。
  • 移动\删除字段：您也可以根据需要移动字段映射顺序或删除字段。

3.4 DSL 配置说明

Hana 数据源支持使用脚本模式（DSL）的方式进行配置。
在某些复杂场景下，或当数据源类型暂不支持可视化配置时，您可通过任务脚本的方式，按照统一的 Json 格式，编写 Hana Reader 参数脚本代码，来运行数据集成任务。

3.4.1 进入 DSL 模式

进入 DSL 模式操作流程，可详见 MySQL 数据源-4.4.1 进入DSL 模式。

3.4.2 Hana Reader

进入 DSL 模式编辑界面后，您可根据实际情况替换相应参数，Hana Reader 脚本示例如下：

{
  "job": {
    "common": {
      ...
    },
    "reader": {
      "type": "hana",
      "datasource_id": null,
      "class": "com.bytedance.dts.batch.jdbc.SapHanaInputFormat",
      "connections": [
        {
          "slaves": [
            {
              "host": "xxx.xxx.xx.xxx",
              "db_url": "jdbc:sap://xxx.xxx.xx.xxx:39017/SystemDB",
              "port": 39017
            }
          ],
          "shardNumber": 0
        }
      ],
      "user_name": "***",
      "password": "***",
      "db_name":"_SYS_BIC",
      "table_schema" : "_SYS_BIC",
      "table_name": "VIEW_TEST/SQL_TEST_SCORE_VIEW1",
      "hana_view_placeholder": "PLACEHOLDER.\"$$IN_CALMONTH$$\" => '202305'",
      "filter": "STUDENTID > 5",
      "columns" :[
        {
          "name":"STUDENTID",
          "type":"integer"
        },
        {
          "name":"SCORE",
          "type":"integer"
        }
      ]
    },
    "writer": {
      ...
    }
  }
}

Reader 参数说明，其中参数名称前带 * 的为必填参数，名称前未带 * 的为可选填参数：

3.4.3 Hana Writer

目前暂不支持 DSL 模式配置离线数据写入 Hana，敬请期待。

3.5 高级参数说明

对于可视化配置通道任务，配置运行高级参数时，需在参数名称前加上 job.reader. 前缀。
如离线方式读取 Hana 数据，如果同步带参数的计算视图，且需要过滤数据读取时，则您可以使用以下高级参数：
job.reader.filter、job.reader.hana_view_placeholder 如下图所示：