Отображение поля в реальном времени

Поля в реальном времени обычно включают скрипт Painless, который каким-либо образом изменяет данные. Однако существуют случаи, когда вы можете определить поле в реальном времени без скрипта. Например, если вы хотите извлечь одно поле из _source без внесения изменений, вам не нужен скрипт. Вы можете просто создать поле в реальном времени без скрипта, например, day_of_week:

resp = client.indices.create(
    index="my-index-000001",
    mappings={
        "runtime": {
            "day_of_week": {
                "type": "keyword"
            }
        }
    },
)
print(resp)

response = client.indices.create(
  index: 'my-index-000001',
  body: {
    mappings: {
      runtime: {
        day_of_week: {
          type: 'keyword'
        }
      }
    }
  }
)
puts response

const response = await client.indices.create({
  index: "my-index-000001",
  mappings: {
    runtime: {
      day_of_week: {
        type: "keyword",
      },
    },
  },
});
console.log(response);

PUT my-index-000001/
{
  "mappings": {
    "runtime": {
      "day_of_week": {
        "type": "keyword"
      }
    }
  }
}

Если скрипт не указан, Elasticsearch неявно ищет в _source во время запроса поле с тем же именем, что и поле в реальном времени, и возвращает значение, если оно существует. Если поле с тем же именем не существует, ответ не содержит значений для этого поля в реальном времени.

В большинстве случаев извлекайте значения полей через doc_values всякий раз, когда это возможно. Доступ к doc_values с помощью поля в реальном времени быстрее, чем извлечение значений из _source из-за способа загрузки данных из Lucene.

Однако есть случаи, когда необходимо извлекать поля из _source. Например, поля text по умолчанию не имеют doc_values, поэтому вам нужно извлекать значения из _source. В других случаях вы можете отключить doc_values для определенного поля.

Скрипты могут генерировать ошибки во время выполнения, например, при обращении к отсутствующим или неверным значениям в документах или при выполнении недопустимых операций. Параметр on_script_error можно использовать для управления поведением при возникновении таких ошибок. Установка этого параметра в значение continue приведет к тому, что все ошибки этого поля в реальном времени будут молча игнорироваться. Значение параметра по умолчанию fail вызовет сбой фрагмента, о котором сообщается в ответ на поиск.

Поля в реальном времени можно обновлять или удалять в любое время. Чтобы заменить существующее поле в реальном времени, добавьте новое поле в реальном времени в отображения с тем же именем. Чтобы удалить поле в реальном времени из отображений, установите значение поля в реальном времени в null:

resp = client.indices.put_mapping(
    index="my-index-000001",
    runtime={
        "day_of_week": None
    },
)
print(resp)

response = client.indices.put_mapping(
  index: 'my-index-000001',
  body: {
    runtime: {
      day_of_week: nil
    }
  }
)
puts response

const response = await client.indices.putMapping({
  index: "my-index-000001",
  runtime: {
    day_of_week: null,
  },
});
console.log(response);

PUT my-index-000001/_mapping
{
 "runtime": {
   "day_of_week": null
 }
}