v0.30 有哪些新功能

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

零停机索引部署

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

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

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

• 步骤 1：创建一个包含所有这些更改的新版本索引 —indexA_new—
• 步骤 2：交换索引，这意味着您将 indexA 的文档、设置和任务历史记录替换为 indexA_new 的相应内容。这是您需要发送的请求，以实现这一神奇效果：

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
• 状态
• 类型
• 索引uid
• 入队或开始日期（beforeEnqueuedAt、afterEnqueuedAt、beforeStartedAt、afterStartedAt）

您可以在我们的文档中了解有关任务的更多信息。

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

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

任务删除

成功或失败（以及现在已取消）的任务信息在异步操作数量较多的实例中可能会占用大量所需的磁盘空间。使用新的 DELETE /tasks 端点清理已完成的任务。

与任务取消一样，任务删除也可以根据任务的以下属性进行：

• uid
• 状态
• 类型
• 索引uid
• 入队或开始日期（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 将设置为 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 的内容就到这里！请记得查看更新日志以获取完整的发布说明。