最新历史版本 :[平台]数据连接管理 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

通过数据连接选项,可以不需要设计器,直接新建数据连接,还可以查看当前报表连接了哪些数据库,并且进行修改。设计器可以创建 JNDI 数据连接 和 多维数据连接 ,平台创建的数据连接在设计器里也可以进行管理。

详细点击 [设计器] JDBC 连接数据库

2. 创建数据连接编辑

以管理员身份进入数据决策系统,点击「管理系统>数据连接>数据连接管理>新建数据连接」可创建新的数据连接,如下图所示:

注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接控制

13.png

3. 选择数据库类型编辑

单击「新建数据连接」按钮,有三种类型选择,分别为常用所有其他。如下图所示:

1572944923603838.png

3.1 常用

固定显示几个常用的数据库类型,分别为 HSQL、IBM DB2、Microsoft SQL Server、MySQL、Oracle。如下图所示:

1572934835341883.png

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,如下图所示:

1572935833638149.png

主要介绍如下所示:

  • 「内置支持」和「插件支持」默认两个都勾选。

  • 左侧切换数据库类型后,「内置支持」和「插件支持」恢复默认状态。

  • 可通过「内置支持」和「插件支持」的勾选,对数据库类型进行筛选;若都不勾选,则显示空白。

3.3 其他

「其他」类型中包括JNDI数据连接,其他JDBC。如下图所示:

1572936454592950.png

主要介绍如下所示:

  • 新建数据连接包括 JDBC 数据连接和 JNDI 数据连接,和已适配的第三方数据源插件。

  • 平台未适配的数据连接,平台中只能读取到数据源的名字,无法新建、编辑及查看具体的设置,只能在设计器中进行新建、编辑和查看。

3.3.1 JNDI 数据连接

在「其他」类型中选择「JNDI数据连接 」,如下图所示:

1572939228231981.png

注:JNDI 数据连接请参考 JNDI数据连接

3.3.2 其他 JDBC

如果数据库列表中没有所需的数据库类型,则选择「其他JDBC 」。

将对应驱动包放置在%FR_HOME%\webapps\webroot\WEB-INF\lib下面并重启报表服务器。

在「其他」类型中选择「其他JDBC」,手动输入驱动器名称、URL 等完整数据连接信息,点击「测试连接」连接成功后,点击「保存」即可。如下图所示:

1572941927774884.png

1)数据连接信息:数据连接名称、驱动器、URL、编码(推荐直接选自动即可,2018-12-27 及以后的 JAR 开始支持)、用户名、密码。

2)测试连接:测试数据库配置是否成功,若成功则弹出「连接成功」,若失败则显示失败详细原因。

注:可参考 Cache数据连接 和 dBASE数据连接

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 这些数据库时,会比其他数据连接多了一步:模式。如下图所示:

1602655951855142.png

模式介绍如下所示:

  • 如果这些数据库未进行模式选择,则默认选择的是第一个模式。

  • 当数据库不存在模式选择,则无需进行模式选择。

  • 模式默认不可编辑,点击「点击连接数据库」且连接成功后可编辑。

  • 模式建立的初衷是为了其他功能更容易读取数据库里的数据,选择「默认值」即可。

  • 连接多模式的数据库时使用 SQL 语句需要带上模式名前缀进行搜索。

注:有模式选择的数据库,需要保证数据库中有可用的模式,否则连接时会报错。

4.2 认证方式

其中 APACHE IMPALA、Hadoop Hive、SPARK  、TRANSWARP INCEPTOR、APACHE Phoenix、HBase 这六个数据库在配置数据连接时有 认证方式这一选项。如下图所示:

1572943457803131.png

具体介绍如下所示:

  • 若数据库支持多种认证方式,则点击会出现认证方式下拉框。

  • 若选择「Kerberos」认证,则填入注册过 kdc 的客户端名称和 keytab 密钥路径。

  • 详细 Kerberos 认证请参考 [平台]数据连接 Kerberos 认证

4.3 高级设置

高级设置界面如下图所示:

1602656589146686.png

各参数介绍请参见:连接池属性 文档中的 2.2 节内容。

5. 管理数据连接编辑

5.1 管理范围

在数据决策系统中,点击「管理系统>数据连接>数据连接管理」,点击某一数据库右侧图标,如下图所示:

注:未适配的数据库类型右侧不显示1572937479544823.png图标。

1572937033960925.png

点击某一数据连接右侧图标后,出现的按钮介绍如下表所示:

按钮名称说明
测试连接测试数据库配置是否成功
编辑

点击「编辑」按钮后,可修改数据连接的各配置项

重命名重命名该数据连接
复制复制该数据库,且数据连接名自动加 1
删除删除该数据库
类型、创建者
显示数据库类型和创建者

平台未适配的数据连接,例如未适配的第三方数据源插件,平台中只能读取到数据源的名字,无法新建、编辑及查看具体的设置,只能在设计器中进行新建、编辑和查看。提示「该类型暂仅支持在设计器中使用旧版本数据连接查看」,如下图所示:

5.2 连接池状态

注:只有 JDBC 类型的数据库有连接池。

数据连接界面提供连接池状态页面,可看到目前已创建的数据连接及对应的连接状态,如下图所示:

17.png

「活动连接数」和「空闲连接数」的说明如下表所示:

连接池状态说明
活动连接数

连接池最大可创建的连接数,若最大连接数是 10 ,程序已申请 10 个连接,而且一直在使用,第 11 个连接申请时报错:active 10 maxActive 10

空闲连接数

当前处于空闲状态的连接, 随时会转成活动连接, 空闲状态超过最大空闲连接时间时自动释放

活动连接数+空闲连接数=实际物理连接数