定义数据连接是将数据库与设计器进行绑定，通过数据连接，报表就可以从数据库中读取、写入数据和修改数据等。
1. 数据支持类型
FineReport连接数据源的方式多种多样，支持通过JDBC的方式直接连接数据库，或者通过JNDI的方式与应用服务器共享数据连接。也指出通过JCO连接SAP系统。
FR在设计器和平台中都可以新建数据连接，但是平台仅支持使用JDBC的数据连接的管理。
1.1 JDBC类
|
|
|
|
|
| 数据源 | 版本 | 驱动 | 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； | 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； | com.microsoft.sqlserver.jdbc.SQLServerDriver | jdbc:sqlserver://localhost:1433;databaseName= |
| MySQL | MySQL_5.1； MySQL_5.6.28; MySQL_5.6.29; MySQL_5.6.31；MySQL_5.6.34; MySQL_5.6.35； MySQL_6.5 | 【驱动1】com.mysql.jdbc.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； | 【对应驱动1】jdbc:postgresql://hostname:port/dbname |
| 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 |
| Gbase 8S | 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； | com.cloudera.impala.jdbc41.Driver | jdbc:impala://hostname:port/_impala_builtins |
| Hadoop Hive | hive_1.1； Hadoop_Hive_1.2；hive2.3； | org.apache.hive.jdbc.HiveDriver | jdbc:hive2://hostname:port/databasename |
| SPARK | 1.6； | org.apache.hive.jdbc.HiveDriver | jdbc:hive2://hostname:port/databasename |
| TRANSWARP INCEPTOR（星环） | 星环_4.6.4； | 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 | 【驱动1】jdbc:redshift://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 |
|
1.2 多维数据库类
| Microsoft Analysis Services（ssas） |
| SAP HANA |
| Oracle Essbase |
| Tomcat配置JNDI连接 |
| Websphere配置JNDI连接——待完善 |
| Weblogic配置JNDI连接 |
| Jboss配置JNDI连接——待完善 |
1.3 JNDI
|
|
| Tomcat配置JNDI连接 |
| Websphere配置JNDI连接——待完善 |
| Weblogic配置JNDI连接 |
| Jboss配置JNDI连接——待完善 |
1.4 其他
| [设计器]SAPBW数据连接 |
| [设计器]MongoDB数据库连接 |
| JSON数据集 |
2 连接池
2.1 连接池原理
连接池主要由三部分组成：连接池的建立、连接池中连接使用的治理、连接池的关闭。
连接池技术的核心思想，是连接复用，通过建立一个数据库连接池以及一套连接使用、分配、治理策略，使得该连接池中的连接可以得到高效、安全的复用，避免了数据库连接频繁建立、关闭的开销。另外，由于对JDBC中的原始连接进行了封装，从而方便了数据库应用对于连接的使用（特别是对于事务处理），提高了开发效率，也正是因为这个封装层的存在，隔离了应用的本身的处理逻辑和具体数据库访问逻辑，使应用本身的复用成为可能。
2.2 连接池属性
FR 连接池属性，使用的是 DBCP 连接池，下面介绍其设置方法及其属性中各参数的意义；如果访问模板时，报连接超时、等待状态，警告如下：
则
则需要把相应连接数调大。
设置方法：
点击 服务器>定义数据连接，如下图所示，点击连接池属性，弹出连接池属性编辑框，调整最大活动连接数：
参数说明：
| 名称 | 举例 | 含义 |
|---|---|---|
| 初始化连接数 | initialSize="1" | 初始化线程数，开始自动建立一个与数据库的连接 |
| 最大活动连接数 | maxActive="200" | 可以从对象池中取出的对象最大个数，为0表示没有限制 |
| 最大空闲连接数 | maxIdle="100" | 最大等待连接中的数量，设为负数则没有限制（对象池中对象最大个数） |
| 最小空闲连接数 | minIdle="2" | 对象池中对象最小个数 |
| 最大等待时间（毫秒） | maxWait="1000" | 最大等待时间，单位为 ms，超出时间会丢出错误信息 |
| SQL 验证查询 | validationQuery="SQL语句" | 验证连接是否成功，SQL 和 SELECT 指令至少要返回一行 |
| 获取连接前检验 | testOnBorrow="false" | 取得对象时是否进行验证，检查对象是否有效，默认为 false |
| 归还连接前检验 | testOnReturn="true" | 返回对象时是否进行验证，检查对象是否有效，默认为 false |
| 开启空闲回收器检验 | testWhileIdle="true" | 空闲时是否进行验证，检查对象是否有效，默认为 false |
| 空闲连接回收器休眠时间（毫秒） | timeBetweenEvictionRunsMillis="1000" | 失效检查线程运行时间间隔，如果小于等于 0，不会启动检查线程 |
| 空闲连接回收检查数 | numTestsPerEvictionRun="2" | 失效检查线程运行次数 |
| 保持空闲最小时间 | minEvictableIdleTimeMillis="18005000" | 大于 0，进行连接空闲时间判断，或为 0，对空闲的连接不进行验证 |
连接池满问题
若日志报ORA-12519 TNS:no appropriate service handler found，是数据库连接失败的错误，12519错误是监听不能提供服务。
原因：
原因是我们定义数据连接后，点击连接时，此时会用掉一个连接池中的一个连接。
而在定义数据集后，点击预览按钮，此时连接池就会分配连接，可能会使用之前那个连接（之前的连接已释放），或分配一个其他的连接或新建一个连接。
若此时连接池所有连接都已用完，就会报如下错误：
当客户请求数据库连接时，首先是查看连接池中是否有空闲连接（指当前没有分配出去的连接）。
假如存在空闲连接，则把连接分配给用户，并作相应的处理（即标记该连接为正在使用，引用计数加1）。
假如没有空闲连接，则查看当前所开的连接数是不是已经达到maxConn（最大连接数），若没达到就重新创建一个连接给请求的客户；
若达到就按设定的maxWaitTime（最大等待时间）进行等待；
若等待maxWaitTime后，仍没有空闲连接，就抛出无空闲连接的异常给用户。
解决方案：
若您在FR连接池属性的设置中，已将最大连接数设置得过大，还出现如上的报错，此时通常就是数据库进程（processes）达到上限导致的，可增大数据库中的连接数目来解决此问题。如下在数据库中修改最大连接数：
查看当前的连接数
<span style="color:#334356"><span style="color:#1bc1a1"><img data-cke-saved-src="http://help.finereport.com/js/clipboard/clippy.png" src="http://help.finereport.com/js/clipboard/clippy.png" alt="Copy to clipboard" class="clippy" /><code>select count(*) from V$process;</code></span></span> 查看数据库允许的最大连接数
<span style="color:#334356"><span style="color:#1bc1a1"><img data-cke-saved-src="http://help.finereport.com/js/clipboard/clippy.png" src="http://help.finereport.com/js/clipboard/clippy.png" alt="Copy to clipboard" class="clippy" /><code>select value from V$parameter where name=<span style="color:#dd1144">'processes'</span>;</code></span></span> 修改最大连接数为1000
<span style="color:#334356"><span style="color:#1bc1a1"><img data-cke-saved-src="http://help.finereport.com/js/clipboard/clippy.png" src="http://help.finereport.com/js/clipboard/clippy.png" alt="Copy to clipboard" class="clippy" /><code>alter system set processes=<span style="color:teal">1000</span> scope=spfile</code></span></span> 重启数据库，再查询最大连接数，数字改变就表示已修改成功。
说明：当客户释放数据库连接时，先判定该连接的引用次数是否已超过规定值，假如超过就删除该连接，并判定当前连接池内总的连接数是否小于minConn（最小连接数），若小于就将连接池布满；假如没超过就将该连接标记为开放状态，可供再次复用。可看出正是这套策略保证了数据库连接的有效复用，避免频繁地建立、释放连接所带来的系统资源开销。