# Shard request cache(分片請求緩存) 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/shard-request-cache.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/shard-request-cache.html) 譯文鏈接 : [Shard request cache(分片請求緩存)](/pages/viewpage.action?pageId=9406785) 貢獻者 : [趙芳城](/display/~zhaofangcheng) 當搜索的請求運行在單個或者多個索引上時，每個涉及的分片在本地執行搜索并將其本地結果返回給協調節點，該協調節點將這些分片級結果合并為“全局”結果集。 分片級請求緩存模塊將本地結果緩存在每個分片上。 這允許經常使用（并且可能很重）的搜索請求幾乎立即返回結果。 請求緩存非常適合日志記錄用例，其中只有最近的索引正在被更新 - 較舊索引的結果將直接從緩存提供。 默認情況下，request cache（請求緩存）只會緩存size =0（結果為空）的的請求，它并不會緩存命中結果，但是他會緩存命中總數, [aggregations](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/search-aggregations.html), and [suggestions](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/search-suggesters.html). 大多數現在用到的查詢都不會緩存 (請參考 “[Date Mathedit](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/common-options.html#date-math)”章節) . ## cache?invalidation（緩存失效） 緩存的機制是智能，他保證了及時未被緩存的索引也能在被接近實時（NRT）的搜索出來。 當分片中的數據確實已經發生改變的情況下， 緩存結果才會根據分片的刷新自動失效。換言之, 當你請求未被緩存的索引時，總會得到相同的結果。 越長時間的刷新間隔，則緩存就被越長時間的保留，當緩存滿了，最近未被使用的緩存將被驅除 緩存可以通過[`clear-cache`?API](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-clearcache.html "Clear Cache")來配置過期時間： ``` POST /kimchy,elasticsearch/_cache/clear?request_cache=true ``` ## Enabling and disabling caching（啟用和停用緩存） 緩存默認是啟用狀態，你可以在創建索引的時候通過以下方式停用緩存: ``` PUT /my_index { "settings": { "index.requests.cache.enable": false } } ``` 緩存也可以通過?[`update-settings`](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-update-settings.html "Update Indices Settings")?API，動態的對已有的緩存進行啟用和停用: ``` PUT /my_index/_settings { "index.requests.cache.enable": true } ``` ## Enabling and disabling caching per request(每個請求的緩存啟用和停用) 可以在請求時通過請求參數`request_cache`來為每個請求啟動和關閉緩存，如果是用了此參數，他將會覆蓋index-level配置： ``` GET /my_index/_search?request_cache=true { "size": 0, "aggs": { "popular_colors": { "terms": { "field": "colors" } } } } ``` 注意 如果您的查詢使用腳本，其結果是不確定的（例如，它使用一個隨機函數或引用當前的時間）你需要將request_cache設置為false，來禁用該請求的緩存 請求size大于0 的時候不會緩存，即使request cache已經設置為啟用。你可以在請求中詳細列的出來參數來緩存你的請求。 ## Cache key（緩存key） JSON整體被用作緩存key。這就意味著如果JSON發生變化 例如，如果key的排序發生了變化 - 那么緩存key將不被認可。 提示 大多數JSON庫都支持規范模式，以確保JSON密鑰始終以相同的順序排列。 該規范模式可以在應用程序中使用，以確保請求始終以相同的方式序列化。 ## Cache settings（緩存配置） 緩存在節點級別進行管理，并且默認最大大小為heap（堆）的1％。 在config / elasticsearch.yml文件中更改： ``` indices.requests.cache.size: 2% ``` 此外，您可以使用indices.requests.cache.expire設置為緩存有效時間，這樣做多此一舉。 因為當索引被刷新時，老舊的結果將自動失效，此設置僅供參考。 ## Monitoring cache usage（監控緩存使用） ?緩存大小和緩存被驅逐次數可以通過索引查看，?緩存的大小單位：?bytes（字節）`[indices-stats](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-stats.html "Indices Stats")?`API：? ``` GET /_stats/request_cache?human ``` ?node（節點）與`[nodes-stats](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/cluster-nodes-stats.html "Nodes Stats")?`API：? ``` GET /_nodes/stats/indices/request_cache?human ```