本文介绍了 Meilisearch 最新版本中的一些主要变化。有关更多详细信息,请查看 GitHub 上的完整变更日志

新功能:匹配策略

v0.29 引入了一个新的搜索参数:matchingStrategy。此参数允许您在搜索时定义 Meilisearch 如何匹配查询词。

  • last:首先返回包含所有查询词的文档。然后通过减少匹配中存在的查询词数量来检索附加结果:Meilisearch 将从查询的末尾开始一次删除一个查询词,并将任何新匹配项包含到结果列表中。这自 v0.21 起一直是默认行为,并将保持为默认策略。
  • all:仅返回包含所有查询词的文档。

示例

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

使用上述请求,Meilisearch 仅返回同时包含“american”和“ninja”的文档。

我们希望此新功能能够鼓励那些仍在使用 v0.20 的用户(最后一个默认使用 all 匹配策略的官方 Meilisearch 版本)升级到我们的最新版本,并从此后引入的新功能中获益:排序地理搜索细粒度 API 密钥权限等等!如果您仍然使用 v0.20 并且不打算立即升级,我们很乐意了解是什么阻止您升级 了解一下

您可以使用 匹配策略演示 测试此功能,并在 专门的博客文章 中了解更多信息。

改进:索引性能

我们加快了索引速度,特别是以下操作

  • Facet 索引:我们修改了算法以提高可过滤属性的索引速度
  • 文档删除和更新
  • 我们引入了软删除。 这是一种使用标志将数据标记为已删除的技术,使其对所有用户不可访问,而不会实际将其从数据库中删除。文档将在以后的日期删除,在占用设备上过多空间之前。因此,在磁盘上删除记录所需的时间被推迟,不会延迟索引过程。
  • 在重新索引时,Meilisearch 现在会检测文档的完全相同版本是否已存在,如果是,则不会再次索引它

行为变更:自动批处理

在 v0.26 中,我们引入了一个实验性功能:自动批处理。当激活时,自动批处理会自动将连续的文档添加请求组合在一起,从而显着提高索引速度。

我们很高兴地宣布自动批处理现在是默认的索引行为,不再是实验性功能  🥳

这意味着您不再需要使用 --enable-auto-batching CLI 标志来启用它。现在使用 --enable-auto-batching 将抛出以下错误

error: Found argument '--enable-auto-batching' which wasn't expected, or isn't valid in this context

	Did you mean '--disable-auto-batching'?

	If you tried to supply `--enable-auto-batching` as a value rather than a flag, use `-- --enable-auto-batching`

USAGE:
    meilisearch --disable-auto-batching

以下自动批处理自定义选项也已被删除,如果使用将抛出错误,因此请确保您的应用程序在升级到 v0.29 之前不使用任何这些选项

  • --debounce-duration-sec
  • --max-batch-size
  • --max-documents-per-batch

如果您尚未激活自动批处理功能,那么您无需做任何操作,只需享受提高的索引速度 🏎️。

🧐 您可能已在上面的错误消息中注意到:如果由于某种原因您不希望 Meilisearch 自动批处理请求,则可以使用一个新的 CLI 标志来停用此功能:--disable-auto-batching

👋
我们一直在不断改进我们的搜索引擎,您的反馈至关重要。如果您在文档索引速度方面遇到任何问题,我们非常感谢您在此 讨论 中告知我们。

改进:过滤器

我们添加了两个新的过滤器运算符:INEXISTS

  • IN 运算符选择其指定字段包含至少一个给定值的文档。
  • EXISTS 运算符检查字段是否存在。请注意,具有空值或空值的字段仍然被视为存在。

给定以下图书数据集

[
  { "id": 1, "title": "Pride and Prejudice", "genres": ["romance"] },
  { "id": 2, "title": "Le Petit Prince", "genres": [] },
  { "id": 3, "title": "Alice In Wonderland" },
  { "id": 4, "title": "The Hobbit", "genres": ["adventure", "fantasy"] },
  { "id": 5, "title": "A Game of Thrones", "genres": ["fantasy"] },
]

表达式 genres IN [fantasy, adventure] 将返回文档 45

表达式 genres EXISTS 将返回文档 1245

这两个运算符都可以与 NOT (!=) 运算符组合使用。

行为变更:!= (NOT) 过滤器运算符

!= (NOT) 过滤器运算符返回不满足条件的文档。

考虑以下文档

{ "id": 1, "product": "T-shirt", "price": 20 }
{ "id": 2, "product": "T-shirt" }
{ "id": 3, "product": "T-shirt", "price": 30 }

NOT price = 20 应返回所有价格属性不等于 20 的文档。

使用 v0.29,!= (NOT) 过滤器匹配缺少指定属性的文档。在上面的示例中,这意味着 Meilisearch 返回文档 23

在 v0.29 之前,Meilisearch 不会包含缺少 price 属性的结果。在上面的示例中,v0.28 将只返回文档 3

您可以确保过滤器仅返回包含指定属性的文档,方法是将 != (NOT) 运算符与新的 EXISTS 运算符组合使用:price EXISTS AND price != 20 将仅返回文档 3

改进:密钥管理

在管理 密钥 时,在 actions 数组中使用 * 通配符字符可以访问所有端点。

{
      "name": "Default Admin API Key",
      "description": "Use it for anything that is not a search operation. Caution! Do not expose it on a public frontend",
      "key": "380689dd379232519a54d15935750cc7625620a2ea2fc06907cb40ba5b421b6f",
      "uid": "20f7e4c4-612c-4dd1-b783-7934cc038213",
      "actions": ["*"],
      "indexes": ["*"],
      "expiresAt": null,
      "createdAt": "2021-08-11T10:00:00Z",
      "updatedAt": "2021-08-11T10:00:00Z"
 }

现在,感谢我们的贡献者,它还可以用作通配符来表达单个特定路由的所有端点 🙌。

您无需列出所有端点,只需将 * 字符附加到所需的路由即可。例如,documents.* 授权访问所有与文档相关的端点。

改进:泰语支持

我们亲爱的贡献者 @aFluffyHotdog 引入了对泰语的 优化支持 🥳。

我们一直在寻找方法来进一步改进 Meilisearch 的语言支持。我们从母语人士那里获得的 反馈 越多,我们越容易了解如何改进这些语言的性能和搜索相关性。

想帮助我们 支持您的语言 吗?贡献!如果您需要指导或帮助,请随时 联系我们;我们期待与您合作!

贡献者

没有我们社区的支持,Meilisearch 就不会像今天这样存在。你们真的很棒,我们对你们为 Meilisearch 付出的所有努力、建议、评论和时间表示衷心的感谢。本月,我们要特别感谢 @evpeople@Mcdostone@pavo-tusker@phdavis1027@ryanrussell@VasiliySoldatkinMeilisearch 的帮助,感谢 @GraDKhMilli 的帮助,感谢 @aFluffyHotdog@matthias-wright@mosuka 对我们的词法分析器 Charabia 的帮助。

好了,就这样!请记住查看 变更日志 以获取完整的发行说明,下次再见!