文章目錄

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

1. refresh 簡介

The Index, Update, Delete, and Bulk APIs 支持refresh操作。控制這些api對(duì)應(yīng)的請(qǐng)求所做的更改對(duì)搜索可見。
refresh可以設(shè)置的值有

true或者空字符串。

wait_for

false

1. true或者空字符串

在操作發(fā)生后立即刷新相關(guān)的主要和副本分片（不是整個(gè)索引），以便更新的文檔立即顯示在搜索結(jié)果中。只有仔細(xì)思考和驗(yàn)證才能設(shè)置以免導(dǎo)致性能不佳。

2. wait_for

這個(gè)設(shè)置為true的話，如果使用refresh的話，當(dāng)前請(qǐng)求不會(huì)主動(dòng)觸發(fā)refresh，而是等待系統(tǒng)index.refresh_interval 設(shè)置的后臺(tái)refresh之后才會(huì)返回請(qǐng)求。

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也是默認(rèn)值，不會(huì)進(jìn)行refresh操作

2.如何選擇設(shè)置

除非你有一個(gè)很好的理由等待修改變得可見,不然的話就盡量使用refresh=false，因?yàn)檫@是默認(rèn)值，URL不傳refresh即可。
如果你一定要讓所做的修改請(qǐng)求同步可見，那么您必須在對(duì)Elasticsearch（true）進(jìn)行更多的負(fù)載與更長的等待響應(yīng)（wait_for）之間進(jìn)行選擇。這里有幾點(diǎn)應(yīng)該告訴這個(gè)決定：

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

true將構(gòu)造較小的有效的索引（微小段），以后必須將其合并到更有效的索引構(gòu)造（較大的段）中。這意味著設(shè)置為true時(shí)，索引將花費(fèi)時(shí)間在創(chuàng)建微小段上面，在搜索時(shí)從微小段進(jìn)行搜索，并在合并時(shí)來制作較大段。

不要在一行中啟動(dòng)多個(gè)refresh=wait_for請(qǐng)求。而是通過一個(gè)Bulk請(qǐng)求來使用refresh=wait_for，Elasticsearch將并行執(zhí)行它們，并且只有當(dāng)它們?nèi)客瓿蓵r(shí)才返回。

如果刷新間隔設(shè)置為-1，則禁用了自動(dòng)刷新，則refresh=wait_for的請(qǐng)求將無限期地等待，直到某些其它操作導(dǎo)致刷新。相反，將index.refresh_interval設(shè)置為小于默認(rèn)值譬如200ms，refresh=wait_for更快地恢復(fù)，但仍會(huì)生成低效的段。

refresh=wait_for僅影響其所在的請(qǐng)求，但是，通過強(qiáng)制立即刷新，refresh=true將影響其他正在進(jìn)行的請(qǐng)求。一般來說，如果你有一個(gè)運(yùn)行的系統(tǒng)，你不想打擾，那么refresh=wait_for是一個(gè)較小的修改。

下面的put操作會(huì)主動(dòng)觸發(fā)refresh,以便于內(nèi)容在后面的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"}

下面的請(qǐng)求不會(huì)觸發(fā)refresh，但是會(huì)等待別的情況觸發(fā)refresh之后返回

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

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。