页面只提交任务,不直接改项目。所有变更都由后台任务异步执行,需要到 任务 / 历史 中确认结果。
表格查询运维默认关闭。需要在后端把
V2_TABLE_QUERY_OPS_ENABLED 设为 true 并重启,页面才会开始积累观测数据。找到需要处理的表
页面打开是表列表。顶部一排状态按钮带各自的数量,用来缩小范围:
搜索框支持表、项目和空间的名称或 ID。排序可选 慢查询最多 或 表名称。观测窗口 可选最近 1 小时或 24 小时,列表中的观测数据都按这个窗口统计。观测记录保留 2 天,更早的数据不会出现在列表里。
列表每行给出这张表的估算行数和体积、窗口内的请求数与慢查询数、当前搜索方式和字段覆盖情况、筛选 / 排序索引数量,以及待处理的建议数和活动任务数。点击表名进入详情。
状态按钮右侧的 状态说明 中给出了这几个数字的统计口径。
读懂索引状态
表列表和表详情都会在搜索方式旁标出这张表的索引状态:
状态下方还可能出现两行说明:已配置:pg_bigm / pg_trgm 表示保存的提供程序与当前实际使用的搜索方式不一致;索引搜索运行时开关:关闭 表示索引已就绪,但运行时未开启,搜索仍走
ILIKE。
索引已发布不等于每次搜索都命中索引:搜索词过短或字段超出覆盖范围时,查询仍会回退为
ILIKE。此页面反映的是索引现状,不能证明近期请求实际命中过索引。配置搜索覆盖
表详情的 搜索覆盖 标签显示这张表当前的搜索方式、已覆盖字段数,以及每个字段的 生效覆盖。点击 显示未覆盖字段 可以只看还没纳入的字段;标为 不适用 的字段无法用于子串搜索索引。生效覆盖要求索引元数据已发布且可用、且运行时开关已开启,仅保存配置不计入覆盖。覆盖范围由显式选择决定,此后新建的字段不会自动纳入,需重新配置一次才会加入。
点 分析并预演 做一次不落地的试算,弹窗会给出覆盖字段数、预估行数、是否已有执行计划证据,以及重建或新建带来的影响。预估行数达到 50,000 行及以上、或规模未知的表,还需要勾选维护窗口确认项。确认无误后点 确认并提交任务。
提交后弹窗给出的是任务回执,不是执行结果。关掉弹窗,到 任务 / 历史 跟进。同一个变更重复提交只会返回已有任务。
管理筛选 / 排序索引
筛选 / 排序索引 标签列出这张表上服务于筛选条件和排序的物理索引,每条标明有效性、是否由 Teable 托管,以及索引大小和定义。这类索引与子串搜索索引分开管理。 下方的 待处理操作 是系统给出的索引建议,并标明是否已有执行计划证据。点 审查索引创建 查看建议的索引、执行所在的项目和依据,确认后 Teable 会异步执行CREATE INDEX CONCURRENTLY。大表或规模未知的表同样需要先勾选维护窗口确认项。
此页面不支持删除索引。非托管索引和系统索引可能用于约束或其他查询,不会在这里被删掉。
诊断具体查询
用户反馈某张表慢,但没有对应建议时,打开 查询诊断 标签点 分析查询。分析只读取已保存的查询形态和执行计划证据,不会创建任何索引。 结论有三种:发现有执行计划支持的索引优化机会、现有执行计划未确认索引优化机会、证据不足。证据不足时不要据此断定发生了顺序扫描,只有慢查询观测,不足以证明访问路径有问题。下方会逐条列出受影响的查询、它来自实际流量还是保存的视图配置,以及启用建议索引前后的计划成本估算(是计划成本,不是毫秒)。跟进执行结果
任务 / 历史 标签包含三部分:- 任务:这张表的后台任务,含状态、尝试次数、任务类型和失败原因。任务最终成功但此前失败过时,错误信息会标注为历史尝试。
- 搜索配置历史:历次搜索覆盖配置的提供程序、状态和字段列表。
- 建议历史:已接受、已忽略或已被替代的建议。
表上有排队中或运行中的任务时,配置搜索和创建索引的按钮会暂时不可用,等任务结束后再操作。

