Skip to main content
私有化部署商业版及以上适用
路径：管理面板 → Schema 完整性 Teable 记录的字段定义和数据库里的实际结构应当一一对应。两者出现偏差时，用户侧会表现为字段打不开、关联字段取不到值，或某张表的读写持续报错，而表面上看不出原因。Schema 完整性 用于定位这类问题并修复。 实例管理员可以检查实例内的任意 Base，不需要先加入对应空间，使用客户自管数据库（BYODB）的租户同样可以检查。

​
运行检查

在搜索框中按 Base、空间、表 ID 或名称找到目标 Base。结果列表会显示它所属的 空间、使用的 数据源（默认或 BYODB）和 运行时（v1 或 v2），据此确认找对了 Base。同名 Base 在不同空间中很常见。 点击该行的 检查，在 Schema 完整性检查 弹窗中点击 开始检查。

​
读懂检查结果

结果按字段和规则逐条列出，分四种状态： 先看 错误：用户报告的故障基本都落在这一类。警告 不解释当前的故障，但会随着字段结构继续变化演变成错误，适合在排查完错误后一并处理。

​
修复

可以按规则逐条 修复，也可以用 仅修复警告 或 修复警告和错误 批量处理。排查线上故障时建议先逐条修复错误，确认故障消失后再处理警告，这样出问题时能定位到是哪一条改动引起的。 修复只改动表结构，不改动记录内容。执行前点击修复按钮旁的预览，可以在 确认修复内容 中看到 dry-run 返回的修复原理和将要执行的 SQL，确认后才会真正执行。 部分规则无法自动修复，对应行会显示 手动处理，点击后弹窗会说明这个问题为什么需要人工介入。dry-run 没有返回可执行 SQL 时，弹窗也会明确提示，此时同样需要人工处理。 修复后点击 重新检查 确认问题已经消除。
最后修改于 2026年9月14日