数据库连接失败排查步骤

1.1 问题现象

FineBI 产品功能日益增强，适配数据库的种类也越来越多。如何检查这些数据库的连接问题也变的繁琐和头疼，本篇文章为用户介绍三种数据库连接失败时的自检办法。

1.2 原因分析

数据库连接不上可能是连接信息填写错误，也可能是数据库连接环境的问题。本文根据以上原因提供三种排查思路和方式：

• 检查 URL 是否正确。

• 运行测试小工具，检查除 BI 外的连接环境是否有问题，包括数据库和数据库驱动。

• 查看后台报错日志，检查是否是数据库驱动与 BI 之间有 JAR 包冲突。
  

2.1 检查URL是否正确

数据库连接失败有一种可能是连接信息填写错误。参考 数据库连接支持范围 ，找到对应数据库正确的 URL 格式，检查 URL 是否填写正确。如下图所示：

2.2 检查防火墙

检查数据库是否有给 BI 服务器开启白名单。

2.3 数据连接自检工具

该工具可以检测连接环境（数据库和驱动）是否出现了问题。

2.3.1 安装工具

下载附件 测试连接.rar

将附件里的 bootstrap.jar、fine-test.jar拷贝到任意目录下(英文目录，路径中不要有空格等特殊字符)，然后将对应的数据库驱动也拷贝到这个目录下。如下图所示：

2.3.2 启动工具

1）启动 cmd，在此 JAR 包所在目录下执行java -jar bootstrap.jar，并根据提示输入 1，如下图所示：

2）根据提示输入数据库驱动代号、URL、用户名、数据库密码等，如下图所示：

2.3.3 自检排查

若输入要查询的 SQL 语句后，出现「sql查询耗时」，则表明小工具连接成功。若中途出现报错，表明除 BI 外的数据库连接环境有问题，需要检查数据库和数据库驱动。