1. 概述编辑
1.1 应用场景
FineDataLink 支持连接 Oracle ,进行定时任务读写、管道任务读写、数据服务发布、实时任务读取。
2. 准备工作编辑
2.1 版本和驱动
支持的数据库版本 | 驱动包下载 |
---|---|
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.2 收集连接信息
在连接数据库之前,请收集以下信息:
数据库所在服务器的 IP 地址和端口号;
数据库的名称;
数据库的用户名和密码;
要连接的数据库模式;
3. 具体连接步骤编辑
3.1 thin 方式
若用户需要使用该数据连接进行数据开发任务、数据服务任务或者 LogMiner 模式的数据管道,则使用如下方案。
1)登录 FineDataLink,选择「管理系统>数据连接」,点击「新建数据连接」。如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接管理权限
2)找到 Oracle 数据库,如下图所示:
3)输入 2.2 节的连接信息。若驱动是内置的,选择「默认」;若驱动是自己上传的,可以选择「自定义」,勾选自己要的驱动。
模式需要连接数据库后才可以选择,所以需要先点击「点击连接数据库」后,再选择「模式」,如下图所示:
注:由于Oracle数据库区分大小写,请在填写相关信息时,注意大小写,与数据库实际名称、模式保持一致。
驱动、数据库名称、URL 的介绍如下表所示:
驱动 | DatabaseName | URL |
---|---|---|
oracle.jdbc.driver. OracleDriver | sid_name | jdbc:oracle:thin:@ip:port:sid_name |
service_name | jdbc:oracle:thin:@//ip:port/service_name 或者 jdbc:oracle:thin:@ip:port/service_name | |
TNSName 注:Oracle 安装路径下需要有 tnsnames.ora 文件 | jdbc:oracle:thin:@TNSName |
sid_name 可以通过 select INSTANCE_NAME from v$instance;查询
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)))
3.2 OCI 方式
若用户需要使用该数据连接进行 Xstream 方式管道任务数据同步,且数据来源为 CBD ,由于 XStream 连接依赖了oci 连接,所以不能通过 thin 方式连接 。
因此数据连接 URL 需要改为:
jdbc:oracle:oci:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1533))(CONNECT_DATA=(SID=名称)))
其中 localhost 为 oracle 所在服务器 IP,PORT 为端口、SID后需要写数据库名称。