使用任务
在本教程中,您将使用 Meilisearch API 向索引添加文档,然后监控其状态。
许多 Meilisearch 操作都是在任务中异步处理的。异步任务允许您对 Meilisearch 项目进行资源密集型更改,而不会对用户造成任何停机。
在本教程中,您将使用 Meilisearch API 向索引添加文档,然后监控其状态。
要求
- 一个正在运行的 Meilisearch 项目
- 一个命令行控制台
向任务队列添加任务
需要索引的操作,例如添加和更新文档或更改索引设置,将始终生成一个任务。
首先创建一个索引,然后向该索引添加大量文档。
Meilisearch 不会立即处理您的请求,而是将其添加到队列中并返回一个摘要任务对象。
摘要任务对象是您的请求已被接受的确认。它还为您提供了可用于监控请求状态的信息,例如 taskUid
。
您可以使用 Cloud 界面向新的 Meilisearch Cloud 索引添加文档。要获取此任务的 taskUid
,请访问“任务”概览,查找与您新创建的索引相关的“文档添加或更新”任务。
监控任务状态
Meilisearch 按照任务添加到队列的顺序处理任务。您可以使用 Meilisearch Cloud 界面或 Meilisearch API 检查任务的状态。
在 Meilisearch Cloud 界面中监控任务状态
登录您的 Meilisearch Cloud 账户并导航到您的项目。点击项目菜单中的“任务”链接。
这将引导您进入任务概览。在“Uid”列中查找您的请求的 taskUid
。
当任务 status
变为 succeeded
时,Meilisearch 已完成处理您的请求。
如果任务 status
变为 failed
,Meilisearch 未能满足您的请求。检查任务对象的 error
字段以获取更多信息。
使用 Meilisearch API 监控任务状态
使用您请求响应中的 taskUid
来检查任务的状态。
这将返回完整的任务对象。
如果任务仍处于 enqueued
或 processing
状态,请稍等片刻,然后再次查询数据库。如果您正在使用自托管的 Meilisearch 实例,您还可以设置一个 Webhook 监听器。
当 status
变为 succeeded
时,Meilisearch 已完成处理您的请求。
如果任务 status
变为 failed
,Meilisearch 未能满足您的请求。检查任务对象的 error
字段以获取更多信息。
结论
您已经了解了 API 请求如何向任务队列添加任务,以及如何检查该任务的状态。有关任务如何工作的更多信息,请查阅任务 API 参考和异步操作解释。