配置MySQL資料源- FineDatalink 幫助文檔

文檔創建者：Roxy

編輯次數：15

最近更新：Nikozhan 于 2025-12-01

1. 概述

1.1 版本

FineDataLink 版本	功能變動
4.0	-
4.1.13.1	定時任務、管道任務中，目標表為自動建表時，將自動根據 MySQL 版本確定編碼格式和行格式
4.1.14.1	資料連結支援配置套接字逾時（SocketTimeout 設定項中配置），控制資料庫查詢時間在一個合理範圍內，避免出現無限等待的問題
4.2.8.2	定時管道任務的資料去向支援：MySQL

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-connector-java-5.1.37.jar
使用者若使用的是其他小版本的資料庫，可以從 MySQL官網下載對應的連結驅動包。

支援資料庫版本

驅動包下載

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-connector-java-5.1.37.jar

使用者若使用的是其他小版本的資料庫，可以從 MySQL官網下載對應的連結驅動包。

2.3 收集連結資訊

在連結資料庫之前，請收集以下資訊：

資料庫所在伺服器的 IP 地址和埠號。
資料庫的名稱。
資料庫的帳號和密碼。

2.4. 具體連結步驟

建立資料連結步驟請參見：建立並管理資料源

需注意：

1）若使用者重新上傳了驅動，可以切換為自訂後選擇自己的驅動。

2）部分設定項說明如下：

需注意以下幾點：

設定項	說明
資料連結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）該設定項控制的功能範圍：定時任務：對應資料源讀寫、SQL腳本執行、參數指派、全局指派參數管道任務：對應資料源讀寫資料發布：對應資料源查詢庫表管理：SQL執行

設定項

說明

資料連結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）該設定項控制的功能範圍：

定時任務：對應資料源讀寫、SQL腳本執行、參數指派、全局指派參數
管道任務：對應資料源讀寫
資料發布：對應資料源查詢
庫表管理：SQL執行

3. 使用資料源

3.1 定時任務&管道任務

3.1.1 定時任務

配置好資料源後即可在「定時任務」中使用資料源，詳情參見：定時任務概述

MySQL 的資料連結URL後，新增&autoReconnect=true&failOverReadOnly=false可自動重連 MySQL 資料庫，避免因資料連結中斷導緻定時任務失敗的情況。

3.1.2 管道任務

配置好資料源後即可在「資料管道」中將使用資料源，詳情參見：資料管道概述

3.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

分類

說明

備注

編碼說明

MySQL 版本號＜ 5.5.3：編碼使用 UTF8

MySQL 版本號 >= 5.5.3：編碼使用 UTF8MB4

UTF8、UTF8MB4、COMPACT、DYNAMIC 說明請自行百度

行格式說明

5.0≤ MySQL 版本號＜ 5.7：行格式使用 COMPACT
5.7≤ MySQL 版本號：行格式使用 DYNAMIC

3.2 資料服務

配置好資料源後即可在「資料服務」中將使用資料源，詳情參見：資料服務概述

3.3 實時任務

配置好資料源後即可在「實時任務」中將使用資料源，詳情參見：實時任務概述

3.4 定時管道

4.2.8.2 及之後版本，定時管道任務的資料去向支援：MySQL，詳情請參見：定時管道概述

3.5 資料服務