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 實時任務
配置好數據源後即可在「實時任務」中将使用數據源，詳情參見：实时任务概述
上一篇：配置Hadoop Hive資料源