新月意味着 MeiliSearch 的新版本，11 月也不例外。此版本引入了一项功能，使 MeiliSearch 的设置和使用更加轻松：隐式索引创建。我们还改进了与转储和快照相关的设计。

与往常一样，我们对这些功能的首要目标是易用性。我们希望使 MeiliSearch 尽可能地易于访问和直观，同时不会牺牲速度、功能或灵活性。有了这个想法，让我们深入了解一下吧！

隐式索引创建

以前，向 MeiliSearch 添加文档需要您首先使用 创建索引端点 创建索引。只有之后才能 添加文档，方法是提供 index 名称。

从本版本开始，不再需要第一步：可以直接添加文档，而无需事先创建索引。

$ curl \
  -X POST 'http://localhost:7700/indexes/movies/documents' \
  --data '[{
      "id": 287947,
      "title": "Shazam",
      "overview": "A boy is given the ability to become an adult superhero in times of need with a single magic word.",
  }]'
如果 movies 索引不存在，它将被创建。

在上面的示例中，我们调用 添加文档端点 并提供 movies 作为索引目标。如果名为 movies 的索引已存在，则上述命令将只在其中添加文档。但是，由于在本示例中 movies 索引尚未创建，它将改为创建一个名为 movies 的新索引并在其中添加提供的文档。

简而言之：如果提供的索引在添加文档时不存在，则该索引将被自动创建。

转储和快照的改进

在过去一个月里，我们对转储和快照进行了尝试，我们决定对 API 设计进行一些更改（并在我们进行更改时修复一些错误）。

如果您想了解有关转储和快照的更多信息，请 查看本指南。

转储

  • 转储的三个可能状态的名称已更改以提高清晰度。它们现在分别是 processing、failed 和 done。
  • 在发生错误的情况下，转储状态主体现在将包含通常的错误主体。
{
    "uid": "20201008-105011897",
    "status": "failed",
    "message": "Dump process failed",
    "errorCode": "dump_process_failed",
    "errorType": "internal_error",
    "errorLink": "https://docs.meilisearch.com/errors#dump_process_failed"
}
典型的转储错误。
  • 我们选择删除环境变量 MEILI_IMPORT_DUMP。--import-dump 启动选项保持不变。
  • --dumps-folder 选项已更改为 --dumps-dir。
  • 环境变量 MEILI_DUMPS_FOLDER 已更改为 MEILI_DUMPS_DIR。
  • 转储文件现在扩展名为 .dump 而不是 .tar.gz。

快照

  • --snapshot-path 启动选项已更改为 --snapshot-dir。
  • 环境变量 MEILI_SNAPSHOT_PATH 已更改为 MEILI_SNAPSHOT_DIR。
  • 以前，--snapshot-folder 选项用于激活快照。现在，--snapshot-folder 的默认值为 /snapshots，--schedule-snapshot 是激活快照创建的新方法。
$ meilisearch --schedule-snapshot=true
激活在默认的 /snapshots 文件夹中创建定期快照。
  • --load-from-snapshot 已重命名为 --import-snapshot
  • 快照文件现在扩展名为 .snapshot 而不是 .tar.gz。
  • 以下环境变量已被删除：MEILI_IMPORT_SNAPSHOT 、MEILI_IGNORE_MISSING_SNAPSHOT 和 MEILI_SNAPSHOT_IF_DB_EXISTS。它们等效的 CLI 选项保持不变。

错误修复

贡献

感谢 @akrantz01 对 urlEncode 问题的贡献，以及感谢 @jcohlmeyer 抽出时间 解释这个问题。

感谢 @gorogoroumaru 对 修复 displayedAttributes 和 fieldsDistribution 键的显示顺序的贡献。

我们总是渴望听到来自用户和贡献者的更多反馈！请随时使用 您喜欢的方式与我们交谈。

我们也对社区的支持感到激动，社区的星标和用户似乎都在不断增长。让我们继续努力吧！

感谢您使用我们的搜索引擎！如果您喜欢它，请考虑 在 github 上为我们加星标。