Skip to main content
私有化部署商业版及以上适用
路径:管理面板 → 表格查询运维 当大表中的视图、筛选、关联或搜索变慢时,可以使用 表搜索与索引。后台会持续观测查询负载,页面按表汇总现状:这张表现在用什么方式搜索、覆盖了哪些字段、有哪些物理索引、近期有多少慢查询。实例管理员可以在这里配置搜索覆盖、创建索引,并跟进执行结果。
页面只提交任务,不直接改项目。所有变更都由后台任务异步执行,需要到 任务 / 历史 中确认结果。
表格查询运维默认关闭。需要在后端把 V2_TABLE_QUERY_OPS_ENABLED 设为 true 并重启,页面才会开始积累观测数据。

找到需要处理的表

页面打开是表列表。顶部一排状态按钮带各自的数量,用来缩小范围: 搜索框支持表、项目和空间的名称或 ID。排序可选 慢查询最多表名称观测窗口 可选最近 1 小时或 24 小时,列表中的观测数据都按这个窗口统计。观测记录保留 2 天,更早的数据不会出现在列表里。 列表每行给出这张表的估算行数和体积、窗口内的请求数与慢查询数、当前搜索方式和字段覆盖情况、筛选 / 排序索引数量,以及待处理的建议数和活动任务数。点击表名进入详情。 状态按钮右侧的 状态说明 中给出了这几个数字的统计口径。

读懂索引状态

表列表和表详情都会在搜索方式旁标出这张表的索引状态: 状态下方还可能出现两行说明:已配置:pg_bigm / pg_trgm 表示保存的提供程序与当前实际使用的搜索方式不一致;索引搜索运行时开关:关闭 表示索引已就绪,但运行时未开启,搜索仍走 ILIKE
索引已发布不等于每次搜索都命中索引:搜索词过短或字段超出覆盖范围时,查询仍会回退为 ILIKE。此页面反映的是索引现状,不能证明近期请求实际命中过索引。

配置搜索覆盖

表详情的 搜索覆盖 标签显示这张表当前的搜索方式、已覆盖字段数,以及每个字段的 生效覆盖。点击 显示未覆盖字段 可以只看还没纳入的字段;标为 不适用 的字段无法用于子串搜索索引。
生效覆盖要求索引元数据已发布且可用、且运行时开关已开启,仅保存配置不计入覆盖。覆盖范围由显式选择决定,此后新建的字段不会自动纳入,需重新配置一次才会加入。
还没配置过的表点 配置搜索,已配置过的点 更新字段选择 / 重建;重建时弹窗会带出上次保存的提供程序和字段选择,在此基础上调整。弹窗中需要填: 分析并预演 做一次不落地的试算,弹窗会给出覆盖字段数、预估行数、是否已有执行计划证据,以及重建或新建带来的影响。预估行数达到 50,000 行及以上、或规模未知的表,还需要勾选维护窗口确认项。确认无误后点 确认并提交任务
创建或重建搜索覆盖会生成搜索列和 GIN 索引,可能重写整张表并持有锁,期间索引搜索会短暂中断。请安排在维护窗口执行。
提交后弹窗给出的是任务回执,不是执行结果。关掉弹窗,到 任务 / 历史 跟进。同一个变更重复提交只会返回已有任务。

管理筛选 / 排序索引

筛选 / 排序索引 标签列出这张表上服务于筛选条件和排序的物理索引,每条标明有效性、是否由 Teable 托管,以及索引大小和定义。这类索引与子串搜索索引分开管理。 下方的 待处理操作 是系统给出的索引建议,并标明是否已有执行计划证据。点 审查索引创建 查看建议的索引、执行所在的项目和依据,确认后 Teable 会异步执行 CREATE INDEX CONCURRENTLY。大表或规模未知的表同样需要先勾选维护窗口确认项。
此页面不支持删除索引。非托管索引和系统索引可能用于约束或其他查询,不会在这里被删掉。

诊断具体查询

用户反馈某张表慢,但没有对应建议时,打开 查询诊断 标签点 分析查询。分析只读取已保存的查询形态和执行计划证据,不会创建任何索引。 结论有三种:发现有执行计划支持的索引优化机会现有执行计划未确认索引优化机会证据不足。证据不足时不要据此断定发生了顺序扫描,只有慢查询观测,不足以证明访问路径有问题。下方会逐条列出受影响的查询、它来自实际流量还是保存的视图配置,以及启用建议索引前后的计划成本估算(是计划成本,不是毫秒)。

跟进执行结果

任务 / 历史 标签包含三部分:
  • 任务:这张表的后台任务,含状态、尝试次数、任务类型和失败原因。任务最终成功但此前失败过时,错误信息会标注为历史尝试。
  • 搜索配置历史:历次搜索覆盖配置的提供程序、状态和字段列表。
  • 建议历史:已接受、已忽略或已被替代的建议。
历史只加载最近若干条,超出时列表上方会说明总数。
表上有排队中或运行中的任务时,配置搜索和创建索引的按钮会暂时不可用,等任务结束后再操作。
最后修改于 2026年9月15日