查看推荐
页面默认打开 推荐 标签,并按优先级排序。分析器会同时衡量查询风险和表的使用热度,最值得处理的排在最前面。 搜索表、Base 或 Space 的 ID 可以在全部推荐中过滤;其他文本只在当前结果内过滤。状态和风险筛选器可以进一步缩小范围。 每条推荐都会标出所属的空间、Base 和表名。展开某一行,可以看到推荐依据、系统决策和 SQL 诊断信息:
点击 深度分析 会打开分析工作台,并自动填入该表。
当分析器观测到某张表存在大量子串搜索时,会针对整张表给出一条 generated-text GIN 推荐,而不是逐个字段建索引。这类推荐行会用 创建搜索路径 取代 深度分析,也不会出现 添加索引:搜索访问路径要在分析工作台里应用,并且需要先做一次 EXPLAIN 样例搜索。该表建好搜索路径后,这条推荐会自动关闭。
旁边还有两个标签:
当配置问题拖住整个流程时,列表上方会出现提示横幅:已配置搜索访问路径但运行时开关未开启;部分表的访问路径处于 stale 或待重建状态,这些表的搜索已静默退回更慢的
ILIKE 扫描;或者最老的排队任务等待过久,说明可能没有 worker 在消费。先处理横幅中提示的问题,再去处理下方的推荐。
读懂决策徽章
每条推荐都会带上系统对它的最新决策:默认情况下,Teable 只记录决策并生成推荐和任务记录,不会自动改动数据库。自动执行需要通过
V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto 主动开启,且只对执行计划显示明显成本改善的小表生效,其余都会等待管理员确认。按建议添加索引
如果认可某条推荐给出的索引,点击该行的 添加索引。确认后 Teable 会接受这条推荐,并在底层 PostgreSQL 表执行CREATE INDEX CONCURRENTLY;执行计划未验证时,仍会按推荐字段建索引。弹窗里会再列一遍推荐依据,方便最后核对。
预估行数达到 50,000 行及以上的表,需要先在弹窗中勾选确认已安排维护窗口,确认按钮才可用。大表的并发建索引耗时较长,执行期间会额外增加负载。
执行后 Teable 会提示 索引已创建 或 已接受推荐并写入任务;属于后者时,到 任务 标签跟进执行结果。如果这条推荐没有可执行的物理列,添加索引 会保持不可用并说明原因,此时改用分析工作台进一步排查。
发起深度分析
点击 分析工作台 可以主动分析指定范围,例如用户反馈某张表很慢,但还没有对应的推荐时。
选择 表、Base 或 Space,填写对应 ID,再选择分析类型。如果已经知道哪张表较慢,建议从 表 开始分析。
点击 生成查询报告 或 生成搜索报告。报告会汇总发现的风险和建议的后续操作。生成搜索报告时,EXPLAIN 样例搜索词 为可选项。填写后,报告会检查建议的子串搜索访问路径是否保持相同的查询结果,并比较执行计划和多次查询耗时。Teable 不会保存这个搜索词。
查询报告不会修改数据库。执行子串搜索建议前,必须填写 EXPLAIN 样例搜索词 并由管理员确认。

