1. 概述编辑
ORACLE 数据库是目前世界上使用最为广泛的数据库管理系统,作为一个通用的数据库系统,它具有完整的数据管理功能;作为一个关系数据库,它是一个完备关系的产品;作为分布式数据库它实现了分布式处理功能。
本章我们将介绍如何在 FineBI 中连接 Oracle 数据库。
注:数据连接各设置项详细介绍请参见:配置数据连接
2. 配置信息编辑
支持数据库版本 | 驱动下载链接 |
---|---|
Oracle 9.2.X Oracle 10.2.0 Oracle 11.2.0 Oracle 12.1.0 | FineBI 已内置 ojdbc14.jar 驱动包,无需下载 |
Oracle 19c | 注:将该驱动文件放到工程的 webapps\webroot\WEB-INF\lib 路径下,同时删除 ojdbc14.jar,重启工程 |
3. 操作步骤编辑
3.1 新建数据连接
1)以管理员身份登录数据决策系统,点击「管理系统>数据连接>数据连接管理>新建数据连接」,如下图所示:
2)在「常用」选项下选择「Oracle」,如下图所示:
3.2 配置数据连接
根据实际情况输入对应的数据连接信息,如下图所示:
驱动、数据库名称、URL 的介绍如下表所示:
驱动 | Database Name | URL |
---|---|---|
oracle.jdbc.driver .OracleDriver | sid_name 注:Oracle10g 之后已经不再支持 sid 写法 | jdbc:oracle:thin:@ip:port:sid_name |
service_name | jdbc:oracle:thin:@//ip:port/service_name |
其他设置项介绍如下表所示:
设置项 | 说明 |
---|---|
数据连接名称 | 用户可自定义,不可为空 |
数据库名称/主机/端口 | 所连接的 Oracle 数据库名称、主机、端口号,根据实际情况填写 |
用户名/密码 | 所连接的 Oracle 数据库的用户名和密码 |
编码 | 根据实际情况选择编码 |
3.3 测试连接
点击「测试连接」,或者在「模式」下点击「点击连接数据库」,若弹出连接成功提示框,则表示成功连接上数据库,如下图所示:
注:连接成功后,模式会自动选择默认值。
3)点击右上角「保存」按钮。
3.4 效果查看
Oracle 数据库连接成功后,可在平台对其进行编辑、重命名、复制、删除等操作,如下图所示:
4. 注意事项编辑
在 Oracle 9i 版本中,精度为 0 的字段值会被识别成文本而不是数值「该字段值用 column.getSize() 计算得到的是 38 ,所以会被识别成文本属性」;其他版本的 Oracle 未有此现象出现。
BI 平台 Oracle 连接池在一段时间没有使用会自动释放,之所以查看连接池有之前的连接,是因为后面用户连接时又重新启用,所以不会因为连接一直得不到释放而造成问题。
4.1 报错相关
在 2019-01-15 之前的版本中,若为 Spider 引擎开启实时数据,直连 Oracle 数据库的话,超过 22 位的字段需要使用 SQL 语句转义添加到 FineBI 中。原因是 FineBI 直连会在字段前加 8 位字符,而 Oracle 超过 30 位标识符在将表添加到 FineBI 中时就会报错 ORA-000972。
注:在 2019-01-15 之后的 FineBI5.1 版本已经修复该问题,可开启实时数据,直接添加最多 30 位的字段/表名至 FineBI 中。
SQL 转义语句可使用:select “超过22位字段名的字段” as 转义名 from 表,如下图所示:
所有以 ORA 开头的报错都是 Oracle 数据库报错,可以通过在网络上对报错信息进行搜索,排查报错。如下图所示:
4.2 ONS configuration failed
问题描述:
Oracle19c 数据连接报错:create connection error java.lang.IllegalArgumentException: ONS configuration failed
如下图所示:
解决方案:
Linux/Unix 修改 startWebLogic.sh 文件,搜索「setDomainENV.sh」,然后在「.${DOMAIN_HOME}」这句的上一行插入「JAVA_OPTIONS="-Doracle.jdbc.fanEnabled = false"」,如下图所示:
4.3 表名/表头乱码
问题描述:
Oracle 数据连接,添加 DB 表,表名/表头乱码。
解决方案:
将 Oracle 数据库的编码改成SIMPLIFIED CHINESE_CHINA.ZHS16GBK
4.4 Oracle 11 无法读取 DB 表
问题描述:
Oracle11无法取 DB 表,日志报错如下图所示:
解决方案:
点击下载:orai18n.jar,把orai18n.jar放到工程的webapps\webroot\WEB-INF\lib下,并重启工程。
4.5 Got minus one from a read call
问题描述:
数据连接失败,报错:Got minus one from a read call
原因分析:
当连接数据库时,是通过连接池的机制进行连接的,数据库参数:max-session决定连接池的大小,而应用同样也有一个参数,这个参数表示它连接数据库连接池所占用的最少资源。
例如:总共有 10 个应用需要连接数据库,如果每个应用连接数据库的最小连接数为 10 ,那么10个应用总共会有 100 个连接,这样就要求数据库连接池的 max-session 必须大于100,否则就会报Got minus one from a read call的错误。
解决方案:
1)查看 processes 和 sessions 参数
SQL 语句分别为:
show parameter processes
show parameter sessions
2)修改 processes 和 sessions 值
SQL 语句分别为:
alter system set processes=300 scope=spfile;
alter system set sessions=335 scope=spfile;
3)重启 Oracle
SQL 语句为:
shutdown immediate;
startup;
4.6 数据连接成功后无法选择模式
问题描述:
Oracle 版本 9.2.0.4 ,使用 2020-01-15 的 JAR ,连接成功后无法选择模式,也不显示数值。
原因分析:
驱动版本不适配。
解决方案:
根据实际情况换成支持的驱动,驱动下载链接:驱动下载官方链接
示例:换成 ojdbc6 驱动才可以正常显示数据和选择模式。