文章目錄

• • 1. refresh 簡介
  • • 1. true或者空字符串
    • 2. wait_for
    • 3. false (the default)
  • 2.如何選擇設置

1. refresh 簡介

The Index, Update, Delete, and Bulk APIs 支持refresh操作。控制這些api對應的請求所做的更改對搜索可見。
refresh可以設置的值有

true或者空字符串。

wait_for

false

1. true或者空字符串

在操作發生后立即刷新相關的主要和副本分片（不是整個索引），以便更新的文檔立即顯示在搜索結果中。只有仔細思考和驗證才能設置以免導致性能不佳。

2. wait_for

這個設置為true的話，如果使用refresh的話，當前請求不會主動觸發refresh，而是等待系統index.refresh_interval 設置的后臺refresh之后才會返回請求。

Wait for the changes made by the request to be made visible by a refresh before replying. This doesn’t force an immediate refresh, rather, it waits for a refresh to happen. Elasticsearch automatically refreshes shards that have changed every index.refresh_interval which defaults to one second. That setting is dynamic. Calling the Refresh API or setting refresh to true on any of the APIs that support it will also cause a refresh, in turn causing already running requests with refresh=wait_for to return.

3. false (the default)

false也是默認值，不會進行refresh操作

2.如何選擇設置

除非你有一個很好的理由等待修改變得可見,不然的話就盡量使用refresh=false，因為這是默認值，URL不傳refresh即可。
如果你一定要讓所做的修改請求同步可見，那么您必須在對Elasticsearch（true）進行更多的負載與更長的等待響應（wait_for）之間進行選擇。這里有幾點應該告訴這個決定：

與設置為true相比，wait_for能讓索引做更多的變更工作，在這種情況下，每隔index.refresh_interval索引的修改只才會保存。

true將構造較小的有效的索引（微小段），以后必須將其合并到更有效的索引構造（較大的段）中。這意味著設置為true時，索引將花費時間在創建微小段上面，在搜索時從微小段進行搜索，并在合并時來制作較大段。

不要在一行中啟動多個refresh=wait_for請求。而是通過一個Bulk請求來使用refresh=wait_for，Elasticsearch將并行執行它們，并且只有當它們全部完成時才返回。

如果刷新間隔設置為-1，則禁用了自動刷新，則refresh=wait_for的請求將無限期地等待，直到某些其它操作導致刷新。相反，將index.refresh_interval設置為小于默認值譬如200ms，refresh=wait_for更快地恢復，但仍會生成低效的段。

refresh=wait_for僅影響其所在的請求，但是，通過強制立即刷新，refresh=true將影響其他正在進行的請求。一般來說，如果你有一個運行的系統，你不想打擾，那么refresh=wait_for是一個較小的修改。

下面的put操作會主動觸發refresh,以便于內容在后面的search中立即可見

PUT /test/_doc/1?refresh {"test": "test"} PUT /test/_doc/2?refresh=true {"test": "test"}

下面的操作并不保證其在后面的search中立即可見

PUT /test/_doc/3 {"test": "test"} PUT /test/_doc/4?refresh=false {"test": "test"}

下面的請求不會觸發refresh，但是會等待別的情況觸發refresh之后返回

PUT /test/_doc/4?refresh=wait_for {"test": "test"}

總結

以上是生活随笔為你收集整理的14.refresh操作的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。