1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.2.19.3 | 适配 TCHouse-P 数据源,支持:定时任务读取和写入、实时任务写入、实时管道写入 |
1.2 功能简介
FineDataLink 支持连接 TCHouse-P ,进行定时任务读写、实时任务写入、实时管道写入。
2. 配置数据连接
2.1 前提条件
详情请参见:前提条件
1)需要注册「大数据」功能点。
2)FDL 所在服务器和 TCHouse-P 集群需要在同一 VPC 子网内;如果不在,需要先 开通公网访问
2.2 版本和驱动
| 支持的数据库版本 | 驱动包下载 |
|---|---|
| 3.9.16.6 及以上版本 | 已内置,无需下载 |
2.3 收集连接信息
在连接数据库之前,请收集以下信息:
数据库所在服务器的 IP 地址和端口号。
数据库的名称。
数据库的用户名和密码。
2.4 具体连接步骤
创建数据连接步骤请参见:创建并管理数据源
部分设置项说明如下:

| 设置项 | 说明 |
|---|---|
| 主机 | 腾讯云数据仓库 TCHouse-P 集群访问地址,在集群管理页面中查询:官方文档说明 |
| 端口 | 腾讯云数据仓库 TCHouse-P 集群端口 |
| 用户名、密码 | 创建集群时的用户名、、密码 |
3. 使用数据源
3.1 定时任务
3.1.1 读取
1)定时任务中支持读取 TCHouse-P。如下图所示:

2)支持读取分区表。
3)支持获取表描述。
4)支持 并行取数 功能。
3.1.2 写入-数据去向与映射
1)定时任务中支持将处理好的数据写入到 TCHouse-P。如下图所示:

2)支持 表描述 功能。
3)目标表为已存在表时,支持写入分区表,支持查看分区键配置。
4)目标表为「已存在表」,显示已存在表的字段备注,不支持修改字段备注;目标表为「自动建表」,可自定义字段注释。
5)目标表若为自动建表,支持设置分布键。
6)目标表若为自动建表且目标表已设置主键,支持选择主键作为分区键。

分区字段将被视为1级分区键;分区键支持的字段类型:
日期类型,date、timestamp等;
文本类型,char、varchar、text等;
数值类型,tinyint、smallint、int、bigint、float、double、decimal等
3.1.3 写入-写入方式

1)支持 事务控制 功能。
2)装载方式:
| 装载方式 | 说明 |
|---|---|
| 普通装载 | 应用场景: 数据写入量小时推荐使用;或无法提供 COPY 方案所需用户权限时,选择普通装载方式 功能简介: 默认为普通装载 以 JDBC 做串行装载 |
| COPY装载 | 应用场景: 数据写入量较大时推荐使用,目前建议用户使用 COPY 装载,写入速度较快 前提条件: 若选择 COPY 装载方式,需要在目标数据库先创建 fdl_temp 模式用来存放临时表,需要用户有建表、建指定模式的权限(如果已由 DBA 建好模式并赋权,数据库用户可不需要建schema的权限) |
3.2 实时任务写入
1)该数据源支持作为实时任务的目标端。

2)目标表为已存在表时,支持写入分区表,支持查看分区键配置。
3)目标表为「已存在表」,显示已存在表的字段备注,不支持修改字段备注;目标表为「自动建表」,可自定义字段注释。
4)目标表若为自动建表,支持设置分布键。
5)目标表选择「已存在」表时,显示已存在表的表描述;目标表选择「自动建表」时,默认显示为空,可自定义表描述。
6)目标表若为自动建表且目标表已设置主键,支持选择主键作为分区键。

分区字段将被视为1级分区键;分区键支持的字段类型:
日期类型,date、timestamp等;
文本类型,char、varchar、text等;
数值类型,tinyint、smallint、int、bigint、float、double、decimal等
3.3 实时管道写入
1)该数据源支持作为实时管道任务的目标端。

2)支持 同步源表结构变化 功能。
3)存量阶段:清空目标表再写入;增量阶段:将源表数据的增删改同步至目标表。
4)存量和增量阶段写入方式:默认都走 COPY,无法支持 COPY 时,则降级为 JDBC。
5)目标表为已存在表时,支持写入分区表,支持查看分区键配置。
6)目标表若为自动建表,支持设置分布键。
7)支持 表描述、字段注释 功能。
8)目标表若为自动建表且目标表已设置主键,支持选择主键作为分区键。

分区字段将被视为1级分区键;分区键支持的字段类型:
日期类型,date、timestamp等;
文本类型,char、varchar、text等;
数值类型,tinyint、smallint、int、bigint、float、double、decimal等
