1. 概述
SQLite 是一个软件库,实现了自给自足的、无服务器的、零配置的、事务性的 SQL 数据库引擎。
SQLite 是世界上最广泛部署的 SQL 数据库引擎。FineReport 内置的 Demo 数据库即为 SQLite 数据库。
2. 数据连接
2.1 配置信息
驱动 | URL | 驱动下载地址 |
org.sqlite.JDBC | jdbc:sqlite:[PATH_TO_DB_FILES] | 1)FR 内置 sqlite-jdbc.jar 驱动包,无需下载 2)FR 内置 FRDemo.db 数据库文件,无需下载 |
2.2 下载驱动文件
若驱动被误删或失效等情况。可选择替换更新驱动包:sqlite-jdbc.jar
删除%FR_HOME%\webapps\webroot\WEB-INF\lib下的驱动包sqljdbc.jar。并将下载的驱动包拷贝到该路径下。
2.3 选择连接方式
FineReport 提供了两种数据连接方式:
方式一:在设计器中进行连接 ,具体方法请参见: [设计器]JDBC连接数据库 。
方式二:在数据决策平台进行连接。本文主要介绍此种方式。
2.4 新建数据连接
1)管理员登录数据决策系统,选择管理系统>数据连接>数据连接管理,点击新建数据连接,在所有选项下选择 SQLite,点击确定,如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接控制 。
2)按照本文 2.1 章节的配置信息格式,输入对应的数据连接信息。其中高级设置可选填,详情请参见:[平台]数据连接 。输入信息后界面如下图所示:
若数据库的路径为 C:\Users\86150\Downloads\FRDemo.db,则 URL 修改为 jdbc:sqlite:C:\Users\86150\Downloads\FRDemo.db
若数据库在工程中,例如 FR 内置数据库在工程中的位置为%FineReport_10.0%\webapps\webroot\help,则 URL 也可写相对路径:jdbc:sqlite://${ENV_HOME}/../help/FRDemo.db
若数据库与工程不在同一服务器下,需要共享网络路径,并将上面的路径替换。
3)点击测试连接,若弹出「连接成功」提示框,则表示成功连接上数据库,如下图所示:
4)模式选择后点击右上角的保存按钮,该数据连接即添加成功。如下图所示:
注:SQLite 数据库在获取连接时,若 URL 中 PATH 路径下没有数据库时,会自动在此路径下创建数据库,因此会出现实际 PATH 路径下没有 SQLite 数据库也会连接成功的现象。
3. 注意事项
10.0.16 及之后的版本,由于产品内置驱动升级,使用 SQLite 类型的数据库查询数据时,SQL 语句中不再支持使用双引号,对应位置替换为单引号即可。
例如:查询 FRDemo 销量表中华东地区的数据
不支持:SELECT * FROM 订单 WHERE 货主地区 = "华东"
支持:SELECT * FROM 订单 WHERE 货主地区 = '华东'