数据库连接故障排除

如果您无法连接到数据库,您需要找出问题是出在 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 版本的文档。

© . All rights reserved.