数据去向

1 概述

1.1 版本

1.2 功能简介

本文针对[单表同步-数据去向]Tab界面中的配置项进行说明，包括：数据同步目标、字段映射等。如下图：

2 功能说明

2.1 数据同步目标

包括目标数据源、目标表和表描述配置项。
1、数据同步目标
选择数据需要写入的数据库，仅展示当前应用内已配置过的数据连接且当前用户有使用权限的选项。
目前支持的数据连接类型包括：MySQL、SQL Server、Oracle、达梦、PostgreSql、PolarDB O、ClickHouse，后续将逐步进行扩充。
2、表
支持两种选择表方式：已存在表、自动建表。
1）已存在表
选择目标数据库中已有的表来存放数据。

2）自动建表
直接在目标数据库中新建一张表来存放，需要手动输入表名、表描述以及字段配置进行建表。

3、表描述
即表注释。
1）表选择“已存在表”时，显示所选表的表描述信息，没有则显示”–”；
2）表选择“自动建表”时，默认无描述信息，可以自定义描述信息。如下图：

2.2 字段映射

2.2.1 自动映射规则

设置源表跟目标表的字段映射关系，如下图所示：

默认同名映射，即按照目标表字段与来源表字段名称相同的情况匹配，整体逻辑为：
1）根据来源字段，在目标表中寻找同名（字符完全相同，不区分大小写）字段对其进行匹配；
2）如果在目标表中找不到同名字段，则右侧映射字段显示为空，即默认不映射;
3）不映射的字段进行数据同步时不进行数据回写。

2.2.2 编辑映射

1）当表选择的“已存在表”时，默认按照自动映射规则映射到对应字段，还可对目标表字段做如下设置：
①通过更改选择的字段修改某字段的映射关系；
②选择空项时表示该字段不进行映射。

注：字段类型、主键以及是否不为空都是自动从数据库带入，且不允许编辑。

2）当表选择的“自动建表”时，默认将源表对应的字段带入目标字段中，可对其进行如下设置：
①修改字段名称更改某字段的映射关系；
②清空字段名称取消某字段的映射关系；
③修改字段类型
④设置主键字段，支持设置多主键；
⑤设置字段是否不为空。

2.2.3 手动建表

“手动建表”功能是表选择“自动建表”时的特有功能。如下图：

表名、表描述和字段配置（包括字段名称、类型、主键设置、是否不为空）完成后，可点击“手动建表”进入建表界面，如下图：

默认根据配置自动生成对应的SQL语句，用户可进行修改，可修改字段名、字段类型，以及定义各种表的特性。

注:索引可在手动建表编辑框中自行创建。

编辑好之后，点击“确定”将在对应数据库中进行建表，建表成功后“表”对应选项将自动切换为已存在表并显示对应的表描述。
建表时将遵守以下规则：
①数据库关键字一定要加定界符；
②其他则按照数据连接上是否启用“区分大小写”配置进行处理。

2.2.4 重新获取

当源表或目标表发生变化时，可点击“重新获取”按钮将重新获取源字段和目标字段，进行重新映射，并更新对应字段名称、字段类型、表描述等信息。