1. 描述编辑
通过选项,可以不需要设计器,直接新建数据连接,还可以查看当前报表连接了哪些数据库,并且进行修改。
设计器可以创建 JNDI 数据连接,可以创建 多维数据连接,平台创建的数据连接在设计器里也可以进行管理详细点击 [设计器] JDBC 连接数据库。
2. 数据连接管理编辑
管理员登录数据决策系统,点击管理系统>数据连接>数据连接管理,如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接控制。
2.1 类型选择
单击新建数据连接按钮,有三种类型选择,分别为常用,所有,其他。如下图所示:
2.1.1 常用
固定显示几个常用的数据库类型,分别为 Hsql、IBM DB2、Microsoft SQL Server、MySQL、Oracle。如下图所示:
2.2.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,如下图所示:
注1:「内置支持」和「插件支持」默认两个都勾选。
注2:左侧切换数据库类型后,「内置支持」和「插件支持」恢复默认状态。
注3:可通过「内置支持」和「插件支持」的勾选,对数据库类型进行筛选;若都不勾选,则显示空白。
2.2.3 其他
「其他」类型中包括JNDI数据连接,其他JDBC。如下图所示:
2.2 新建数据连接
新建数据连接如下图所示:
注1:通过设计器定义的数据连接,相应平台中都能读取并控制。
注2:若数据连接中包括插件扩展,平台和设计器中也都能定义。
在新建数据连接时,不同数据库需配置的信息可能有所不同,下面介绍「模式」和「认证方式」这两个属性的具体信息。
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 这些数据库时,会比其他数据连接多了一步:模式。
注1:如果这些数据库未进行模式选择,则默认选择的是第一个模式。
注2:当数据库不存在模式选择,则无需进行模式选择。
注3:模式默认不可编辑,点击连接数据库且连接成功后可编辑。
2)认证方式
其中 APACHE IMPALA、Hadoop Hive、SPARK 、TRANSWARP INCEPTOR、APACHE Phoenix、Hbase 这六个数据库在配置数据连接时有 认证方式这一选项。如下图所示:
注1:若数据库支持多种认证方式,则点击会出现认证方式下拉框。
注2:若选择「Kerberos」认证,则填入注册过 kdc 的客户端名称和 keytab 密钥路径。
注3:详细 Kerberos 认证请参考[平台]数据连接 Kerberos 认证 。
2.2.1 JDBC 数据连接
以 Oracle 数据库为例进行说明。
点击新建数据连接按钮,在「常用」类型中选择 Oracle 数据库。如下图所示:
1)数据连接名称:不可为空,不可重名。
2)数据连接URL:自动拼接,可手动编辑。
3)高级设置:默认收起,可点击展开。
2.2.2 JNDI 数据连接
点击新建数据连接按钮,在「其他」类型中选择「JNDI数据连接 」,如下图所示:
注:JNDI 数据连接请参考 JNDI数据连接 。
2.2.3 其他 JDBC
如果数据库列表中没有所需的数据库类型,则选择「其他JDBC 」。
将对应驱动包放置在%FR_HOME%\webapps\webroot\WEB-INF\lib下面并重启报表服务器。
点击新建数据连接按钮,在「其他」类型中选择「其他JDBC」,手动输入驱动器名称、URL 等完整数据连接信息,点击测试连接连接成功后,点击保存即可。如下图所示:
1)数据连接信息:数据连接名称、驱动器、URL、编码(推荐直接选自动即可,2018-12-27 及以后的 JAR 开始支持)、用户名、密码。
2)测试连接:测试数据库配置是否成功,若成功则弹出「连接成功」,若失败则显示失败详细原因。
2.3 管理数据连接
在数据决策系统中,点击管理系统>数据连接>数据连接管理,点击某一数据库右侧图标,如下图所示:
1)测试连接:测试数据库配置是否成功。
2)编辑:修改各配置项。
单击已有的数据连接,打开数据连接配置信息,可直接在文本框中进行编辑
3)重命名:重命名该数据库。
4)复制:复制该条数据库,且数据连接名自动加 1。
5)删除:删除该数据库。
6)数据连接信息:显示数据库类型和创建者
注:未适配的数据库类型右侧不显示图标。
新建数据连接未适配的第三方数据源插件,新建列表中能显示,但是点击无法新建,只能到设计器中进行查看和编辑,如 JSON数据集 。如下图所示:
3. 数据库列表编辑
下面列出 FR 支持的数据库及对应的连接属性值:
数据源 | 版本 | 驱动 | URL |
---|---|---|---|
Apache Kylin | 1.5、2.2 | org.apache.kylin.jdbc.Driver | jdbc:kylin://<hostname>:<port>/<kylin_project_name> |
HP Vertica | Vertica_7.2.1 | com.vertica.jdbc.Driver | jdbc:vertica://verticaHost:port/databaseName |
IBM DB2 | DB2_7.2; DB2_8.1; DB2_8.2; DB2 V9.7; DB2_10.5 | com.ibm.db2.jcc.DB2Driver | jdbc:db2://hostname:port/dbname |
INFORMIX | 11.7;11.5 | com.informix.jdbc.IfxDriver | jdbc:informix-sqli://{host}:{port}/{database}:INFORMIXSERVER={server} |
Microsoft SQL Server | SQL server 2000; SQL server 2005; SQL server 2008; SQL server 2012; SQL server 2014; SQL server 2016 | com.microsoft.sqlserver.jdbc.SQLServerDriver | jdbc:sqlserver://localhost:1433;databaseName= |
MySQL | MySQL_5.1; MySQL_5.5; MySQL_5.5.46; MySQL_5.5.5; MySQL_5.6.22; MySQL_5.6.28; MySQL_5.6.29; MySQL_5.6.31;MySQL_5.6.34; MySQL_5.6.35;MySQL_5.6.37; MySQL_5.7; MySQL_5.7.16; MySQL_6.5 | 【驱动1】com.mysql.jdbc.Driver; 【驱动2】org.gjt.mm.mysql.Driver | jdbc:mysql://localhost/dbname |
Oracle | oracle 9i; oracle_9.2; oracle10.2.0; oracle 11g; oracle_11g2; oracle_11.2.0.3; oracle_11.2.0.4; oracle_11.2.3; oracle 12c; oracle 10g AIX版本 | oracle.jdbc.driver.OracleDriver | jdbc:oracle:thin:@localhost:1521:databaseName |
Pivotal Greenplum Database | 【驱动1】org.postgresql.Driver; 【驱动2】com.pivotal.jdbc.GreenplumDriver | 【对应驱动1】jdbc:postgresql://hostname:port/dbname 【对应驱动2】jdbc:pivotal:greenplum://hostname:port;DatabaseName=" | |
PostgreSQL | postgresql_9.4.7;9.5.0; | org.postgresql.Driver | jdbc:postgresql://hostname:port/dbname |
Derby | org.apache.derby.jdbc.ClientDriver | jdbc:derby://localhost:1527/ | |
Kingbase | com.kingbase.Driver | jdbc:kingbase://hostname:port | |
GBase 8A | Gbase 8A(基于mysql) | com.gbase.jdbc.Driver | jdbc:gbase://hostname:port/dbname |
GBase8S | Gbase 8S(基于infomix) | com.gbasedbt.jdbc.IfxDriver | jdbc:informix-sqli://{host}:{port}/{database}:INFORMIXSERVER={server} |
GBase 8T | Gbase 8T(基于informix) | com.informix.jdbc.IfxDriver | jdbc:informix-sqli://{host}:{port}/{database}:INFORMIXSERVER={server} |
Presto | Presto_0.152;0.169 | com.facebook.presto.jdbc.PrestoDriver | jdbc:presto://host:port/catalog |
SAP HANA | com.sap.db.jdbc.Driver | jdbc:sap://hostname:port?reconnect=true | |
SAP Sybase | SAP Sybase ASE_12.5;SAP Sybase IQ | com.sybase.jdbc4.jdbc.SybDriver | jdbc:sybase:Tds:hostname:2638/databasename |
TeraData | Teradata_v12; TeraData_15.00.06.04 | com.ncr.teradata.TeraDriver | jdbc:teradata://localhost/CLIENT_CHARSET=EUC_CN,TMODE=TERA,CHARSET=ASCII,LOB_SUPPORT |
APACHE IMPALA | impala 2.2; impala 2.3; impala 2.8; impala 2.9; impala 2.10; impala 2.10 kudu1.5; | com.cloudera.impala.jdbc41.Driver | jdbc:impala://hostname:port/_impala_builtins |
Hadoop Hive | hive_1.1; Hadoop_Hive_1.2;hive2.3; hive2.1.2;hive2.1.1; | org.apache.hive.jdbc.HiveDriver | jdbc:hive2://hostname:port/databasename |
Spark | 1.6; 2.1;2.2;2.3; | org.apache.hive.jdbc.HiveDriver | jdbc:hive2://hostname:port/databasename |
Transwarp Inceptor(星环) | 星环_4.6.4; 星环_4.7.1; 星环_4.5.1; 星环_5.1; 星环_5.2.1; | org.apache.hive.jdbc.HiveDriver | jdbc:hive2://hostname:port/databasename |
APACHE Phoenix | org.apache.phoenix.jdbc.PhoenixDriver | jdbc:phoenix:hostname:port/dbname | |
ADS | com.mysql.jdbc.Driver | jdbc:mysql://hostname:port/my_ads_db | |
Amazon Redshift | 【驱动1】com.amazon.redshift.jdbc4.Driver 【驱动2】com.amazon.redshift.jdbc41.Driver | 【驱动1】jdbc:redshift://endpoint:port/database 【驱动2】jdbc:postgresql://endpoint:port/database | |
H2 | org.h2.Driver | jdbc:h2://${ENV_HOME}/../databaseName | |
HSQL | com.fr.third.org.hsqldb.jdbcDriver | jdbc:hsqldb:file:[PATH_TO_DB_FILES] | |
Sqlite | org.sqlite.JDBC | jdbc:sqlite:[PATH_TO_DB_FILES] | |
GaussDB 200 | org.postgresql.Driver | jdbc:postgresql://hostname:port/dbname | |
FusionInsight elk | org.postgresql.Driver | jdbc:postgresql://hostname:port/dbname | |
FusionInsight HD | org.apache.hive.jdbc.HiveDriver | jdbc:hive2://10.135.0.110:24002,10.135.0.67:24002,10.135.0.66:24002/;serviceDiscoveryMode=zooKeeper;zooKeeperNamespace=hiveserver2;sasl.qop=auth-conf;auth=KERBEROS;zk.principal=zookeeper/hadoop;principal=hive/hadoop.hadoop.com@HADOOP.COM; | |
华为云DWS | org.postgresql.Driver | jdbc:postgresql://hostname:port/dbname | |
HBase | org.apache.phoenix.jdbc.PhoenixDriver | jdbc:phoenix:hostname:port/dbname | |
cache | com.intersys.jdbc.CacheDriver | jdbc:Cache://ip:port/database |