定时任务
在 Atoms Cloud 中创建定时任务、查看运行历史,并启用或停用任务。
使用 Atoms Cloud 的 Jobs(定时任务)功能,集中查看和管理项目的计划任务。任务可以按计划自动执行应用逻辑,例如清理数据、同步库存、生成报表或发布定时内容。
你可以在项目对话中创建和修改任务,再通过 Jobs 面板查看执行计划、检查运行历史,以及启用或停用后续运行。
打开 Jobs
- 打开项目;如果尚未连接 Atoms Cloud,请先完成连接。
- 打开 Cloud 面板。
- 在侧边栏选择 Jobs。
列表会显示每个任务的名称、状态、执行计划和上次运行时间。点击 Refresh(刷新)获取最新信息;任务较多时,可以使用分页控件浏览。
创建定时任务
- 返回项目对话。
- 描述任务要做什么,以及何时执行。说明需要使用的数据和预期结果。
- 检查生成的实现,确认执行计划;如果指定固定时刻,也要确认所用时区。
- 任务创建完成后,返回 Cloud → Jobs,点击 Refresh。
- 打开任务,检查计划和状态。任务执行后,查看运行历史,并在应用中确认实际结果。
示例提示词:“创建一个定时任务,每 5 分钟检查一次库存,并更新数据库中的商品可售状态。”
如果列表显示 No jobs are scheduled yet(暂无计划任务),请先在对话中创建任务,再刷新面板。Jobs 面板主要用于查看任务和启停;创建和修改通过对话或 SQL 编辑器完成。
理解任务状态与运行状态
任务状态决定任务是否按计划执行:
- Active(已启用):任务已开启,可以按计划运行。
- Disabled(已停用):停止后续按计划触发,之前的运行记录仍可查看。
每一次运行都有独立的结果状态:
- Running(进行中):本次运行尚未结束。
- Succeeded(成功):本次运行已成功完成。
- Failed(失败):本次运行以失败结束。
Active 只表示任务已启用,并不代表每次运行都成功。请通过运行历史查看每次执行的结果。
查看运行历史
- 在 Cloud → Jobs 中选择一个任务。
- 查看执行计划和 Last run(上次运行时间)。
- 在运行历史表中查看运行序号、开始时间、结束时间和结果状态。
- 点击 Refresh 获取最新结果,或使用分页控件查看更早的记录。
运行记录按时间倒序排列,最新记录在前。尚未执行过的任务会显示暂无运行记录。
停用或启用任务
- 打开任务详情。
- 点击 Disable(停用)阻止后续按计划运行,或点击 Enable(启用)恢复按计划执行。
- 确认状态已更新,并查看操作结果提示。
停用不会取消已经开始的运行。当前这一次会继续执行,并按实际结果记录为成功或失败。停用也不会修改任务的执行计划、逻辑或已有运行历史。
修改或删除任务
在项目对话中修改任务的执行计划、调整逻辑或删除任务。请明确任务名称和希望进行的变更。
- 修改计划:“把库存同步任务改为每 30 分钟执行一次。”
- 调整逻辑:“修改库存同步任务,只处理标记为已启用的商品。”
- 删除任务:“删除库存同步定时任务。”
熟悉数据库的用户也可以通过 SQL 编辑器创建、修改或删除任务。变更后,返回 Jobs 并刷新,确认结果。如果只是想暂时停止后续运行,使用 Disable 即可。
管理用量
运行频繁或执行时间较长的任务可能增加资源消耗。请根据应用需要选择频率,让每个任务专注于必要的工作,并停用暂时不需要执行的任务。用量信息请以 Cloud 面板中的显示为准。
常见问题
新建的任务没有出现在列表中
确认当前查看的是正确的项目,检查对话中任务是否已成功创建,然后刷新 Jobs 列表。
任务没有运行历史
检查任务是否处于 Active 状态,并确认执行计划。如果还未到第一次计划执行时间,可能暂时没有运行记录。对于固定时刻的任务,请在对话中确认所用时区。
某次运行失败了
在历史记录中找到任务名称和失败的运行时间,将这些信息提供给项目对话中的 Atoms,请它检查任务逻辑及依赖的服务或数据。修复后,查看后续运行的结果。
任务已停用,但仍有 Running 记录
这次运行可能在停用前已经开始。停用只阻止后续计划触发,当前运行会继续完成。刷新运行历史即可查看最终结果。