› › ›

API обновления

Обновление делает недавно выполненные операции на одном или нескольких индексах доступными для поиска. Для потоков данных API выполняет операцию обновления на базовых индексах потока. Дополнительную информацию об операции обновления см. в поиске в режиме реального времени.

POST /my-index-000001/_refresh

Запрос

POST <target>/_refresh

GET <target>/_refresh

POST /_refresh

GET /_refresh

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

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

Описание

Используйте API обновления, чтобы явно сделать все операции, выполненные на одном или нескольких индексах с момента последнего обновления, доступными для поиска. Если запрос направлен на поток данных, он обновляет базовые индексы потока.

По умолчанию Elasticsearch периодически обновляет индексы каждую секунду, но только для индексов, которые получили один или несколько запросов на поиск за последние 30 секунд. Вы можете изменить этот интервал по умолчанию, используя параметр index.refresh_interval.

Запросы на обновление являются синхронными и не возвращают ответ, пока операция обновления не завершится.

Обновления ресурсоёмки. Чтобы обеспечить хорошую производительность кластера, рекомендуется дождаться периодического обновления Elasticsearch, а не выполнять явное обновление, когда это возможно.

Если ваш рабочий процесс приложения индексирует документы, а затем выполняет поиск для извлечения индексированного документа, мы рекомендуем использовать параметр запроса refresh=wait_for API индексирования.

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

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

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

allow_no_indices

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

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

expand_wildcards

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

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

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

ignore_unavailable

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

Примеры

Обновление нескольких потоков данных и индексов

POST /my-index-000001,my-index-000002/_refresh

Обновление всех потоков данных и индексов в кластере

POST /_refresh

© 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-refresh.html