1. 概述
1.1 版本
| FineBI 版本 | 功能变动 |
|---|---|
| 5.1 | - |
| 5.1.19 | 更改上传数据库驱动包的方式：通过「驱动管理」上传，实现热加载 |
1.2 应用场景
本文将介绍如何连接 Microsoft SQL Server 数据库。
2. 准备工作
2.1 版本和驱动
下载对应的驱动包，如何上传驱动包可参见：驱动管理
| 支持的数据库版本 | 驱动包下载 |
|---|---|
| SQL Server 2000 | sqljdbc.zip |
SQL Server 2005 SQL Server 2008 SQL Server 2012 SQL Server 2014 SQL Server 2016 | 已内置无需下载 |
2.2 收集连接信息
在连接数据库之前，请收集以下信息：
数据库所在服务器的 IP 地址和端口号；
数据库的名称；
数据库的用户名和密码；
要连接的数据库模式；
3. 具体连接步骤
1）以管理员身份登录 FineBI ，点击「管理系统>数据连接管理」，点击「新建数据连接」，如下图所示：
注：如果非管理员用户想要配置数据连接，需要管理员给其分配管理系统下数据连接节点的权限，具体操作请查看 数据连接权限
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. 添加数据库的表至FineBI
5. 注意事项
5.1 常见问题
若数据库查询速度慢可参考文档：SQL Server查询速度较慢
数据库报错可参考文档：SQL Server 数据连接常见错误解决方案
对于特殊场景的参考文档：SQLSERVER多实例名情况建立数据链接
5.2 decimal 数据类型注意点
若在数据库中，字段类型为的 decimal，保留一位小数且小数为 0 时，在 FineBI 中预览时会直接显示成整数。
