Tablestore：摘要與高亮

前提條件

安裝Tablestore Java SDK並初始化用戶端。

功能說明

摘要與高亮用於從查詢結果中提取命中詞條附近的文本片段，並使用前置標籤和後置標籤標記命中詞條，便於展示命中上下文。該功能僅支援 Text 類型欄位。

使用摘要與高亮前，需要在建立多元索引時將目標欄位的 enableHighlighting 設定為 true。查詢時，通過 SearchQuery.highlight 指定要返回摘要與高亮結果的欄位及分區配置。目標欄位必須參與支援摘要與高亮的查詢條件，否則不會返回該欄位的高亮分區。

支援摘要與高亮的查詢類型包括 TermQuery、TermsQuery、MatchQuery、MatchPhraseQuery、PrefixQuery、WildcardQuery、RangeQuery、BoolQuery、ConstScoreQuery 和 NestedQuery。

使用 BoolQuery 或 ConstScoreQuery 時，可為上述七種查詢類型的子查詢所使用的欄位配置摘要與高亮。使用 NestedQuery 查詢巢狀型別欄位時，需要通過 InnerHits.highlight 配置匹配子行的摘要與高亮，具體操作請參見巢狀型別查詢。

以下樣本使用匹配查詢檢索 description 欄位中包含 tablestore 詞條的資料，並使用 <b> 和 </b> 標記返回分區中的命中詞條。description 欄位為已啟用摘要與高亮的 Text 欄位。

String tableName = "example_table";
String indexName = "example_index";

MatchQuery matchQuery = new MatchQuery();
matchQuery.setFieldName("description");
matchQuery.setText("tablestore");

HighlightParameter highlightParameter = new HighlightParameter();
highlightParameter.setPreTag("<b>");
highlightParameter.setPostTag("</b>");

Highlight highlight = new Highlight();
highlight.addFieldHighlightParam("description", highlightParameter);

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(matchQuery);
searchQuery.setHighlight(highlight);
searchQuery.setLimit(10);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchResponse response = client.search(request);
for (SearchHit hit : response.getSearchHits()) {
    HighlightResultItem resultItem = hit.getHighlightResultItem();
    if (resultItem == null) {
        continue;
    }
    HighlightField field = resultItem.getHighlightFieldByName("description");
    if (field != null) {
        System.out.println(field.getFragments());
    }
}

參數說明

request.searchQuery.highlight 的類型為 Highlight。其中，fieldHighlightParams 的值為 HighlightParameter，用於配置每個欄位的分區行為。

下表使用完整參數路徑說明 Highlight 和 HighlightParameter 兩層配置。

傳回值