SpringBoot:Java High Level REST Client 搜索 API


Springboot整合最新版elasticSearch參考之前的文章:SpingBoot:整合ElasticSearch 7.2.0

Search API

SearchRequest用於與搜索文檔,聚合,建議有關的任何操作,還提供了在結果文檔上請求突出顯示的方法.

在最基本的形式中,我們可以向請求添加查詢:

 searchRequest = indexName==null?new SearchRequest():new SearchRequest(indexName);//創建SeachRequest . 沒有參數,這將針對所有索引運行.
        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();//大多數搜索參數都添加到SearchSourceBuilder . 它為搜索請求正文中的所有內容提供了setter.
        searchSourceBuilder.query(QueryBuilders.matchAllQuery());//將match_all查詢添加到SearchSourceBuilder .
        searchRequest.source(searchSourceBuilder);//將SearchSourceBuilder添加到SeachRequest .
        highLevelClient.search(searchRequest, RequestOptions.DEFAULT);

Optional arguments

我們先來看一下SearchRequest一些可選參數:

SearchRequest searchRequest = new SearchRequest("posts"); //將請求限制為索引

還有一些其他有趣的可選參數:

searchRequest.routing("routing"); // 設置路由參數

什么是 routing 參數?

當索引一個文檔的時候,文檔會被存儲在一個主分片上。在存儲時一般都會有多個主分片。Elasticsearch 如何知道一個文檔應該放置在哪個分片呢?這個過程是根據下面的這個公式來決定的:

shard = hash(routing) % number_of_primary_shards
  • routing 是一個可變值,默認是文檔的 _id ,也可以設置成一個自定義的值
  • number_of_primary_shards 是主分片數量

所有的文檔 API 都接受一個叫做 routing 的路由參數,通過這個參數我們可以自定義文檔到分片的映射。一個自定義的路由參數可以用來確保所有相關的文檔——例如所有屬於同一個用戶的文檔——都被存儲到同一個分片中。

searchRequest.indicesOptions(IndicesOptions.lenientExpandOpen()); // 設置`IndicesOptions`控制如何解析不可用的索引以及如何擴展通配符表達式 
searchRequest.preference("_local"); // 使用首選項參數例如執行搜索以優先選擇本地分片. 默認是跨分片隨機化. 

Using the SearchSourceBuilder

控制搜索行為的大多數選項都可以在SearchSourceBuilder上設置, SearchSourceBuilder包含與Rest API的搜索請求主體中的選項相當或更少的選項.

以下是一些常見選項的幾個示例:

SearchSourceBuilder sourceBuilder = new SearchSourceBuilder(); // 使用默認選項創建`SearchSourceBuilder`
QueryStringQueryBuilder queryStringQueryBuilder = QueryBuilders._queryStringQuery_("關鍵詞");//搜索關鍵字
sourceBuilder.query(QueryBuilders.termQuery("user", "kimchy")); // 設置查詢. 可以是任何類型的`QueryBuilder` 
sourceBuilder.from(0); // 設置確定結果索引的`from`選項以開始搜索. 默認為0\. 
sourceBuilder.size(5); // 設置`size`選項,確定要返回的搜索命中數. 默認為10\. 
sourceBuilder.timeout(new TimeValue(60, TimeUnit.SECONDS)); // 設置一個可選的超時,控制允許搜索的時間. 

在此之后,只需將SearchSourceBuilder添加到SearchRequest :

SearchRequest searchRequest = new SearchRequest();
searchRequest.indices("posts");
searchRequest.source(sourceBuilder);

官方文檔:https://www.elastic.co/guide/en/elasticsearch/client/java-rest/7.2/java-rest-high-search.html#java-rest-high-search

作者:onlooker
來源:三無青年博客
原文:https://www.35youth.cn/715.html
版權聲明:本文為博主原創文章,轉載請附上博文鏈接!


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM