Skip to main content
私有化部署商业版及以上适用
路径:管理面板 → 计算任务队列 当公式、Lookup 等计算字段长时间没有更新,或更新时间明显变长时,可以打开 计算任务队列。页面会显示计算任务的整体状态、队列中正在流转的任务、可能需要恢复的异常任务,以及当前被暂停计算的空间。

查看健康状态

页面标题旁的状态表示计算任务是否需要处理: 状态需要关注时,页面会显示具体原因。

在队列中定位任务

BullMQ 实时队列 会列出当前保留的任务,可以用它跟踪某个计算任务,或者找出耗时偏长的任务。 列表默认一个任务一行,Teable 重试时该行会原地切换状态。需要查看某个任务的完整尝试记录,或排查慢任务时,切换到 投递明细,可以看到每一次唤醒投递。 缩小范围的方式:
  • 点击表格上方的状态卡片(等待中执行中延迟任务失败已完成(保留) 等)按状态筛选,可以多选;悬停卡片会说明该状态的含义。
  • SpaceBase触发原因执行结果 筛选,搜索任务、Base、Space 或错误,也可以设置最短处理耗时来找出慢任务。
  • 点击某一行可以查看详情:入队和投递时间、投递延迟、处理耗时;失败的投递还会给出完整失败原因和脱敏后的 SQL。
已完成 不代表任务真的做了事情。执行结果徽章说明这次投递的实际结果:已执行 表示执行了计算任务,无操作 表示已无事可做,已推迟 表示改到稍后重试,已挂起 表示所在范围被暂停。执行结果 筛选器可以按这些结果筛选,并显示每种结果各有多少条;把 已完成(保留)已执行 一起选上,剩下的就是真正执行过计算任务的投递。
失败行只是某一次投递尝试的历史记录,不代表任务卡住,持久任务会自行继续重试。是否需要介入,要看 账本状态 一列:已了结 表示后续重试已经成功,已成死信 可以跳转到异常任务维护。已了结的失败记录默认隐藏,横幅会显示条数并支持展开。 清理失败记录 只会清掉队列中保留的失败任务记录,不会修复任何问题,死信仍然保留在 异常任务维护 中。 状态卡片的计数中还可能包含任务数据已不在 Redis 中的记录,通常是数据被驱逐或丢失后的残留。列表无法显示这类记录,页面会在表格下方说明差异。失败状态中的这类残留会被自动清理,也可以用 清理失败记录 立即清除。

处理异常任务

失败异常任务维护 显示的是不同类型的问题,因此数量可能不一致。
异常任务维护 会按 Base、来源表和错误把异常合并成问题组,便于定位同一根因。恢复之前,请先查看失败原因并修复问题。展开问题组可以查看具体错误和组内任务,这些行仅供排查,恢复始终以整个问题组为单位。 问题组可用的操作取决于它的类型: 恢复完成后,Teable 会给出恢复条数、新入队与已在队列的条数,以及已投递和延迟投递的条数。随后 Worker 会按现有的并发和任务分片限制逐步消费这一组任务。 标记为 Base 已删除 的问题组,对应的 Base 已经不存在,恢复后会立即再次失败,因此只提供 丢弃问题组

暂停某个空间的计算任务

当某个空间的计算任务正在加剧故障时,可以在 计算任务暂停 中单独暂停这个空间,而不必停掉整个实例。
1

打开暂停弹窗

点击 暂停空间
2

找到目标空间

按 Space ID 或名称搜索,然后在结果中选中。
3

选择暂停时长

暂停时长 中选择 15、30、60 或 120 分钟。
4

填写原因(可选)

原因 中写明事故或维护窗口。
5

确认

点击 确认暂停
暂停只会阻止 Worker 领取该空间新的计算任务。已经在执行的任务不会被中断,匹配到的任务会一直等待,不会被丢弃。 暂停到期后会自动解除,最长 2 小时。处理时间超出时,可以在本页面重新暂停续期。列表会显示所有生效中的暂停,包括操作人、原因和自动恢复时间,并显示这些暂停当前积压了多少待处理任务,便于判断恢复后会释放多少工作量。需要提前解除时,点击对应行的 恢复 并确认。

调整并发

队列区域有两个并发控件。两者都写入集群级覆盖值,所有进程约 15 秒内生效,无需重启,也都可以恢复默认,让各进程回到自身环境变量的设置。覆盖生效时,控件上会显示 已覆盖 标记。 单个 Base 成为瓶颈时,调大 claim 上限;多个 Base 同时排队时,调大每进程并发。
并发调高会增加数据库压力。使用数据库租户存储数据的空间,claim 上限始终使用环境变量默认值,因为其连接池是按默认值配置的。
最后修改于 2026年8月12日