2021年11月16日

v0.24 有哪些新功能

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

在这个新版本的 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 'http://localhost: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] 地址与我们联系，并追究我们的责任。