本文介绍了 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
。
改进:过滤器
我们添加了两个新的过滤器运算符:IN
和 EXISTS
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]
将返回文档 4
和 5
。
表达式 genres EXISTS
将返回文档 1
、2
、4
和 5
。
这两个运算符都可以与 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 返回文档 2
和 3
。
在 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 和 @VasiliySoldatkin 对 Meilisearch 的帮助,感谢 @GraDKh 对 Milli 的帮助,感谢 @aFluffyHotdog、@matthias-wright 和 @mosuka 对我们的词法分析器 Charabia 的帮助。
好了,就这样!请记住查看 变更日志 以获取完整的发行说明,下次再见!