Запрос Span term

Запрос span_term является самым базовым запросом span, который соответствует диапазонам, содержащим один термин.

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

Например, вы можете использовать запрос span_term для:

  • Поиска точных совпадений термина, которые могут быть использованы в других запросах span.
  • Совпадения конкретных слов с сохранением информации о позиции.
  • Создания базовых диапазонов, которые могут быть объединены с другими запросами span.

Пример

Чтобы попробовать примеры в этом разделе, выполните шаги по настройке.

Следующий запрос ищет точный термин “formal”:

GET /clothing/_search
{
  "query": {
    "span_term": {
      "description": "formal"
    }
  }
}

В качестве альтернативы вы можете указать искомый термин в параметре value:

GET /clothing/_search
{
  "query": {
    "span_term": {
      "description": {
        "value": "formal"
      }
    }
  }
}

Вы также можете указать значение boost, чтобы увеличить оценку документа:

GET /clothing/_search
{
  "query": {
    "span_term": {
      "description": {
        "value": "formal",
        "boost": 2
      }
    }
  }
}

Запрос соответствует документам 1 и 2, потому что они содержат точный термин “formal”. Информация о позиции сохраняется для использования в других запросах span.

Ответ

{
  "took": 2,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 2,
      "relation": "eq"
    },
    "max_score": 1.498922,
    "hits": [
      {
        "_index": "clothing",
        "_id": "2",
        "_score": 1.498922,
        "_source": {
          "description": "Beautiful long dress in red silk, perfect for formal events."
        }
      },
      {
        "_index": "clothing",
        "_id": "1",
        "_score": 1.4466847,
        "_source": {
          "description": "Long-sleeved dress shirt with a formal collar and button cuffs. "
        }
      }
    ]
  }
}

Параметры

Следующая таблица перечисляет все параметры верхнего уровня, поддерживаемые запросами span_term.

Параметр Тип данных Описание
Строка или объект Имя поля, в котором нужно выполнить поиск.