> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Schema 完整性

> 排查并修复 Base 的字段定义与数据库结构不一致的问题。

<Tip>私有化部署商业版及以上适用</Tip>

路径：管理面板 → Schema 完整性

Teable 记录的字段定义和数据库里的实际结构应当一一对应。两者出现偏差时，用户侧会表现为字段打不开、关联字段取不到值，或某张表的读写持续报错，而表面上看不出原因。**Schema 完整性** 用于定位这类问题并修复。

实例管理员可以检查实例内的任意 Base，不需要先加入对应空间，使用客户自管数据库（BYODB）的租户同样可以检查。

## 运行检查

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

点击该行的 **检查**，在 **Schema 完整性检查** 弹窗中点击 **开始检查**。

## 读懂检查结果

结果按字段和规则逐条列出，分四种状态：

| 状态     | 含义                             | 该怎么办               |
| ------ | ------------------------------ | ------------------ |
| **错误** | 字段的关联目标已不存在，或字段配置与数据库中的实际结构对不上 | 这是导致读写失败的直接原因，需要修复 |
| **警告** | 与预期结构存在偏差，但当前仍可正常读写            | 可以修复，也可以先记录下来观察    |
| **跳过** | 该规则不适用于这个字段，未做判断               | 无需处理               |
| **正常** | 与预期一致                          | 无需处理               |

先看 **错误**：用户报告的故障基本都落在这一类。**警告** 不解释当前的故障，但会随着字段结构继续变化演变成错误，适合在排查完错误后一并处理。

## 修复

可以按规则逐条 **修复**，也可以用 **仅修复警告** 或 **修复警告和错误** 批量处理。排查线上故障时建议先逐条修复错误，确认故障消失后再处理警告，这样出问题时能定位到是哪一条改动引起的。

修复只改动表结构，不改动记录内容。执行前点击修复按钮旁的预览，可以在 **确认修复内容** 中看到 dry-run 返回的修复原理和将要执行的 SQL，确认后才会真正执行。

部分规则无法自动修复，对应行会显示 **手动处理**，点击后弹窗会说明这个问题为什么需要人工介入。dry-run 没有返回可执行 SQL 时，弹窗也会明确提示，此时同样需要人工处理。

修复后点击 **重新检查** 确认问题已经消除。