在本文中，让我们来了解一下 Meilisearch 最新更新中的一些最重大变化。您可以阅读 GitHub 上的完整变更日志，但我们将在这篇文章中介绍主要内容。

零停机索引部署

将您的数据库更改与 Meilisearch 索引同步会导致停机。您无法承受搜索“中断”：用户体验至关重要。您已经想出了一些解决方法，但这需要时间和资源。一定有更简单的处理方法，对吧？

v0.30 引入了索引交换。您现在可以以零停机时间部署新索引版本！

要同步生产环境中您的主要数据库与 Meilisearch 索引（indexA）之间的更改，您只需执行以下步骤

  • 步骤 1：创建一个包含所有这些更改的新索引版本（indexA_new）
  • 步骤 2：交换索引，这意味着您用 indexA_new 的文档、设置和任务历史记录替换 indexA 的文档、设置和任务历史记录。这是您需要发送以实现魔术的请求
curl \
  -X POST 'http://localhost:7700/swap-indexes'\
  -H 'Content-Type: application/json' \
  --data-binary '[
      { "indexes": ["indexA", "indexA_new"] }
  ]'

⏲️ 等待任务状态更新为 succeeded...

🎉 大功告成！您的更改现在已投入生产！您的用户仍在 indexA 中搜索，但它现在包含 indexA_new 的数据，而 indexA_new 则包含 indexA 的数据。

新功能：任务取消和删除

v0.30 使您能够更好地控制异步操作：您现在可以取消任务并删除任务历史记录。

任务取消

无法取消任务一直是用户随着时间推移提出的反复出现的问题之一。无法中断错误排队的任务或处理时间过长会非常令人沮丧。

使用 v0.30，此问题现在已成为过去。使用新的 API 路由 /tasks/cancel，您可以根据以下内容取消已排队的任务或正在处理的任务

  • uid
  • 状态
  • 类型
  • indexUid
  • 它们排队或开始的日期（beforeEnqueuedAt、afterEnqueuedAt、beforeStartedAt、afterStartedAt）

您可以在我们的 文档 中详细了解任务。

要取消所有将文档添加到索引或更新索引的已排队任务，您应该发送以下请求

curl \
  -X POST 'http://localhost:7700/tasks/cancel?statuses=enqueued&types=documentAdditionOrUpdate’

任务删除

已成功或失败（现在已取消）的任务信息在具有大量异步操作的实例中会占用宝贵的磁盘空间。使用新的 DELETE /tasks 端点清理已完成的任务。

与任务取消一样，任务删除也可以根据任务的以下内容进行

  • uid
  • 状态
  • 类型
  • indexUid
  • 它们排队或开始的日期（beforeEnqueuedAt、afterEnqueuedAt、beforeStartedAt、afterStartedAt）

但您也可以根据它们完成处理的日期以及取消它们的哪个任务来删除它们

  • beforeFinishedAt
  • afterFinishedAt
  • canceledBy

以下请求会删除在 2020 年 10 月 11 日上午 11:49:53 之前处理的所有任务。

curl \
  -X DELETE 'http://localhost:7700/tasks?beforeFinishedAt=2020-10-11T11:49:53.000Z'

新功能：配置文件支持

感谢我们亲爱的贡献者 mlemesle，一种配置 Meilisearch 实例的新方法已经加入了聊天。除了环境变量和 CLI 选项之外，您还可以使用配置文件🥳

配置文件可以轻松共享和版本化。它们允许您在一个位置管理所有配置选项，并一目了然地提供整体视图。

为此，请在一个 .toml 文件中设置所需的实例选项

env = "production"
master_key = "YOUR_MASTER_KEY_VALUE"

您可以使用 --config-file-path CLI 选项或 MEILI_CONFIG_FILE_PATH 环境变量来指定配置文件。否则，Meilisearch 将使用工作目录中的文件 ./config.toml 作为默认配置文件。您可以使用以下命令下载默认配置文件

curl https://raw.githubusercontent.com/meilisearch/meilisearch/main/config.toml > config.toml
👉
请注意，在配置文件中指定 config-file-path 密钥将引发错误。

如果未提供配置文件，则 Config file path 设置为 none。

改进：搜索结果分页

v0.30 为需要分页界面的用户引入了编号分页模式。

在 v0.29 之前，使用搜索端点时，Meilisearch 只返回 estimatedTotalHits，这是与查询匹配的文档数量的估计值。因此，不建议创建带有页面选择器的界面。

您现在可以使用新的搜索参数 page 或 hitsPerPage 来获取查询的完整命中次数和页面总数。

curl \
  -X POST 'http://localhost:7700/indexes/movies/search' \
  -H 'Content-Type: application/json' \
  --data-binary '{ "q": "american ninja", "page": 1 }'

上面的请求将获取给定查询的第一页结果，并将返回以下响应

{
  "hits": [
        // … 20 hits
    ],
  "query": "american ninja",
  "processingTimeMs": 2,
  "hitsPerPage": 20,
  "page": 1,
  "totalPages": 49,
  "totalHits": 966
}

如您所见，它返回完整搜索结果数量（totalHits）和搜索结果页面数量（totalPages），这使您可以轻松创建编号分页界面。


👉 请注意，totalHits 和 totalPages 是根据分页的 pagination.maxTotalHits 索引设置 计算的。

重大更改

字段重命名

当 通过批处理删除文档 时，相应的任务对象包含一个字段，其中包含收到的文档 ID 数量。此字段以前称为 receivedDocumentIds，现在已重命名为 providedIds。

新错误

在用户尝试访问 /keys 路由而未设置主密钥的情况下，Meilisearch 现在会抛出一个更有用的错误 missing_master_key

{
    "message": "Meilisearch is running without a master key. To access this API endpoint, you must have set a master key at launch.",
    "code": "missing_master_key",
    "type": "auth",
    "link": "https://docs.meilisearch.com/errors#missing_master_key"
}

任务过滤器和错误命名

为了使命名与它们可以具有的值保持一致，我们对用于筛选任务的查询参数进行了复数化

  • indexUid 变为 indexUids
  • type 变为 types
  • status 变为 statuses

我们还重命名了以下错误代码

  • invalid_task_type 更改为 invalid_task_types_filter
  • invalid_task_status 更改为 invalid_task_statuses_filter

Hacktoberfest 贡献

我们对在 Hacktoberfest 期间收到的所有贡献表示衷心的感谢。上述大多数更改都来自这些贡献，我们想重点介绍另外两个更改。如果没有我们的贡献者，我们不会在此版本中发布它们。

  • 由 @mou 提供的压缩 API 请求（Gzip、Brotli、Zlib）支持
  • 感谢 @jeertmans 提供的 Apple Silicon 二进制文件

其他更改

  • Meilisearch 默认绑定到 127.0.0.1:7700，这是一个 IPv4 地址。为了使 Meilisearch 可以通过 IPv4（127.0.0.1:7700）和 IPv6（[::1]:7700）地址访问，我们已将默认地址更改为 localhost:7700。
  • 所有任务对象现在都包含 canceledBy 和 error 字段
  • 新的 任务过滤器 可用于 GET /tasks 端点
    • uids
    • beforeEnqueuedAt / afterEnqueuedAt
    • beforeStartedAt / afterStartedAt
    • beforeFinishedAt / afterFinishedAt
    • canceledBy
  • 我们引入了一种新的任务类型：snapshotCreation。快照任务现在在 任务列表 中可见
  • 索引速度已大大提高
  • 我们减少了 Meilisearch 二进制文件的大小以及 Meilisearch 实例在磁盘空间中占用的空间
  • 所有实例选项现在都有其对应的环境变量。一些与快照和转储功能相关的选项丢失了

衷心感谢我们所有的贡献者！如果没有您的帮助，这个项目就不会取得如此大的进展🙏

这就是 v0.30 的全部内容！请记住查看 变更日志 以获取完整的发布说明。