/facet-search 路由允许您搜索分面值。分面搜索支持前缀搜索错字容忍。返回的命中按升序按字典顺序排序。
Meilisearch 不支持对数字进行分面搜索。将数字分面转换为字符串以使其可搜索。在内部,Meilisearch 将数字表示为float64。这意味着它们缺乏精度,并且可以用不同的方式表示,从而难以有效搜索分面值。
在给定分面中搜索分面值。
POST
/indexes/{index_uid}/facet-search
如果没有首先明确将属性添加到filterableAttributes 列表中,此端点将无法工作。在我们的专用指南中了解有关分面的更多信息。
Meilisearch 的分面搜索不支持多词分面,并且只考虑facetQuery中的第一个词。例如,搜索Jane将返回Jane Austen,但搜索Austen将不返回Jane Austen

请求体

名称类型默认值描述
facetName *字符串null要搜索值的刻面名称
facetQuery字符串null给定分面值的搜索查询。如果未指定facetQuery,Meilisearch 将返回搜索到的分面的所有分面值,限制为 100 个
q字符串""查询字符串
filter字符串*null按属性值筛选查询
matchingStrategy字符串"last"用于匹配文档中查询词的策略
attributesToSearchOn字符串数组null将搜索限制在指定的属性上
exhaustiveFacetCount布尔值false返回分面的详尽计数,直至maxTotalHits定义的限制

响应

名称类型描述
facetHits.value字符串facetQuery匹配的分面值
facetHits.count整数具有与value匹配的分面值的文档数量
facetQuery字符串原始的facetQuery
processingTimeMs数字查询处理时间

示例

curl \
  -X POST 'MEILISEARCH_URL/indexes/books/facet-search' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "facetQuery": "fiction",
    "facetName": "genres",
    "filter": "rating > 3"
  }'

响应:200 Ok

{
  "facetHits": [
    {
      "value": "fiction",
      "count": 7
    }
  ],
  "facetQuery": "fiction",
  "processingTimeMs": 0
}
© . This site is unofficial and not affiliated with Meilisearch.