Inner hits · my-elasticsearch-cn

# Inner hits 父/子和嵌套功能允許返回在不同范圍內具有匹配的文檔。在父/子情況下，基于子文檔中的匹配返回父文檔，或者基于父文檔中的匹配返回子文檔。在嵌套的情況下，基于嵌套內部對象中的匹配返回文檔。在這兩種情況下，導致返回文檔的不同作用域中的實際匹配都被隱藏。在許多情況下，知道哪些內部嵌套對象（在嵌套的情況下）或子/父文檔（在父/子）的情況下導致返回某些信息是非常有用的。內部命中功能可用于此。此功能會在搜索響應中返回每個搜索匹配的附加嵌套匹配，導致搜索匹配在不同范圍內匹配。可以通過在嵌套，has_child或has_parent查詢和過濾器上定義inner_hits定義來使用內部命中。結構如下所示： | `"<query>"`?`: {` `"inner_hits"`?`: {` `<inner_hits_options>` `}` `}` | 如果在支持它的查詢上定義 inner_hits，則每個搜索命中將包含具有以下結構的 inner_hits json 對象： | `"hits"``: [` `{` `"_index"``: ...,` `"_type"``: ...,` `"_id"``: ...,` `"inner_hits"``: {` `"<inner_hits_name>"``: {` `"hits"``: {` `"total"``: ...,` `"hits"``: [` `{` `"_type"``: ...,` `"_id"``: ...,` `...` `},` `...` `]` `}` `}` `},` `...` `},` `...` `]` | ### Options 內部命中支持以下選項： | `from` | The offset from where the first hit to fetch for each?`inner_hits`?in the returned regular search hits. 從返回的常規搜索命中的每個 inner_hits 的第一個命中的獲取位置的偏移量。 | | `size` | 每個 inner_hits 返回的命中的最大數量。默認情況下，返回前三個命中匹配。 | | `sort` | 如何內部命中應該按inner_hits排序。默認情況下，匹配按分數排序。 | | `name` | 在響應中用于特定內部命中定義的名稱。在單個搜索請求中定義多個內部命中時非常有用。默認值取決于定義內部命中的查詢。對于 has_child 查詢和過濾器，這是子類型，對于 has_parent 查詢和過濾器，這是父類型和嵌套查詢，對于過濾器，這是嵌套路徑。 | 內部命中還支持以下每個文檔功能： * [Highlighting](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-highlighting.html "Highlighting") * [Explain](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-explain.html "Explain") * [Source filtering](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-source-filtering.html "Source filtering") * [Script fields](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-script-fields.html "Script Fields") * [Doc value fields](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-docvalue-fields.html "Doc value Fields") * [Include versions](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-version.html "Version") ### Nested inner hits 嵌套 inner_hits 可用于將嵌套內部對象包含為搜索匹配的內部匹配。下面的示例假設有一個使用名稱 comment 定義的嵌套對象字段： | `{` `"query"`?`: {` `"nested"`?`: {` `"path"`?`:?``"comments"``,` `"query"`?`: {` `"match"`?`: {``"comments.message"`?`:?``"[actual query]"``}` `},` `"inner_hits"`?`: {} ①` `}` `}` `}` | ①?嵌套查詢中的內部命中定義。沒有其他選項需要定義。一個可以從上述搜索請求生成的響應片段的示例： | `...` `"hits"``: {` `...` `"hits"``: [` `{` `"_index"``:?``"my-index"``,` `"_type"``:?``"question"``,` `"_id"``:?``"1"``,` `"_source"``: ...,` `"inner_hits"``: {` `"comments"``: { ①` `"hits"``: {` `"total"``: ...,` `"hits"``: [` `{` `"_nested"``: {` `"field"``:?``"comments"``,` `"offset"``:?``2` `},` `"_source"``: ...` `},` `...` `]` `}` `}` `}` `},` `...` | ①?搜索請求中的內部匹配定義中使用的名稱。可以通過名稱選項使用自定義鍵。在上面的例子中，_nested 元數據是至關重要的，因為它定義了這個內部命中來自什么內部嵌套對象。該字段定義嵌套命中來自的對象數組字段，以及相對于其在 _source 中的位置的偏移。由于排序和評分，命中對象在 inner_hits 中的實際位置通常不同于定義嵌套內部對象的位置。默認情況下，對于 inner_hits 中的命中對象也返回 _source ，但這可以更改。通過 _source 過濾功能部分源可以返回或禁用。如果存儲字段在嵌套級別上定義，則也可以通過字段特性返回。一個重要的缺省是在 inner_hits 內的 hits 中返回的 _source 是相對于 _nested 元數據。因此，在上面的示例中，僅對每個嵌套的匹配返回注釋部分，而不是包含注釋的頂級文檔的整個源。 ### Hierarchical levels of nested object fields and inner hits 如果映射具有多層次的層次化嵌套對象字段，則每個層次都可以通過點標記路徑訪問。例如，如果存在包含票據嵌套字段的注釋嵌套字段，并且應該直接使用根命中返回票，則可以定義以下路徑： | `{` `"query"`?`: {` `"nested"`?`: {` `"path"`?`:?``"comments.votes"``,` `"query"`?`: { ... },` `"inner_hits"`?`: {}` `}` `}` `}` | 此間接引用僅支持嵌套內部命中。 Parent/child inner hits 父/子inner_hits可以用于包括父或子以下示例假定在注釋類型中存在_parent字段映射： | `{` `"query"`?`: {` `"has_child"`?`: {` `"type"`?`:?``"comment"``,` `"query"`?`: {` `"match"`?`: {``"message"`?`:?``"[actual query]"``}` `},` `"inner_hits"`?`: {} ①` `}` `}` `}` | ① ?內部命中定義類似于嵌套示例。一個可以從上述搜索請求生成的響應片段的示例： | `...` `"hits"``: {` `...` `"hits"``: [` `{` `"_index"``:?``"my-index"``,` `"_type"``:?``"question"``,` `"_id"``:?``"1"``,` `"_source"``: ...,` `"inner_hits"``: {` `"comment"``: {` `"hits"``: {` `"total"``: ...,` `"hits"``: [` `{` `"_type"``:?``"comment"``,` `"_id"``:?``"5"``,` `"_source"``: ...` `},` `...` `]` `}` `}` `}` `},` `...` |