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

