1. 概述
1.1 版本
FineDataLink版本 | 功能變動 |
---|---|
4.0 | 定時任務讀寫適配 Oracle |
4.0.7 | 資料管道輸入適配 Oracle |
4.0.9 | 資料管道匯出適配 Oracle |
4.0.18 | 支援 Oracle18c、19c 、Oracle RAC叢集作為資料管道任務讀取資料源 |
4.0.20.1 | 資料服務支援 Oracle |
4.1.4 | 「高階資料源 - Oracle(XStream)」合併至「高階資料源 - Oracle(Logminer)」,共同由「高階資料源 - Oracle(Logminer)」控制注冊 |
4.1.11.4 | 實時任務讀寫適配 Oracle |
4.1.14.1 | 資料連結支援配置套接字逾時(SocketTimeout 設定項中配置),控制資料庫查詢時間在一個合理範圍內,避免出現無限等待的問題 |
1.2 應用場景
FineDataLink 支援連結 Oracle ,進行定時任務讀寫、管道任務讀寫、資料服務發布、實時任務讀寫。
2. 準備工作
2.1 前提條件
詳情請參見:前提條件
2.2 版本和驅動
支援的資料庫版本 | 驅動包下載 |
---|---|
Oracle 11.1 Oracle 11.2 / 11g-R2 Oracle 12.1 / 12c-R1 Oracle 12.2 / 12c-R2 Oracle 13 及以上 | 已內建,無需下載 |
Oracle 9.2.0 / 9i Oracle 10.1 Oracle 10.2 / 10g-R2 | 上傳驅動包的具體步驟可參見:驱动管理 |
Oracle 19c 及以上 | 推薦使用最新的驅動包,驅動包下載詳情參見:驅動下載,選擇指定版本的 ojdbc8.jar 注:上傳前需要先關閉工程,在%FineDataLink%/webapps/webroot/WEB-INF/lib 下將原先的 ojdbc8 jar刪除,然後更換成新的驅動後再重啟工程。 |
2.3 收集連結資訊
在連結資料庫之前,請收集以下資訊:
資料庫所在伺服器的 IP 地址和埠號。
資料庫的名稱。
資料庫的帳號和密碼。
要連結的資料庫模式。
3. 具體連結步驟
3.1 thin 方式
若使用者需要使用該資料連結進行資料開發任務、資料服務任務或者 LogMiner 模式的資料管道,則使用如下方案。
1)管理者登入 FDL 工程,點選「管理系統>資料連結>資料連結管理」,選中某個資料夾後,建立資料連結。如下圖所示:
2)設定資料連結名稱(可同時修改資料連結所在目錄)。如下圖所示:
3)可根據資料源分類、支援形式、適配模組、資料源名稱篩選資料庫。如下圖所示:
4)輸入 2.3 節的連結資訊。若驅動是內建,選擇「預設」;若驅動是自己上傳的,可以選擇「自訂」,勾選自己要的驅動。
模式需要連結資料庫後才可以選擇,所以需要先點選「點選連結資料庫」按鈕後,再選擇「模式」。如下圖所示:
注:由於 Oracle 資料庫區分大小寫,請在填寫相關資訊時,注意大小寫,與資料庫實際名稱、模式保持一緻。
部分設定項介紹如下表所示:
設定項 | 說明 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
驅動、資料庫名稱、URL |
TNSName 說明如下: jdbc:oracle:thin:@TNSName URL 中,TNSName 的值為tnsnames.ora檔案中 ORCL 的值,如下圖所示: 完整的 URL 為:jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST =(ADDRESS=(PROTOCOL=TCP)(HOST =localhost)(PORT=1521)))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=orcl))) | ||||||||||
SocketTimeout (4.1.14.1 及之後版本新增) | 1)值說明: 配置當前資料連結的套接字逾時,單位為秒,預設值為 3600 輸入框要求為非負整數,配置為 0 時,視為不設定逾時 2)該設定項應用場景: 在網路發生抖動時,可能會出現管道&定時任務發出查詢後,無限等待傳回資料的問題,使用者維運時,看不到報錯,但實際任務已不再同步資料 配置該設定項後,將控制查詢在一個合理的範圍內,達到套接字逾時時間後,SQL 語句會自動中斷報錯,避免出現無限等待的問題 3)該設定項控制的功能範圍:
|
5)點選「測試連結」,若連結成功則「儲存」該連結。如下圖所示:
3.2 OCI 方式
若使用者需要使用該資料連結進行 Xstream 方式管道任務資料同步,且資料來源為 CBD ,由於 XStream 連結依賴了oci 連結,所以不能透過 thin 方式連結 。
因此資料連結 URL 需要改為:
其中 localhost 為 oracle 所在伺服器 IP,PORT 為埠、SID後需要寫資料庫名稱。
注:SocketTimeout 設定項說明請參見本文 3.1 節內容。