2021 年 11 月 16 日

v0.24 版本的新功能

了解 MeiliSearch v0.24 中的一些重大更改

Gui MachiavelliMeilisearch 团队

在这个新版本的 Meilisearch 中，我们专注于改进错误处理程序和审查数据收集策略——但别担心，我们仍然设法挤入了一些生活质量更新。我们将在本文中介绍最重要的部分，但您可以在我们的 GitHub 发布页面上查看完整更新日志。

重大更改：改进的错误处理

我们对错误处理程序的改进首先是对字段和值的名称进行小的更改：errorCode、errorType 和 errorLink 已分别缩短为 code、type 和 link，并且 type 的三个可能值已缩短为 invalid_request、internal 和 auth。

  {
    "message": "authorization header is missing",
    "code": "missing_authorization_header",
    "type": "auth",
    "link": "https://docs.meilisearch.com/errors#missing_authorization_header"
  }

在相关的更改中，错误情况下的更新响应已更改。

{
    "status": "failed",
    "updateId": 1,
    // ...
    "error": {
	    "message": "Document `:documentId` not found.",
    	"code": "document_not_found",
    	"type": "invalid_request",
    	"link": "https://docs.meilisearch.com/errors#document_not_found"
    },
  }

错误字段现在位于嵌套的错误对象中，而不是直接位于主体中。

最重要的是，我们添加了新的错误代码，并更改了一些旧的错误代码，以使解决错误更快、更直观。请查看我们的发布更新日志以获取更详细的更新列表。

重大更改：`attributesToHighlight` 现在适用于数值

当您在查询中使用 attributesToHighlight 搜索参数时，返回的文档将包括一个 _formatted 对象，其中包含包裹在 <em> 标签中的匹配查询词。

从 v0.24 开始，attributesToHighlight 可与字符串和数值一起使用。这意味着 _formatted 内的数字将自动转换为字符串

curl 
  -X POST 'https://127.0.0.1:7700/indexes/games/search' 
  -H 'Content-Type: application/json' 
  --data-binary '{ "q": "101", "attributesToHighlight": ["id, title, description"] }'

{
  "id": 101,
  "title": " The Wonderful 101: Remastered",
  "description": "Lead an army of 101 Wonderful Ones from around the world in this Unite Action game!",
  "_formatted": {
      "id": "<em>101</em>",
      "title": " The Wonderful <em>101</em>: Remastered",
      "description": "Lead an army of <em>101</em> Wonderful Ones from around the world in this Unite Action game!"
  }
}

遥测页面更新

默认情况下，我们从所有未明确选择退出的 Meilisearch 实例收集使用数据。在几个版本之前，我们在我们的文档网站上添加了一篇文章，描述了我们为什么以及如何从 Meilisearch 实例收集使用数据。在 v0.24 中，我们扩展了该文章，以包括所有收集的数据点的详尽列表。

作为对数据透明度的重新承诺的一部分，我们还为用户制定了请求删除他们收集的数据的流程。只需发送邮件至 [email protected]，包括您的实例 UID，我们将从我们的记录中删除所有内容，无需任何疑问。

隐私是技术领域的一个难题，而且不乏公司因疏忽或因从不道德的数据收集行为中获利而屡次违反隐私。我们希望在即将发布的博客文章中更多地谈论这个问题，但重要的是要知道，我们认为就这些问题进行诚实和持续的沟通是确保您的数据安全并得到正确处理的唯一方法。如果您在任何时候觉得有什么不对劲或可疑，您可以使用 [email protected] 地址与我们联系并追究我们的责任。