Тип поля с выравниванием

Из-за сходства в способе индексирования значений поля flattened разделяют большую часть функциональности отображения и поиска с keyword полями.

В настоящее время поля выровненных объектов можно использовать со следующими типами запросов:

При запросе нельзя ссылаться на ключи полей с использованием подстановочных знаков, как в { "term": {"labels.time*": 1541457010}}. Обратите внимание, что все запросы, включая range, обрабатывают значения как строковые ключевые слова. Выделение не поддерживается для полей flattened.

Можно сортировать по полю выровненного объекта, а также выполнять простые агрегации типа «ключевое слово», такие как terms. Как и в случае с запросами, нет специальной поддержки чисел — все значения в JSON-объекте обрабатываются как ключевые слова. При сортировке это означает, что значения сравниваются лексикографически.

Поля выровненных объектов в настоящее время не могут храниться. Невозможно указать параметр store в отображении.

Значения полей и конкретные подполя можно получить с помощью параметра fields. Так как поле flattened отображает весь объект, потенциально содержащий множество подполей, как одно поле, ответ содержит неизменённую структуру из _source.

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

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "flattened_field": {
        "type": "flattened"
      }
    }
  }
}

PUT my-index-000001/_doc/1?refresh=true
{
  "flattened_field" : {
    "subfield" : "value"
  }
}

POST my-index-000001/_search
{
  "fields": ["flattened_field.subfield"],
  "_source": false
}

{
  "took": 2,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 1.0,
    "hits": [{
      "_index": "my-index-000001",
      "_type" : "_doc",
      "_id": "1",
      "_score": 1.0,
      "fields": {
        "flattened_field.subfield" : [ "value" ]
      }
    }]
  }
}

Вы также можете использовать скрипт Painless для получения значений из подполей выровненных полей. Вместо включения doc['<field_name>'].value в ваш скрипт Painless, используйте doc['<field_name>.<sub-field_name>'].value. Например, если у вас есть выровненное поле, называемое label, с подполем release, ваш скрипт Painless будет выглядеть так doc['labels.release'].value.

Например, предположим, что ваше отображение содержит два поля, одно из которых типа flattened:

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "title": {
        "type": "text"
      },
      "labels": {
        "type": "flattened"
      }
    }
  }
}

Проиндексируйте несколько документов, содержащих ваши сопоставленные поля. Поле labels имеет три подполя:

POST /my-index-000001/_bulk?refresh
{"index":{}}
{"title":"Something really urgent","labels":{"priority":"urgent","release":["v1.2.5","v1.3.0"],"timestamp":{"created":1541458026,"closed":1541457010}}}
{"index":{}}
{"title":"Somewhat less urgent","labels":{"priority":"high","release":["v1.3.0"],"timestamp":{"created":1541458026,"closed":1541457010}}}
{"index":{}}
{"title":"Not urgent","labels":{"priority":"low","release":["v1.2.0"],"timestamp":{"created":1541458026,"closed":1541457010}}}

Поскольку labels — это поле типа flattened, весь объект отображается как одно поле. Для получения значений из этого подполя в скрипте Painless используйте формат doc['<field_name>.<sub-field_name>'].value.

"script": {
  "source": """
    if (doc['labels.release'].value.equals('v1.3.0'))
    {emit(doc['labels.release'].value)}
    else{emit('Version mismatch')}
  """

Принимаются следующие параметры отображения: