1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.0 | - |
| 4.1.13.1 | 定时任务、管道任务中，目标表为自动建表时，将自动根据 MySQL 版本确定编码格式和行格式 |
| 4.1.14.1 | 数据连接支持配置套接字超时（SocketTimeout 设置项中配置），控制数据库查询时间在一个合理范围内，避免出现无限等待的问题 |
1.2 功能简介
FineDataLink 支持连接 MySQL ，进行定时任务读写、管道任务读写、数据服务发布、实时任务读写
2. 准备工作
2.1 前提条件
详情请参见：前提条件
2.2 版本和驱动
下载驱动，并将其上传至 FineDataLink，如何上传可参见：驱动管理 2.1 节
| 支持数据库版本 | 驱动包下载 |
|---|---|
V8.0、V5.6.31、V5.5、V5.5.5、V5.6.35、V5.7、V5.6.37、V5.5.46、V6.5、V5.7.16 、V5.6.29、V5.6.22、V5.6.34、V5.6.28、V5.1； 注：V8.0建议使用对应版本驱动。 | 已内置，无需下载 |
| 官方建议： 为获得更好的取数性能，建议使用 Mysql5.5、5.6、5.7 版本的客户，更换 Mysql 数据库驱动为 5.1.37 版本（5.1.37 版本的驱动不支持 V5.1、V8.0 的数据库） | |
| 用户若使用的是其他小版本的数据库，可以从 MySQL官网 下载对应的连接驱动包。 | |
2.3 收集连接信息
在连接数据库之前，请收集以下信息：
数据库所在服务器的 IP 地址和端口号。
数据库的名称。
数据库的用户名和密码。
3. 具体连接步骤
1）管理员登录 FDL 工程，点击「管理系统>数据连接>数据连接管理」，选中某个文件夹后，新建数据连接。如下图所示：
2）设置数据连接名称（可同时修改数据连接所在目录）。如下图所示：
3）可根据数据源分类、支持形式、适配模块、数据源名称筛选数据库。如下图所示：
4）驱动选择「默认」（若用户重新上传了驱动，可以切换为自定义后选择自己的驱动），然后输入 2.3 节的连接信息。如下图所示：
需注意以下几点：
| 设置项 | 说明 |
|---|---|
| 数据连接URL | 1）若出现中文乱码或日期错乱的情况，可在「数据连接URL」后加后缀，格式为：jdbc:mysql://hostname:port/database?generateSimpleParameterMetadata=true&useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai 其中serverTimezone=Asia/Shanghai -----设置以"上海时区"为准；characterEncoding=utf8 ---- 编码转化 2）若使用驱动为 MySQL 8.0，如果使用了 tinyint(1) 这个类型的字段，需要在 URL 中增加后缀tinyInt1isBit=false参数，否则 MySQL 源端的 tinyint 字段被识别为 bit 类型 |
SocketTimeout （4.1.14.1 及之后版本新增） | 1）值说明： 配置当前数据连接的套接字超时，单位为秒，默认值为 3600 输入框要求为非负整数，配置为 0 时，视为不设置超时 2）该设置项应用场景： 在网络发生抖动时，可能会出现管道&定时任务发出查询后，无限等待返回数据的问题，用户运维时，看不到报错，但实际任务已不再同步数据 配置该设置项后，将控制查询在一个合理的范围内，达到套接字超时时间后，SQL 语句会自动中断报错，避免出现无限等待的问题 3）该设置项控制的功能范围：
|
5）点击「测试连接」，若连接成功则「保存」该连接。如下图所示：
4. 使用数据源
4.1 定时任务&管道任务
4.1.1 定时任务
配置好数据源后即可在「定时任务」中使用数据源，详情参见：定时任务概述
MySQL 的数据连接URL后，添加&autoReconnect=true&failOverReadOnly=false可自动重连 MySQL 数据库，避免因数据连接中断导致定时任务失败的情况。
4.1.2 管道任务
配置好数据源后即可在「数据管道」中将使用数据源，详情参见：数据管道概述
4.1.3 通用说明
4.1.13.1 及之后版本，定时任务、管道任务中，目标表为自动建表时，将自动根据 MySQL 版本确定编码格式和行格式：
| 分类 | 说明 | 备注 |
|---|---|---|
| 编码说明 | MySQL 版本号＜ 5.5.3：编码使用 UTF8 MySQL 版本号 >= 5.5.3：编码使用 UTF8MB4 | UTF8、UTF8MB4、COMPACT、DYNAMIC 说明请自行百度 |
| 行格式说明 | 5.0≤ MySQL 版本号＜ 5.7：行格式使用 COMPACT 5.7≤ MySQL 版本号：行格式使用 DYNAMIC |
4.2 数据服务
配置好数据源后即可在「数据服务」中将使用数据源，详情参见：数据服务概述
4.3 实时任务
配置好数据源后即可在「实时任务」中将使用数据源，详情参见：实时任务概述
