› › ›

API многократных векторов терминов

Получает несколько векторов терминов в одном запросе.

POST /_mtermvectors
{
   "docs": [
      {
         "_index": "my-index-000001",
         "_id": "2",
         "term_statistics": true
      },
      {
         "_index": "my-index-000001",
         "_id": "1",
         "fields": [
            "message"
         ]
      }
   ]
}

Запрос

POST /_mtermvectors

POST /<index>/_mtermvectors

Предварительные условия

Если включены функции безопасности Elasticsearch, у вас должен быть read доступ к индексу для целевого индекса или псевдонима индекса.

Описание

Вы можете указать существующие документы по индексу и ID или предоставить искусственные документы в теле запроса. Вы можете указать индекс в теле запроса или в URI запроса.

Ответ содержит массив docs со всеми полученными векторами терминов. Каждый элемент имеет структуру, предоставляемую API векторов терминов.

Для получения дополнительной информации о содержащейся в ответе информации обратитесь к API векторов терминов.

Параметры пути

<index>: (Необязательно, строка) Имя индекса, содержащего документы.

Параметры запроса

fields

(Необязательно, строка) Список полей, разделяемых запятыми, или выражения с подстановкой для включения в статистику.

Используется в качестве списка по умолчанию, если не указан определённый список полей в параметрах completion_fields или fielddata_fields.

field_statistics

(Необязательно, логическое значение) Если true, в ответ включаются количество документов, сумма частот документов и сумма общих частот терминов. По умолчанию true.

<offsets>

(Необязательно, логическое значение) Если true, в ответ включаются смещения терминов. По умолчанию true.

payloads

(Необязательно, логическое значение) Если true, в ответ включаются данные терминов. По умолчанию true.

positions

(Необязательно, логическое значение) Если true, в ответ включаются позиции терминов. По умолчанию true.

preference

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

routing

(Необязательно, строка) Пользовательское значение, используемое для маршрутизации операций на определённый фрагмент.

realtime

(Необязательно, логическое значение) Если true, запрос выполняется в реальном времени, а не в режиме почти реального времени. По умолчанию true. См. Реальный время.

term_statistics

(Необязательно, логическое значение) Если true, в ответ включаются частота терминов и частота документов. По умолчанию false.

version

(Необязательно, логическое значение) Если true, возвращает версию документа в составе совпадения.

version_type

(Необязательно, перечисление) Специфический тип версии: external, external_gte.

Примеры

Если вы указываете индекс в URI запроса, индекс не нужно указывать для каждого документа в теле запроса:

POST /my-index-000001/_mtermvectors
{
   "docs": [
      {
         "_id": "2",
         "fields": [
            "message"
         ],
         "term_statistics": true
      },
      {
         "_id": "1"
      }
   ]
}

Если все запрошенные документы находятся в одном индексе и параметры одинаковые, вы можете использовать следующий упрощённый синтаксис:

POST /my-index-000001/_mtermvectors
{
  "ids": [ "1", "2" ],
  "parameters": {
    "fields": [
      "message"
    ],
    "term_statistics": true
  }
}

Искусственные документы

Вы также можете использовать mtermvectors для генерации векторов терминов для искусственных документов, предоставленных в теле запроса. Используемая схема определяется указанным _index.

POST /_mtermvectors
{
   "docs": [
      {
         "_index": "my-index-000001",
         "doc" : {
            "message" : "test test test"
         }
      },
      {
         "_index": "my-index-000001",
         "doc" : {
           "message" : "Another test ..."
         }
      }
   ]
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/docs-multi-termvectors.html