数据库连接故障排除
如果您无法连接到数据库,您需要确定问题是否发生在Metabase或您的数据库服务器。
如果您的数据库连接成功,但表格未在数据浏览器中显示,请转到解决找不到表格的问题。
Metabase连接故障排除
-
转到 管理 > 数据库 并选择您的数据库以确认您的连接没有被更改或删除。
-
如果Metabase尚未开始与您的数据库同步,请点击 立即同步数据库架构。
-
如果Metabase同步耗时过长,请访问 同步和扫描故障排除。
-
-
转到 管理 > 故障排除 > 日志 检查Metabase是否因为错误而未能同步 (常见数据库连接错误)。
- 如果日志看起来很复杂,请查看 如何阅读服务器日志。
如果您无法访问Metabase管理面板,您需要联系设置Metabase的人。
数据库服务器连接故障排除
-
检查您是否可以使用运行Metabase的机器从另一个客户端连接到数据仓库。
-
如果您可以从堡垒主机或另一台机器访问服务器,请 检查您的Metabase IP地址是否有权访问您的数据库服务器。
-
如果您正在运行Metabase Cloud,请确保您已经 将我们的IP地址列入白名单。
-
-
确保Metabase使用具有连接到您的数据仓库所需权限的角色。请参阅 授予数据库权限。
上述步骤将帮助您检测问题是否出现在Metabase之外。要 修复 数据库服务器上的问题,您需要参考您数据库或云服务的文档。记得在您做出更改后 测试您的数据库连接。
如果您无法访问数据仓库服务器,您需要联系管理您数据库或数据仓库的人。
BigQuery和Google Drive连接故障排除
请参阅 BigQuery和Google Drive连接故障排除
常见数据库连接错误
查询耗时过长
如果您在Metabase界面中看到此错误消息,请转到 超时故障排除。
无法从底层数据库获取连接
如果您在 日志(管理 > 故障排除 > 日志)中看到此错误消息
- 转到 管理 > 数据库 并选择您的数据库。
- 转到 高级选项 > 其他JDBC连接字符串选项 并添加
trustServerCertificate=true
。 - 点击 保存。
您用于连接数据仓库的Metabase版本必须支持您的数据库版本。例如,Metabase版本低于46不支持Microsoft SQL Server 2022。
测试数据库连接
在您按照本指南中的故障排除步骤操作时,您可以检查每个组件是否按预期工作
检查服务器状态
如果您使用的是托管数据库服务,请转到控制台并验证其状态。
如果您有直接访问命令行界面,请登录并确保您的数据库正在运行并接受查询。
检查您的服务器访问
为了验证您的Metabase IP地址可以访问数据库服务器
-
使用 netcat 命令
nc
(或您操作系统的等效命令)来检查您是否可以连接到指定端口上的主机。请注意,不同的数据库默认使用不同的端口。 -
如果您正在运行Metabase Cloud,请确保您已经 将我们的IP地址列入白名单。
-
检查您的数据库凭据是否正确。
示例命令
验证默认 PostgreSQL 配置中使用的端口(默认情况下侦听端口 5432)
nc -v your-db-host 5432
验证您对 PostgreSQL 数据库的凭据(如果数据库名称或用户/密码不正确,您将看到错误信息)
psql -h HOSTNAME -p PORT -d DATABASENAME -U DATABASEUSER
测试连接状态
- 前往 Metabase SQL 编辑器。
- 通过运行以下命令测试与数据库的连接
SELECT 1
相关问题
您还卡住吗?
如果使用故障排除指南无法解决问题
- 搜索或咨询 Metabase 社区。
- 搜索已知的错误或限制 。
- 雇佣一位 Metabase 专家。
阅读其他 Metabase 版本的文档。