Семейство типов данных Keyword

Семейство ключевых слов включает следующие типы полей:

Поля ключевых слов часто используются в сортировке, агрегациях и запросах на уровне терминов, таких как term.

Ниже приведен пример сопоставления для базового поля keyword:

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "tags": {
        "type":  "keyword"
      }
    }
  }
}

Следующие параметры принимаются полями keyword:

Постоянное ключевое слово — это специализация поля keyword в случае, если все документы в индексе имеют одинаковое значение.

PUT logs-debug
{
  "mappings": {
    "properties": {
      "@timestamp": {
        "type": "date"
      },
      "message": {
        "type": "text"
      },
      "level": {
        "type": "constant_keyword",
        "value": "debug"
      }
    }
  }
}

constant_keyword поддерживает те же запросы и агрегации, что и поля keyword, но использует тот факт, что все документы имеют одинаковое значение в индексе, чтобы выполнять запросы более эффективно.

Разрешается отправлять документы, не имеющие значения для поля, или имеющие значение, равное значению, настроенному в сопоставлениях. Два запроса индексирования ниже эквивалентны:

POST logs-debug/_doc
{
  "date": "2019-12-12",
  "message": "Starting up Elasticsearch",
  "level": "debug"
}

POST logs-debug/_doc
{
  "date": "2019-12-12",
  "message": "Starting up Elasticsearch"
}

Однако предоставление значения, отличного от значения, настроенного в сопоставлениях, запрещено.

Если значение value не указано в сопоставлениях, поле автоматически настраивается на основе значения, содержащегося в первом индексированном документе. Хотя это поведение может быть удобным, имейте в виду, что это означает, что один проблемный документ может привести к отклонению всех остальных документов, если в нем было неправильное значение.

Перед тем, как значение будет предоставлено (либо через сопоставления, либо из документа), запросы к полю не будут соответствовать никаким документам. Это включает в себя запросы exists.

value поля изменить после его задания нельзя.

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

Тип поля wildcard — специализированное поле типа keyword для неструктурированного машиногенерированного контента, который планируется искать с помощью запросов, подобных grep, wildcard и regexp. Тип wildcard оптимизирован для полей с большими значениями или высокой кардинальностью.

Внутренне поле wildcard индексирует всё значение поля с помощью ngrams и сохраняет полную строку. Индекс используется как грубый фильтр для сокращения количества значений, которые затем проверяются путём извлечения и проверки полных значений. Это поле особенно хорошо подходит для выполнения запросов, подобных grep, к строкам логов. Затраты на хранение обычно ниже, чем затраты на поля keyword, но скорость поиска точных совпадений по полным терминам медленнее. Если значения полей имеют много общих префиксов, таких как URL для одного веб-сайта, затраты на хранение для поля wildcard могут быть выше, чем для эквивалентного поля keyword.

Вы индексируете и ищете в поле wildcard следующим образом

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "my_wildcard": {
        "type": "wildcard"
      }
    }
  }
}

PUT my-index-000001/_doc/1
{
  "my_wildcard" : "This string can be quite lengthy"
}

GET my-index-000001/_search
{
  "query": {
    "wildcard": {
      "my_wildcard": {
        "value": "*quite*lengthy"
      }
    }
  }
}

Следующие параметры принимаются полями wildcard: