?refresh

API индексирования, обновления, удаления и Bulk поддерживают установку refresh для управления моментом, когда изменения, внесенные этим запросом, станут видимыми для поиска. Доступные значения:

Если у вас нет веских причин ждать, пока изменения станут видимыми, всегда используйте refresh=false (значение по умолчанию). Самый простой и быстрый способ — опустить параметр refresh из URL.

Если вам абсолютно необходимо, чтобы изменения, внесённые запросом, были видны синхронно с запросом, вы должны выбрать между увеличением нагрузки на Elasticsearch (true) и ожиданием более длительного ответа (wait_for). Вот несколько моментов, которые должны повлиять на это решение:

Если запрос refresh=wait_for приходит, когда уже index.max_refresh_listeners (по умолчанию 1000) запросов ожидают обновления на этом фрагменте, то этот запрос будет вести себя так, как будто у него было установлено значение refresh равное true: он принудительно вызовет обновление. Это поддерживает обещание, что при возвращении запроса refresh=wait_for его изменения будут видимы для поиска, одновременно предотвращая неконтролируемое использование ресурсов для заблокированных запросов. Если запрос принудительно вызвал обновление, потому что закончились слоты прослушивания, то его ответ будет содержать "forced_refresh": true.

Массовые запросы занимают только один слот на каждом фрагменте, который они затрагивают, независимо от того, сколько раз они изменяют фрагмент.

Эти запросы создадут документ и немедленно обновят индекс, чтобы он стал видимым:

resp = client.index(
    index="test",
    id="1",
    refresh=True,
    document={
        "test": "test"
    },
)
print(resp)

resp1 = client.index(
    index="test",
    id="2",
    refresh=True,
    document={
        "test": "test"
    },
)
print(resp1)

response = client.index(
  index: 'test',
  id: 1,
  refresh: true,
  body: {
    test: 'test'
  }
)
puts response

response = client.index(
  index: 'test',
  id: 2,
  refresh: true,
  body: {
    test: 'test'
  }
)
puts response

const response = await client.index({
  index: "test",
  id: 1,
  refresh: "true",
  document: {
    test: "test",
  },
});
console.log(response);

const response1 = await client.index({
  index: "test",
  id: 2,
  refresh: "true",
  document: {
    test: "test",
  },
});
console.log(response1);

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

Эти запросы создадут документ, не выполняя никаких действий, чтобы сделать его видимым для поиска:

resp = client.index(
    index="test",
    id="3",
    document={
        "test": "test"
    },
)
print(resp)

resp1 = client.index(
    index="test",
    id="4",
    refresh=False,
    document={
        "test": "test"
    },
)
print(resp1)

response = client.index(
  index: 'test',
  id: 3,
  body: {
    test: 'test'
  }
)
puts response

response = client.index(
  index: 'test',
  id: 4,
  refresh: false,
  body: {
    test: 'test'
  }
)
puts response

const response = await client.index({
  index: "test",
  id: 3,
  document: {
    test: "test",
  },
});
console.log(response);

const response1 = await client.index({
  index: "test",
  id: 4,
  refresh: "false",
  document: {
    test: "test",
  },
});
console.log(response1);

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

Этот запрос создаст документ и подождёт, пока он станет видимым для поиска:

resp = client.index(
    index="test",
    id="4",
    refresh="wait_for",
    document={
        "test": "test"
    },
)
print(resp)

response = client.index(
  index: 'test',
  id: 4,
  refresh: 'wait_for',
  body: {
    test: 'test'
  }
)
puts response

const response = await client.index({
  index: "test",
  id: 4,
  refresh: "wait_for",
  document: {
    test: "test",
  },
});
console.log(response);

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