› › ›

API очистки кэша

Очищает кэши одного или нескольких индексов. Для потоков данных API очищает кэши базовых индексов потока.

POST /my-index-000001/_cache/clear

Запрос

POST /<target>/_cache/clear

POST /_cache/clear

Предварительные условия

Если включены функции безопасности Elasticsearch, у вас должны быть права доступа manage индекса для целевого потока данных, индекса или алиаса.

Параметры пути

<target>: (Необязательно, строка) Список потоков данных, индексов и алиасов, разделенных запятыми, используемых для ограничения запроса. Поддерживаются подстановочные знаки (*). Для обработки всех потоков данных и индексов опустите этот параметр или используйте * или _all.

Параметры запроса

allow_no_indices

(Необязательно, булево) Если false, запрос возвращает ошибку, если какое-либо подстановочное выражение, алиас индекса или _all значение обращается только к отсутствующим или закрытым индексам. Это поведение применяется даже если запрос обращается к другим открытым индексам. Например, запрос, обращенный к foo*,bar*, возвращает ошибку, если индекс начинается с foo, но ни один индекс не начинается с bar.

По умолчанию true.

expand_wildcards

(Необязательно, строка) Тип индекса, с которым могут совпадать подстановочные знаки. Если запрос может обрабатывать потоки данных, этот аргумент определяет, соответствуют ли подстановочные выражения скрытым потокам данных. Поддерживаются значения, разделенные запятыми, например, open,hidden. Допустимые значения:

all: Совпадение с любым потоком данных или индексом, включая скрытые потоки данных и индексы.
open: Совпадение с открытыми, нескрытыми индексами. Также совпадает с любым нескрытым потоком данных.
closed: Совпадение с закрытыми, нескрытыми индексами. Также совпадает с любым нескрытым потоком данных. Потоки данных не могут быть закрыты.
hidden: Совпадение со скрытыми потоками данных и скрытыми индексами. Должно сочетаться с open, closed или тем и другим.
none: Подстановочные знаки не принимаются.

По умолчанию open.

fielddata

(Необязательно, булево) Если true, очищает кэш полей.

Используйте параметр fields для очистки кэша только определенных полей.

fields

(Необязательно, строка) Список имен полей, разделенных запятыми, используемых для ограничения параметра fielddata.

По умолчанию все поля.

Этот параметр не поддерживает объекты или алиасы полей.

index

(Необязательно, строка) Список имен индексов, разделенных запятыми, используемых для ограничения запроса.

ignore_unavailable

(Необязательно, булево) Если false, запрос возвращает ошибку, если он обращается к отсутствующему или закрытому индексу. По умолчанию false.

query

(Необязательно, булево) Если true, очищает кэш запросов.

request

(Необязательно, булево) Если true, очищает кэш запросов.

Примеры

Очистка определенного кэша

По умолчанию API очистки кэша очищает все кэши. Вы можете очистить только определенные кэши, установив следующие параметры запроса в true:

fielddata
query
request

POST /my-index-000001/_cache/clear?fielddata=true  
POST /my-index-000001/_cache/clear?query=true      
POST /my-index-000001/_cache/clear?request=true

	Очищает только кэш полей
	Очищает только кэш запросов
	Очищает только кэш запросов

Очистка кэша определенных полей

Чтобы очистить только кэш определенных полей, используйте параметр запроса fields.

POST /my-index-000001/_cache/clear?fields=foo,bar

Очистить кэш для поля foo и bar

Очистка кэшей нескольких потоков данных и индексов

POST /my-index-000001,my-index-000002/_cache/clear

Очистка кэшей всех потоков данных и индексов

POST /_cache/clear

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/indices-clearcache.html