故障排除同步、扫描和指纹识别

首先,检查您的数据是否因浏览器缓存而过时

  1. 清除浏览器缓存。
  2. 刷新您的 Metabase 页面。
  3. 在无痕窗口中打开您的 Metabase 页面。

一旦您确认正在查看表的非缓存视图和列,请联系您的数据库管理员以帮助排除故障

  • 如果您的表或列缺失,或列数据类型错误,请进行同步
  • 如果您的列缺失或错误(例如,在您的筛选下拉菜单中),请进行扫描
  • 如果您已触发手动扫描,但更改未生效,请进行指纹识别

同步

  1. 如果您是自行托管 Metabase,请确保您的 Metabase 实例和任何社区数据库驱动程序都是最新的。
  2. 转到管理 > 工具 > 日志以检查同步状态。
  3. 从 Metabase SQL 编辑器对您的数据库运行查询,以检查日志中未列出的数据库连接或数据库权限错误

    SELECT
       *
    FROM
        "your_schema"."your_table_or_view"
    LIMIT 1
    
  4. 如有需要,手动重新同步表或视图。

特殊情况

如果您刚刚在 Metabase 中设置了一个新数据库,初始同步查询需要一些时间才能启动。如果同步完全没有启动,请尝试故障排除数据库连接

解释

同步查询应该在您的数据库查询执行表中显示如下(使用数据库连接详细信息中数据库用户的权限

SELECT
    TRUE
FROM
    "your_schema"."your_table_or_view"
WHERE
    1 <> 1
LIMIT 0

要运行同步查询,Metabase 必须

如果连接失败或数据库权限错误,同步查询将无法运行。如果 Metabase 在您首次设置后无法与您的数据库同步,那么初始扫描和指纹识别查询也将无法运行。

展开包含对象记录的 JSON 列

  1. 转到管理 > 数据库 > 您的数据库 > 显示高级选项
  2. 点击禁用“JSON 展开”
  3. 点击保存更改
  4. 点击同步数据库架构

解释

Metabase 将在同步过程中尝试展开 JSON 和 JSONB 记录,这会占用相当一部分查询执行时间。如果您有大量 JSON 记录,请尝试禁用自动展开选项,以使同步脱离慢动作。请记住,您可以从管理 > 工具 > 日志中查看同步状态。

扫描

  1. 转到管理 > 表元数据
  2. 选择数据库和表。
  3. 转到您要更新的列,然后点击齿轮图标。
  4. 点击丢弃缓存的字段值
  5. 点击重新扫描此字段
  6. 转到管理 > 工具 > 日志,从那里跟踪扫描状态并调试错误。

特殊情况

如果您正在等待连接数据库后的初始扫描运行,请确保初始同步已首先完成(请记住,您可以从管理 > 工具 > 日志中检查状态)。

解释

扫描查询针对您的数据库运行,以从表或视图的前 1,000 行中采样列值

SELECT
    "your_table_or_view"."column" AS "column"
FROM
    "your_schema"."your_table_or_view"
GROUP BY
    "your_table_or_view"."column"
ORDER BY
    "your_table_or_view"."column" ASC
LIMIT 1000

扫描失败是由扫描查询失败引起的——您可以查看日志来调试查询,类似于您直接对数据库运行的其他查询。

请注意,当您从“表元数据”中将搜索框筛选器更改为下拉筛选器时,您将为该字段触发一个扫描查询。如果您的下拉筛选器未拾取字段中的所有值,请记住 Metabase 每个字段仅采样前 1,000 个唯一值,并最多存储 100 千字节的文本。如果您的列中有超过 1,000 个唯一值,或者大量文本数据(如长 URL 或调查回复),您可以

  • 使用该字段的搜索框筛选器。
  • 在您的ETL 或 ELT 过程中进一步清理数据。

指纹识别

要手动重新触发给定列的指纹识别查询,请执行以下操作:

  1. 转到管理 > 数据库 > 您的数据库 > 显示高级选项
  2. 打开定期重新识别表指纹并点击保存更改
  3. 转到管理 > 表元数据
  4. 选择您的数据库和表。
  5. 将表的可见性更改为“隐藏”。
  6. 将可见性改回“可查询”。
  7. 等待 10 秒。
  8. 转到您的列,将类型从“实体键”更改为“无语义类型”,然后再改回“实体键”。

特殊情况

如果您正在等待连接数据库后的初始指纹识别查询运行,请确保初始同步已首先完成(请记住,您可以从管理 > 工具 > 日志中检查状态)。

如果您正在使用 MongoDB,Metabase 会对每个集合的前 10,000 个文档进行指纹识别。如果您没有看到所有字段,那是因为这些字段可能不存在于前 10,000 个文档中。有关更多信息,请参阅我们的MongoDB 参考文档

解释

初始指纹识别查询查看数据库中给定表或视图的前 10,000 行

SELECT
    *
FROM
    "your_schema"."your_table_or_view"
LIMIT 10000

如果前 10,000 行不能代表表中的数据(例如,如果您的数据稀疏,有很多空白或空值),您可能会看到以下问题:

  • 筛选器类型不正确,例如,当您想要日历时却是类别。
  • 直方图可视化无法工作(因为 Metabase 需要最小值和最大值来生成分箱)。

Metabase 没有内置选项来触发手动指纹识别查询。您可以使用上述步骤“重置”字段的设置,尝试强制进行指纹识别查询,但这并不能保证在所有 Metabase 版本上都有效。

同步或扫描耗时过长

要加快同步速度

要加快扫描速度

解释

同步和扫描最终只是对您的数据库运行的两种查询,因此执行速度受到运行查询数量、执行频率、数据大小以及分配给数据库的资源量的限制。Metabase 为您提供了调整同步和扫描查询数量和频率的选项,因为不幸的是,我们无法赋予您的数据库更多能力……(目前还不能?)

您还卡住了吗?

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

阅读其他版本的 Metabase 的文档。

这有帮助吗?

感谢您的反馈!
想改进这些文档吗?提出更改建议。
© . This site is unofficial and not affiliated with Metabase, Inc.