导航
元信息诊断
最近更新时间：2025.10.29 10:28:56首次发布时间：2025.10.29 10:28:56
文档反馈
问问助手元信息诊断用于检测当前集群中表元数据的一致性，并每周更新一次诊断结果，您可根据 ByteHouse 提供的元数据问题的解决方案进行修复，以提高集群的可用性和稳定性。该功能适用于排查表不可用原因、修复元数据异常、定期检查实例健康等场景。本文介绍了元信息诊断支持诊断的问题、影响、修复方案，以及如何使用元信息诊断。
功能概述
ByteHouse 当前支持诊断的元数据问题如下，支持筛选指定集群、数据表的元问题。
问题 | 影响 | 修复方案 | 注意事项 |
|---|---|---|---|
本地表与分布式表结构不一致 | 若不修复，可能会影响数据的正常查询。 | 需要重新建表。 | 建议在业务低峰期执行。 |
分布式表未设置 Shard key | 若不修复，影响写入和查询性能。 | 需要重新建表。 | 建议在业务低峰期执行。 |
UNIQUE KEY 包含很多字段，未使用 Hash 函数 | 若不修复，影响写入和查询性能。 | 需要重新建表。 | 建议在业务低峰期执行。 |
表设置的 Index 数量与元数据不一致 | 若不修复，查询时会报错。 | 需要重新建表。 | 建议在业务低峰期执行。 |
表设置的 Index 属性与元数据不一致 | 若不修复，查询时会报错。 | 需要重新建表。 | 建议在业务低峰期执行。 |
表的字段数量与元数据不一致 | 若不修复，查询时会报错。 | 需要重新建表。 | 建议在业务低峰期执行。 |
表名与元数据不一致 | 若不修复，查询时会报错。 | 需要重新建表。 | 建议在业务低峰期执行。 |
表字段的 Nullable 属性与元数据不一致 | 若不修复，查询时会报错。 | 需要重新建表。 | 建议在业务低峰期执行。 |
使用元信息诊断
- 登录 ByteHouse 企业版控制台，单击顶部诊断优化页签，单击元信息诊断，进入功能页面。
- 从下拉列表中选择集群，单击诊断，系统将自动分析并展示当前集群中所有表的元信息诊断情况。
各类诊断项可用于协助诊断集群中表元信息是否存在异常，并提供了该异常的影响程度、修复方案及修复注意事项。
如需查看某张表的诊断信息，您可输入表名，单击诊断。