1. 概述
1.1 版本
| FineReport 版本 | 功能变动 |
|---|---|
| 10.0 | - |
| 10.0.18 | 内置驱动版本由 ojdbc14.jar 更改为 ojdbc8.jar |
1.2 应用场景
ORACLE 数据库是目前世界上使用最为广泛的数据库管理系统，作为一个通用的数据库系统，它具有完整的数据管理功能；作为一个关系数据库，它是一个完备关系的产品；作为分布式数据库它实现了分布式处理功能。
本文介绍 Oracle 数据连接的步骤。
注：平台数据连接各设置项详细介绍请参考 [平台]数据连接
2. 配置信息
| 支持数据库版本 | 驱动下载链接 |
|---|---|
Oracle 11.1 Oracle 11.2 / 11g-R2 Oracle 12.1 / 12c-R1 Oracle 12.2 / 12c-R2 Oracle 13 及以上 Oracle 19c | FineReport 已内置 ojdbc8.jar 驱动包，无需下载 （oracle.jdbc.driver.OracleDriver） |
Oracle 9.2.0 / 9i Oracle 10.1 Oracle 10.2 / 10g-R2 | 注：若使用该驱动文件，需要将该驱动文件放到工程的 webapps\webroot\WEB-INF\lib 路径下，同时删除 ojdbc8.jar，重启工程 |
3. 操作步骤
3.1 新建数据连接
1）以管理员身份登录数据决策系统，点击「管理系统>数据连接>数据连接管理」，点击「新建数据连接」，如下图所示：
注：如果非管理员用户想要配置数据连接，需要管理员给其分配管理系统下数据连接节点的权限，具体操作请查看 数据连接控制
2）在「常用」选项下选择「Oracle」，如下图所示：
3.2 配置数据连接
根据实际情况输入对应的数据连接信息，如下图所示：
1）驱动、数据库名称、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 |
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)))
2）其他设置项介绍如下表所示：
| 设置项 | 说明 |
|---|---|
| 数据连接名称 | 用户可自定义，不可为空 |
| 数据库名称/主机/端口 | 所连接的 Oracle 数据库名称、主机、端口号，根据实际情况填写 |
| 用户名/密码 | 所连接的 Oracle 数据库的用户名和密码 |
| 编码 | 根据实际情况选择编码 |
3.3 测试连接
点击「测试连接」，或者在「模式」下点击「点击连接数据库」，若弹出连接成功提示框，则表示成功连接上数据库，如下图所示：
连接成功后，模式会自动选择默认值，如下图所示：
注1：模式建立的初衷是为了其他功能更容易读取数据库里的数据，选择「默认值」即可。
注2：连接多模式的数据库时使用 SQL 语句需要带上模式名前缀进行搜索，例如 SELECT * FROM "ABBY"."FR_S_UEP"
3）点击右上角「保存」按钮。
3.4 效果查看
1）Oracle 数据库连接成功后，可在平台对其进行编辑、重命名、复制、删除等操作，如下图所示：
2）同时，FineReport 设计器中自动生成已配置成功的数据连接，如下图所示：
4. 注意事项
Oracle 数据连接中一些报错及解决方案请参见：Oracle 数据连接常见错误解决方案