› › ›

Запрос Regex

Возвращает документы, содержащие термины, соответствующие регулярному выражению.

Регулярное выражение — это способ сопоставления шаблонов в данных с использованием символов-заменителей, называемых операторами. Список операторов, поддерживаемых запросом regexp, см. в разделе Синтаксис регулярных выражений.

Пример запроса

Следующий запрос возвращает документы, где поле user.id содержит любой термин, начинающийся с k и заканчивающийся на y. Операторы .* соответствуют любому количеству символов, включая отсутствие символов. Соответствующие термины могут включать ky, kay и kimchy.

GET /_search
{
  "query": {
    "regexp": {
      "user.id": {
        "value": "k.*y",
        "flags": "ALL",
        "case_insensitive": true,
        "max_determinized_states": 10000,
        "rewrite": "constant_score"
      }
    }
  }
}

Параметры верхнего уровня для запроса `regexp`

<field>: (Обязательно, объект) Поле, которое вы хотите найти.

Параметры для запроса `<field>`

value

(Обязательно, строка) Регулярное выражение для терминов, которые вы хотите найти в предоставленном поле <field>. Список поддерживаемых операторов см. в разделе Синтаксис регулярных выражений.

По умолчанию регулярные выражения ограничены 1000 символами. Вы можете изменить это ограничение, используя параметр index.max_regex_length.

Производительность запроса regexp может варьироваться в зависимости от предоставленного регулярного выражения. Для повышения производительности избегайте использования подстановочных символов, таких как .* или .*?+, без префикса или суффикса.

flags

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

case_insensitive [7.10.0] Добавлен в 7.10.0.

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

max_determinized_states

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

Elasticsearch использует Apache Lucene для анализа регулярных выражений. Lucene преобразует каждое регулярное выражение в конечный автомат, содержащий определенное количество детерминированных состояний.

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

rewrite

(Необязательно, строка) Метод переписывания запроса. Допустимые значения и дополнительную информацию см. в rewrite параметр.

Примечания

Разрешение выполнения ресурсоемких запросов

Запросы Regex не будут выполнены, если search.allow_expensive_queries установлен в false.

© 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/query-dsl-regexp-query.html