价格
登录 开始使用
文档 学习
首页
分析
嵌入
管理
其他资源

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

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

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

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

  • 同步，如果您的表或列丢失，或者您的列数据类型错误。
  • 扫描，如果您的列值丢失或错误（例如，在您的筛选器下拉菜单中）。
  • 指纹识别，如果您已触发手动扫描，但更改未生效。

同步

  1. 确保您的数据库驱动程序是最新的。
  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 的文档。