Структура запроса и контексты

Дерево условий

Leaf query проверяет конкретное условие: term, range или match. Compound query объединяет другие запросы или меняет их оценку: bool, dis_max, constant_score. JSON описывает дерево, а не последовательность инструкций. Порядок элементов filter не задаёт гарантированный порядок выполнения: движок оптимизирует план самостоятельно.

Два вопроса к документу

Query context спрашивает, насколько хорошо документ подходит, и может вычислять _score. Filter context решает, проходит ли документ обязательное ограничение. Наличие, tenant_id и диапазон цены обычно относятся к ограничениям. Перенос match в filter не меняет его анализатор, но убирает его вклад в ранжирование. Это решение о смысле запроса, а не механическая оптимизация.

Постоянная оценка и кеш

match_all задаёт все документы, match_none — ни одного. constant_score оборачивает фильтр и выдаёт одинаковый вклад подходящим документам. Filter context делает некоторые результаты пригодными для кеширования, но кеш зависит от частоты использования, сегментов и внутренних политик. Нельзя обещать, что любой filter будет сохранён или что второй запрос обязательно быстрее.

{
  "query": {
    "constant_score": {
      "filter": {
        "term": {
          "brand": "Sony"
        }
      }
    }
  }
}

Разбор на примере каталога

Запрос «wireless» с ограничением price<100 содержит два разных решения. Совпадение name даёт основания сравнивать релевантность. Цена определяет допустимость покупки в бюджете, но товар за 20 не обязан быть более текстово релевантным, чем товар за 90. Поэтому match ставят в must, range — в filter. Если пользователь выбрал сортировку по цене, это уже отдельный контракт порядка. Перемещение всех условий в must может внести ненужные оценки и затруднить объяснение результатов.

Все товары

Корень тела поиска — JSON-объект. query задаёт условия совпадения. match_all с пустым объектом не ограничивает документы и удобен для знакомства с набором данных. size управляет числом возвращаемых документов, а не числом совпадений; sort делает небольшую демонстрацию воспроизводимой. В JSON нужны двойные кавычки, недопустимы комментарии и завершающая запятая.

hits.total.value показывает число совпавших документов; relation: eq означает точный подсчёт. hits.hits содержит возвращённую страницу. _id идентифицирует документ, _source содержит запрошенные исходные поля, _score — оценку релевантности. took измеряется в миллисекундах и меняется между запусками. Фрагменты ниже опускают took, сведения о шардах и индексе: это сокращение для чтения, а не отдельный формат ответа Elasticsearch.

{
  "query": {
    "match_all": {}
  },
  "size": 2,
  "_source": [
    "name",
    "price"
  ],
  "sort": [
    {
      "id": "asc"
    }
  ]
}

{
  "hits": {
    "total": {
      "value": 300,
      "relation": "eq"
    },
    "hits": [
      {
        "_id": "1",
        "_score": null,
        "_source": {
          "name": "Wireless",
          "price": 100
        }
      },
      {
        "_id": "2",
        "_score": null,
        "_source": {
          "name": "Reference device",
          "price": 100
        }
      }
    ]
  }
}

Фильтр без scoring

bool.filter требует выполнения каждого ограничения без добавления вклада в релевантность. Точный бренд, наличие и цена — подходящие примеры: товар не должен становиться релевантнее только из-за наличия. Если поисковых условий нет, bool только с filter обычно возвращает нулевую оценку.

Контекст распространяется на всю вложенную конструкцию. Вложенный bool с двумя фильтрами означает сгруппированное И. Сохраняйте читаемость и не создавайте уровни без необходимости. Elasticsearch может учитывать фильтры для кеширования, но корректность не должна зависеть от попадания в кеш или конкретного порядка исполнения.

{
  "query": {
    "bool": {
      "filter": [
        {
          "term": {
            "brand.keyword": "Sony"
          }
        },
        {
          "term": {
            "in_stock": false
          }
        },
        {
          "range": {
            "price": {
              "lt": 1200
            }
          }
        }
      ]
    }
  },
  "size": 2,
  "_source": [
    "name",
    "brand",
    "price",
    "in_stock"
  ],
  "sort": [
    {
      "id": "asc"
    }
  ]
}

{
  "hits": {
    "total": {
      "value": 40,
      "relation": "eq"
    },
    "hits": [
      {
        "_id": "3",
        "_score": null,
        "_source": {
          "name": "Sony Travel Speaker 3",
          "brand": "Sony",
          "price": 100,
          "in_stock": false
        }
      },
      {
        "_id": "15",
        "_score": null,
        "_source": {
          "name": "Sony USB Cable 15",
          "brand": "Sony",
          "price": 499,
          "in_stock": false
        }
      }
    ]
  }
}

Релевантность и фильтры

Прикладной поиск часто сочетает match с оценкой в must и ограничения наличия и цены в filter. Все условия обязательны, но только текст влияет на релевантность. Пример ищет gaming среди товаров в наличии дешевле 800.

Перенос текста в filter может сохранить набор совпадений, но убрать ранжирование по тексту. Перенос бизнес-условий в must может добавить вклад в оценку. Сохраняйте различие даже тогда, когда небольшая выборка выглядит одинаково.

{
  "query": {
    "bool": {
      "must": [
        {
          "match": {
            "name": "gaming"
          }
        }
      ],
      "filter": [
        {
          "term": {
            "in_stock": true
          }
        },
        {
          "range": {
            "price": {
              "lt": 800
            }
          }
        }
      ]
    }
  },
  "size": 2,
  "_source": [
    "name",
    "price",
    "in_stock"
  ]
}

{
  "hits": {
    "total": {
      "value": 20,
      "relation": "eq"
    },
    "hits": [
      {
        "_id": "4",
        "_score": 2.3304372,
        "_source": {
          "name": "Logitech Gaming Keyboard 4",
          "price": 199,
          "in_stock": true
        }
      },
      {
        "_id": "14",
        "_score": 2.3304372,
        "_source": {
          "name": "Samsung Gaming Keyboard 14",
          "price": 199,
          "in_stock": true
        }
      }
    ]
  }
}