1. 概述
1.1 版本
FineDataLink 版本 | 功能變動 |
---|---|
4.0 | 定時任務讀寫適配 SQL server |
4.0.7 | 資料管道輸入適配 SQL server 資料管道匯出適配 SQL server |
4.0.20.1 | 資料服務適配 SQL server |
4.1.11.4 | 實時任務讀寫適配 SQL server |
4.1.14.1 | 資料連結支援配置套接字逾時(SocketTimeout 設定項中配置),控制資料庫查詢時間在一個合理範圍內,避免出現無限等待的問題 |
1.2 應用場景
FineDataLink 支援連結 Microsoft SQL Server,進行定時任務讀寫、管道任務讀寫、作為資料服務資料發布源、實時任務讀寫。
2. 準備工作
2.1 前提條件
詳情請參見:前提條件
2.2 版本和驅動
下載對應的驅動包,如何上傳驅動包可參見:驱动管理
注1:4.1.14.1 及之後版本,新增設定項 SocketTimeout,可控制資料庫查詢時間,詳情請參見本文第三章說明;若想使用該設定項,驅動檔案需要在 7 以上版本,使用者需要到官網根據實際資料庫版本下載驅動檔案。
注2:4.2.1.1 之前版本,若使用 SQL Server 資料庫作為管道任務的來源庫,不建議使用自訂驅動。
支援的資料庫版本 | 驅動包下載 |
---|---|
SQL Server 2000 | |
SQL Server 2005 SQL Server 2008 SQL Server 2012 SQL Server 2014 SQL Server 2016 SQL server 2019 注:SQL server 2019 支援在4.0.17.1以及之後的FDL版本中使用 | 已內建無需下載 |
2.3 收集連結資訊
在連結資料庫之前,請收集以下資訊:
資料庫所在伺服器的 IP 地址和埠號。
資料庫的名稱。
資料庫的帳號和密碼。
要連結的資料庫模式。
3. 具體連結步驟
1)管理者登入 FDL 工程,點選「管理系統>資料連結>資料連結管理」,選中某個資料夾後,建立資料連結。如下圖所示:
2)設定資料連結名稱(可同時修改資料連結所在目錄)。如下圖所示:
3)可根據資料源分類、支援形式、適配模組、資料源名稱篩選資料庫。如下圖所示:
4)輸入 2.3 節的連結資訊,驅動由於是內建,選擇「預設即可」。
模式需要連結資料庫後才可以選擇,所以需要先點選「點選連結資料庫」後,再選擇「模式」。如下圖所示:
部分設定項說明如下表所示:
設定項 | 說明 |
---|---|
SocketTimeout(4.1.14.1 及之後版本新增) | 使用者若需要配置該設定項,需要使用 7 以上版本的驅動(産品內建驅動是 6 版本的),需要到官網根據實際資料庫版本下載驅動檔案 1)值說明: 配置當前資料連結的套接字逾時,單位為秒,預設值為 3600 輸入框要求為非負整數,配置為 0 時,視為不設定逾時 2)該設定項應用場景: 在網路發生抖動時,可能會出現管道&定時任務發出查詢後,無限等待傳回資料的問題,使用者維運時,看不到報錯,但實際任務已不再同步資料 配置該設定項後,將控制查詢在一個合理的範圍內,達到套接字逾時時間後,SQL 語句會自動中斷報錯,避免出現無限等待的問題 3)該設定項控制的功能範圍:
|
其他說明 | 注1:使用者若是想要連結非預設實體,可以更改「資料連結URL」為:jdbc:sqlserver://ip:port;instanceName=實體名;databaseName=資料庫名 注2:連結多模式的資料庫時使用 SQL 語句需要帶上模式名前綴進行搜尋,例如 SELECT * FROM [dbo].[asdfg] |
5)點選「測試連結」,若連結成功則「儲存」該連結。如下圖所示:
4.使用資料源
配置好資料源後即可在「定時任務」中使用資料源,詳情參見:定时任务概述
配置好資料源後即可在「資料管道」中將使用資料源,詳情參見:数据管道概述
注1:4.1.1 及之後版本,SQLServer 資料源作為源表,支援 無主鍵同步
注2:4.2.1.1 之前版本,若使用 SQL Server 資料庫作為管道任務的來源庫,配置資料連結時不建議使用自訂驅動;且管道任務的日誌等級不建議為 DEBUG (可設定為 INFO)。否則管道任務中會出現大量 SQL Server cdc 日誌列印。
配置好資料源後即可在「資料服務」中將使用資料源,詳情參見:数据服务概述
配置好資料源後即可在「實時任務」中將使用資料源,詳情參見:实时任务概述
5. 注意事項
配置 SQLServer 資料連結失敗。
問題描述
配置資料連結失敗,提示:驅動程式無法透過使用安全套接字層(SSL)加密與 SQL Server 建立安全連結
原因分析
JDK 新版本增加加密套件導緻。
解決方案
開啟%FDL_HOME%\jre\lib\security\java.security檔案,將3DES_EDE_CBC、 TLS1、TLS1.1、TLS1.2 刪除或者注釋掉,儲存重啟 FineDataLink 即可正常連結。如下圖所示: