数据库连接故障排除

如果您无法连接到数据库,您需要确定问题是否发生在Metabase或您的数据库服务器。

如果您的数据库连接成功,但表格未在数据浏览器中显示,请转到解决找不到表格的问题

Metabase连接故障排除

  1. 转到 管理 > 数据库 并选择您的数据库以确认您的连接没有被更改或删除。

    • 如果Metabase尚未开始与您的数据库同步,请点击 立即同步数据库架构

    • 如果Metabase同步耗时过长,请访问 同步和扫描故障排除

  2. 转到 管理 > 故障排除 > 日志 检查Metabase是否因为错误而未能同步 (常见数据库连接错误)

如果您无法访问Metabase管理面板,您需要联系设置Metabase的人。

数据库服务器连接故障排除

  1. 检查数据仓库服务器是否正在运行.

  2. 检查您是否可以使用运行Metabase的机器从另一个客户端连接到数据仓库。

  3. 确保Metabase使用具有连接到您的数据仓库所需权限的角色。请参阅 授予数据库权限

上述步骤将帮助您检测问题是否出现在Metabase之外。要 修复 数据库服务器上的问题,您需要参考您数据库或云服务的文档。记得在您做出更改后 测试您的数据库连接

如果您无法访问数据仓库服务器,您需要联系管理您数据库或数据仓库的人。

BigQuery和Google Drive连接故障排除

请参阅 BigQuery和Google Drive连接故障排除

常见数据库连接错误

查询耗时过长

如果您在Metabase界面中看到此错误消息,请转到 超时故障排除

无法从底层数据库获取连接

如果您在 日志管理 > 故障排除 > 日志)中看到此错误消息

  1. 转到 管理 > 数据库 并选择您的数据库。
  2. 转到 高级选项 > 其他JDBC连接字符串选项 并添加 trustServerCertificate=true
  3. 点击 保存

您用于连接数据仓库的Metabase版本必须支持您的数据库版本。例如,Metabase版本低于46不支持Microsoft SQL Server 2022。

测试数据库连接

在您按照本指南中的故障排除步骤操作时,您可以检查每个组件是否按预期工作

检查服务器状态

如果您使用的是托管数据库服务,请转到控制台并验证其状态。

如果您有直接访问命令行界面,请登录并确保您的数据库正在运行并接受查询。

检查您的服务器访问

为了验证您的Metabase IP地址可以访问数据库服务器

  1. 使用 netcat 命令 nc(或您操作系统的等效命令)来检查您是否可以连接到指定端口上的主机。请注意,不同的数据库默认使用不同的端口。

  2. 如果您正在运行Metabase Cloud,请确保您已经 将我们的IP地址列入白名单

  3. 检查您的数据库凭据是否正确。

示例命令

验证默认 PostgreSQL 配置中使用的端口(默认情况下侦听端口 5432)

nc -v your-db-host 5432

验证您对 PostgreSQL 数据库的凭据(如果数据库名称或用户/密码不正确,您将看到错误信息)

psql -h HOSTNAME -p PORT -d DATABASENAME -U DATABASEUSER

测试连接状态

  1. 前往 Metabase SQL 编辑器
  2. 通过运行以下命令测试与数据库的连接
    SELECT 1
    

您还卡住吗?

如果使用故障排除指南无法解决问题

阅读其他 Metabase 版本的文档

想要改进这些文档? 提出更改。