1. 概述
通过选项,可以不需要设计器,直接新建数据连接,还可以查看当前报表连接了哪些数据库,并且进行修改。设计器可以创建 JNDI 数据连接 和 多维数据连接 ,平台创建的数据连接在设计器里也可以进行管理。
详细点击 [设计器] JDBC 连接数据库
2. 创建数据连接
以管理员身份进入数据决策系统,点击「管理系统>数据连接>数据连接管理>新建数据连接」可创建新的数据连接,如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接控制
3. 选择数据库类型
单击「新建数据连接」按钮,有三种类型选择,分别为常用,所有,其他。如下图所示:
3.1 常用
固定显示几个常用的数据库类型,分别为 HSQL、IBM DB2、Microsoft SQL Server、MySQL、Oracle。如下图所示:
3.2 所有
FineReport 设计器所有支持的数据库类型,分别为:ADS、Amazon Redshift、Apache Impala、Apache KYLIN、Apache Phoenix、DERBY、GBase 8A、GBase 8S、GBase 8T、H2、华为云DWS、Fusioninsight elk、Fusioninsight HD、GaussDB 200、Hadoop Hive、HBase、HP Vertica、HSQL、IBM DB2、INFORMIX、KINGBASE、Microsoft SQL Server、MySQL、Oracle、Pivotal Greenplum Database、Postgresql、Presto、SAP HANA、SAP Sybase、SPARK、SqLite、TeraData、TRANSWARP INCEPTOR,如下图所示:
主要介绍如下所示:
「内置支持」和「插件支持」默认两个都勾选。
左侧切换数据库类型后,「内置支持」和「插件支持」恢复默认状态。
可通过「内置支持」和「插件支持」的勾选,对数据库类型进行筛选;若都不勾选,则显示空白。
3.3 其他
「其他」类型中包括JNDI数据连接,其他JDBC。如下图所示:
主要介绍如下所示:
新建数据连接包括 JDBC 数据连接和 JNDI 数据连接,和已适配的第三方数据源插件。
平台未适配的数据连接,平台中只能读取到数据源的名字,无法新建、编辑及查看具体的设置,只能在设计器中进行新建、编辑和查看。
3.3.1 JNDI 数据连接
在「其他」类型中选择「JNDI数据连接 」,如下图所示:
注:JNDI 数据连接请参考 JNDI数据连接
3.3.2 其他 JDBC
如果数据库列表中没有所需的数据库类型,则选择「其他JDBC 」。
将对应驱动包放置在%FR_HOME%\webapps\webroot\WEB-INF\lib下面并重启报表服务器。
在「其他」类型中选择「其他JDBC」,手动输入驱动器名称、URL 等完整数据连接信息,点击「测试连接」连接成功后,点击「保存」即可。如下图所示:
1)数据连接信息:数据连接名称、驱动器、URL、编码(推荐直接选自动即可,2018-12-27 及以后的 JAR 开始支持)、用户名、密码。
2)测试连接:测试数据库配置是否成功,若成功则弹出「连接成功」,若失败则显示失败详细原因。
4. 配置信息介绍
具体配置信息请根据实际数据库参考对应文档进行配置。
不同数据库需配置的信息可能有所不同,下面介绍「模式」和「认证方式」这两个属性的具体信息。
4.1 模式
在连接 Amazon Redshift 、Apache KYLIN、Apache Phoenix、DEBRY、HP Vertica、IBM DB2、INFORMIX、Microsoft SQL Server、Oracle、Pivotal Greenplum Database、Postgresql、GBase 8S、GBase 8T、KINGBASE、Presto、SAP HANA、SAP Sybase、Hbase 这些数据库时,会比其他数据连接多了一步:模式。如下图所示:
模式介绍如下所示:
如果这些数据库未进行模式选择,则默认选择的是第一个模式。
当数据库不存在模式选择,则无需进行模式选择。
模式默认不可编辑,点击「点击连接数据库」且连接成功后可编辑。
模式建立的初衷是为了其他功能更容易读取数据库里的数据,选择「默认值」即可。
连接多模式的数据库时使用 SQL 语句需要带上模式名前缀进行搜索。
注:有模式选择的数据库,需要保证数据库中有可用的模式,否则连接时会报错。
4.2 认证方式
其中 APACHE IMPALA、Hadoop Hive、SPARK 、TRANSWARP INCEPTOR、APACHE Phoenix、HBase 这六个数据库在配置数据连接时有 认证方式这一选项。如下图所示:
具体介绍如下所示:
若数据库支持多种认证方式,则点击会出现认证方式下拉框。
若选择「Kerberos」认证,则填入注册过 kdc 的客户端名称和 keytab 密钥路径。
详细 Kerberos 认证请参考 [平台]数据连接 Kerberos 认证
4.3 高级设置
高级设置界面如下图所示:
各参数介绍请参见:连接池属性 文档中的 2.2 节内容。
5. 管理数据连接
5.1 管理范围
在数据决策系统中,点击「管理系统>数据连接>数据连接管理」,点击某一数据库右侧图标,如下图所示:
注:未适配的数据库类型右侧不显示图标。
点击某一数据连接右侧图标后,出现的按钮介绍如下表所示:
按钮名称 | 说明 |
---|---|
测试连接 | 测试数据库配置是否成功 |
编辑 | 点击「编辑」按钮后,可修改数据连接的各配置项 |
重命名 | 重命名该数据连接 |
复制 | 复制该数据库,且数据连接名自动加 1 |
删除 | 删除该数据库 |
类型、创建者 | 显示数据库类型和创建者 |
平台未适配的数据连接,例如未适配的第三方数据源插件,平台中只能读取到数据源的名字,无法新建、编辑及查看具体的设置,只能在设计器中进行新建、编辑和查看。提示「该类型暂仅支持在设计器中使用旧版本数据连接查看」,如下图所示:
5.2 连接池状态
注:只有 JDBC 类型的数据库有连接池。
数据连接界面提供连接池状态页面,可看到目前已创建的数据连接及对应的连接状态,如下图所示:
「活动连接数」和「空闲连接数」的说明如下表所示:
连接池状态 | 说明 |
---|---|
活动连接数 | 连接池最大可创建的连接数,若最大连接数是 10 ,程序已申请 10 个连接,而且一直在使用,第 11 个连接申请时报错:active 10 maxActive 10 |
空闲连接数 | 当前处于空闲状态的连接, 随时会转成活动连接, 空闲状态超过最大空闲连接时间时自动释放 活动连接数+空闲连接数=实际物理连接数 |