1. 概述
1.1 版本
报表服务器版本 | JAR 包日期 | 功能变动 |
---|---|---|
10.0.15 | 2021-04-09 | 更新了内置的 sqljdbc.jar 驱动包 注:升级无法更新内置驱动 |
1.2 应用场景
本文将介绍如何连接 Microsoft SQL Server 数据库。
2. 准备工作
2.1 版本和驱动
下载驱动包,并将其上传至 FineReport。如何上传详情请参见:驱动管理 2.1 节
支持数据库版本 | 驱动包下载 |
---|---|
SQL Server 2005 SQL Server 2008 SQL Server 2012 SQL Server 2014 SQL Server 2016 SQL Server 2017 SQL Server 2019 | 可以直接使用内置驱动 更建议依据用户自己的数据库版本,前往官网选择合适的驱动:sql server支持矩阵 |
SQL Server 2000 | jtds驱动,操作方式可参见:jtds驱动连接方式 |
注意:如果您在使用 2005-2014 版本的SQL Server时,通过内置驱动连接数据库后收到错误提示“驱动程序无法通过使用安全套接字层(SSL)加密与 SQL Server 建立安全连接”,那么您可以尝试以下步骤来解决这个问题:
停止使用当前的内置驱动程序。
下载并安装表格中推荐的「jtds」驱动程序。
使用「jtds」驱动程序重新连接到SQL Server数据库。
2.2 收集连接信息
在连接数据库之前,请收集以下信息:
数据库所在服务器的 IP 地址和端口号;
数据库的名称;
数据库的用户名和密码;
要连接的数据库模式;
3. 具体连接步骤
FineReport 提供了两种数据连接方式:
方式一:在设计器中进行连接 ,具体方法请参见: [设计器]JDBC连接数据库 。
方式二:在数据决策平台进行连接。本文主要介绍此种方式。
1)以管理员身份登录数据决策系统,点击「管理系统>数据连接>数据连接管理」,点击「新建数据连接」,如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接权限
2)选择「Microsoft SQL Server」,如下图所示:
3)输入 2.2 节的连接信息,驱动由于是内置的,选择「默认即可」。
模式需要连接数据库后才可以选择,所以需要先点击「点击连接数据库」后,再选择「模式」,如下图所示:
注1:用户若是想要连接非默认实例,可以更改「数据连接URL」,有两种方式:
jdbc:sqlserver://ip;instanceName=实例名;databaseName=数据库名
jdbc:sqlserver://ip\实例名;databaseName=数据库名
注2:连接多模式的数据库时使用 SQL 语句需要带上模式名前缀进行搜索,例如 SELECT * FROM [dbo].[asdfg]
4)点击「测试连接」,若连接成功则点击「保存」,如下图所示:
4. 添加数据库的表至 FineReport
详情请参见:数据集
5. 注意事项
数据库常见问题和解决方案请参见:SQL Server数据连接常见问题