本文为您介绍SAP HANA Writer支持的数据类型、字段映射和数据源等参数及配置示例。

背景信息

SAP HANA Writer插件实现了写入数据至SAP HANA数据库目标表的功能。在底层实现上，SAP HANA Writer通过JDBC连接远程SAP HANA数据库，并执行相应的insert into或replace into语句，写入数据至SAP HANA。数据库本身采用InnoDB引擎，以分批次提交数据入库。

SAP HANA Writer作为数据迁移工具，为数据库管理员等用户提供服务。根据您配置的writeMode，通过数据同步框架获取Reader生成的协议数据。
说明 整个任务必须具备insert/replace into的权限。您可以根据配置任务时，在preSql和postSql中指定的语句，判断是否需要其它权限。

参数说明

参数 描述 是否必选 默认值
datasource 数据源名称，脚本模式支持添加数据源，此配置项填写的内容必须与添加的数据源名称保持一致。 是 无
table 选取的需要同步的表名称。 是 无
column 目标表需要写入数据的字段，字段之间用英文所逗号分隔，例如"column": ["id", "name", "age"]。

如果要依次写入全部列，使用星号（*）表示， 例如"column":["*"]。

说明 当来源端字段名称包含斜杠（/），需要使用反斜杠加双引号（\"your_column_name\"）进行转义，例如，字段名称为/abc/efg，则转义后字段名称为\"/abc/efg\"。
是 无
preSql 执行数据同步任务之前率先执行的SQL语句。目前向导模式仅允许执行一条SQL语句，脚本模式可以支持多条SQL语句。例如，执行前清空表中的旧数据：
truncate table tablename
。
说明 当有多条SQL语句时，不支持SQL事务原子性。
否 无
postSql 执行数据同步任务之后执行的SQL语句，目前向导模式仅允许执行一条SQL语句，脚本模式可以支持多条SQL语句。例如，加上某一个时间戳：alter table tablenameadd colname timestamp DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP。 否 无
batchSize 一次性批量提交的记录数大小，该值可以极大减少数据同步系统与数据源的网络交互次数，并提升整体吞吐量。如果该值设置过大，会导致数据同步运行进程OOM异常。 否 1024

配置示例：向导模式

  1. 选择数据源。

    配置同步任务的数据来源和数据去向。

    去向数据源
    参数 描述
    数据源 即上述参数说明中的datasource，通常填写您配置的数据源名称。
    表 即上述参数说明中的table。
    导入前准备语句 即上述参数说明中的preSql，输入执行数据同步任务之前率先执行的SQL语句。
    导入后完成语句 即上述参数说明中的postSql，输入执行数据同步任务之后执行的SQL语句。
  2. 字段映射，即上述参数说明中的column。左侧的源头表字段和右侧的目标表字段为一一对应的关系。字段映射
    参数 描述
    同名映射 单击同名映射，可以根据名称建立相应的映射关系，请注意匹配数据类型。
    同行映射 单击同行映射，可以在同行建立相应的映射关系，请注意匹配数据类型。
    取消映射 单击取消映射，可以取消建立的映射关系。
    自动排版 可以根据相应的规律自动排版。
  3. 通道控制。通道配置
    参数 描述
    任务期望最大并发数 数据同步任务内，可以从源并行读取或并行写入数据存储端的最大线程数。向导模式通过界面化配置并发数，指定任务所使用的并行度。
    同步速率 设置同步速率可以保护读取端数据库，以避免抽取速度过大，给源库造成太大的压力。同步速率建议限流，结合源库的配置，请合理配置抽取速率。
    错误记录数 错误记录数，表示脏数据的最大容忍条数。
    分布式处理能力 暂不支持，敬请期待。

配置示例：脚本模式

脚本配置示例如下所示。
{
    "type":"job",
    "version":"2.0",//版本号。
    "steps":[
        {
            "stepType":"stream",
            "parameter":{},
            "name":"Reader",
            "category":"reader"
        },
        {
            "stepType":"saphana",//插件名。
            "parameter":{
                "postSql":[],//导入后的准备语句。
                "datasource":"",//数据源。
                "column":[//列名。
                    "id",
                    "value"
                ],
                "batchSize":1024,//一次性批量提交的记录数大小。
                "table":"",//表名。
                "preSql":[
                     "delete from XXX;" //导入前的准备语句。
                   ]
            },
            "name":"Writer",
            "category":"writer"
        }
    ],
    "setting":{
        "errorLimit":{//错误记录数。
            "record":"0"
        },
        "speed":{
            "throttle":true,//当throttle值为false时，mbps参数不生效，表示不限流；当throttle值为true时,表示限流。
            "concurrent":1, //作业并发数。
            "mbps":"12"//限流
        }
    },
    "order":{
        "hops":[
            {
                "from":"Reader",
                "to":"Writer"
            }
        ]
    }
}