Тип поля Гистограмма

Поля histogram предназначены в первую очередь для использования с агрегациями. Чтобы сделать их более доступными для агрегаций, данные поля histogram хранятся в виде двоичных doc values и не индексируются. Их размер в байтах не превышает 13 * numValues, где numValues — длина предоставленных массивов.

Поскольку данные не индексируются, вы можете использовать поля histogram только для следующих агрегаций и запросов:

При использовании гистограммы как части агрегации точность результатов будет зависеть от того, как была построена гистограмма. Важно учитывать режим агрегации процентилей, который будет использоваться для её построения. Некоторые возможности включают:

Поле гистограммы «алгоритмически независимо» и не хранит данные, специфичные ни для T-Digest, ни для HDRHistogram. Хотя это означает, что поле теоретически можно агрегировать с помощью любого из алгоритмов, на практике пользователь должен выбрать один алгоритм и проиндексировать данные таким образом (например, центроиды для T-Digest или интервалы для HDRHistogram), чтобы обеспечить максимальную точность.

Следующий запрос API создания индекса создаёт новый индекс с двумя отображениями полей:

PUT my-index-000001
{
  "mappings" : {
    "properties" : {
      "my_histogram" : {
        "type" : "histogram"
      },
      "my_text" : {
        "type" : "keyword"
      }
    }
  }
}

Следующие запросы API индексирования хранят предварительно агрегированные значения для двух гистограмм: histogram_1 и histogram_2.

PUT my-index-000001/_doc/1
{
  "my_text" : "histogram_1",
  "my_histogram" : {
      "values" : [0.1, 0.2, 0.3, 0.4, 0.5], 
      "counts" : [3, 7, 23, 12, 6] 
   }
}

PUT my-index-000001/_doc/2
{
  "my_text" : "histogram_2",
  "my_histogram" : {
      "values" : [0.1, 0.25, 0.35, 0.4, 0.45, 0.5], 
      "counts" : [8, 17, 8, 7, 6, 2] 
   }
}