Запрос с строкой запроса

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

Поиск с подстановочными знаками может выполняться по отдельным терминам, используя ? для замены одного символа и * для замены нуля или более символов:

qu?ck bro*

Следует учитывать, что запросы с подстановочными знаками могут использовать огромное количество памяти и работать очень медленно — просто представьте, сколько терминов нужно запросить, чтобы соответствовать строке запроса "a* b* c*".

{
  "field": ""
}

{
  "field": null
}

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

Установив analyze_wildcard в значение true, запросы, заканчивающиеся на *, будут проанализированы, и на основе различных токенов будет построен булевый запрос, гарантирующий точное совпадение первых N-1 токенов и поиск по префиксу последнего токена.

Шаблоны регулярных выражений могут быть встроены в строку запроса, заключив их в обратные слэши ("/"):

name:/joh?n(ath[oa]n)/

Синтаксис поддерживаемых регулярных выражений описан в синтаксисе регулярных выражений.

/.*n/

Вы можете выполнить fuzzy запросы с использованием оператора ~:

quikc~ brwn~ foks~

Для этих запросов строка запроса нормализуется. Если они присутствуют, применяются только определённые фильтры из анализатора. Список применимых фильтров см. в Нормализаторах.

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

По умолчанию расстояние редактирования равно 2, но расстояние редактирования 1 должно быть достаточно, чтобы поймать 80% всех орфографических ошибок человека. Его можно указать следующим образом:

quikc~1

В то время как запрос по фразе (например, "john smith") ожидает все термины в точно таком же порядке, запрос по близости допускает, что указанные слова могут находиться дальше друг от друга или в другом порядке. Так же как запросы с неточностями могут указать максимальное расстояние редактирования для символов в слове, запрос по близости позволяет указать максимальное расстояние редактирования слов во фразе:

"fox quick"~5

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

Диапазоны могут быть указаны для полей даты, числовых или строковых полей. Включительно диапазоны задаются квадратными скобками [min TO max], а исключающие диапазоны — фигурными скобками {min TO max}.

Фигурные и квадратные скобки можно комбинировать:

Диапазоны с неограниченной стороной могут использовать следующий синтаксис:

age:>10
age:>=10
age:<10
age:<=10

age:(>=10 AND <20)
age:(+>=10 +<20)

Парсинг диапазонов в строках запросов может быть сложным и подвержен ошибкам. Гораздо надёжнее использовать явный range запрос.

Используйте оператор усиления ^, чтобы сделать один термин более релевантным, чем другой. Например, если мы хотим найти все документы о лисах, но особенно интересуемся быстрыми лисами:

quick^2 fox

Значение по умолчанию boost равно 1, но может быть любым положительным числом с плавающей точкой. Усиления от 0 до 1 уменьшают релевантность.

Усиления также могут применяться к фразам или группам:

"john smith"^2   (foo bar)^4

По умолчанию все термины являются необязательными, если хотя бы один термин совпадает. Поиск foo bar baz найдет любые документы, содержащие один или несколько из foo, bar или baz. Мы уже обсуждали default_operator выше, который позволяет принудительно сделать все термины обязательными, но также существуют булевы операторы, которые могут быть использованы в строке запроса для большего контроля.

Предпочтительными операторами являются + (этот термин должен присутствовать) и - (этот термин не должен присутствовать). Все остальные термины необязательны. Например, этот запрос:

quick brown +fox -news

указывает, что:

Обычные булевы операторы AND, OR и NOT (также записанные как &&, || и !) также поддерживаются, но будьте осторожны, поскольку они не учитывают обычные правила приоритета, поэтому скобки следует использовать всякий раз, когда несколько операторов используются вместе. Например, предыдущий запрос можно переписать как:

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

{
    "bool": {
        "must":     { "match": "fox"         },
        "should":   { "match": "quick brown" },
        "must_not": { "match": "news"        }
    }
}

Несколько терминов или предложений можно сгруппировать вместе в скобках, чтобы сформировать подзапросы:

(quick OR brown) AND fox

Группы могут быть использованы для нацеливания на определённое поле или для повышения результата подзапроса:

status:(active OR pending) title:(full text search)^2

Если вам нужно использовать любой из символов, которые работают как операторы в вашем запросе (а не как операторы), то их следует экранировать с помощью ведущей обратной косой черты. Например, чтобы найти (1+1)=2, вам нужно записать свой запрос как \(1\+1\)\=2. При использовании JSON для тела запроса требуются две предшествующие обратные косые черты (\\); обратная косая черта является зарезервированным символом экранирования в JSON-строках.

GET /my-index-000001/_search
{
  "query" : {
    "query_string" : {
      "query" : "kimchy\\!",
      "fields"  : ["user.id"]
    }
  }
}

Зарезервированные символы: + - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ /

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

Пробелы не рассматриваются как операторы.

Если строка запроса пуста или содержит только пробелы, запрос вернет пустой набор результатов.

Поиск query_string не возвращает вложенные документы. Для поиска вложенных документов используйте nested запрос.

Вы можете использовать параметр fields для выполнения поиска query_string по нескольким полям.

Идея запуска query_string запроса по нескольким полям заключается в расширении каждого поискового термина до логического ИЛИ, как показано ниже:

field1:query_term OR field2:query_term | ...

Например, следующий запрос

GET /_search
{
  "query": {
    "query_string": {
      "fields": [ "content", "name" ],
      "query": "this AND that"
    }
  }
}

соответствует тем же словам, что и

GET /_search
{
  "query": {
    "query_string": {
      "query": "(content:this OR name:this) AND (content:that OR name:that)"
    }
  }
}

Поскольку из отдельных поисковых терминов генерируется несколько запросов, их объединение автоматически выполняется с использованием dis_max запроса с tie_breaker. Например (name усиливается на 5 с помощью ^5 обозначения):

GET /_search
{
  "query": {
    "query_string" : {
      "fields" : ["content", "name^5"],
      "query" : "this AND that OR thus",
      "tie_breaker" : 0
    }
  }
}

Простые символы подстановки также могут использоваться для поиска «внутри» определённых внутренних элементов документа. Например, если у нас есть объект city с несколькими полями (или вложенный объект с полями), мы можем автоматически искать по всем полям «city»:

GET /_search
{
  "query": {
    "query_string" : {
      "fields" : ["city.*"],
      "query" : "this AND that OR thus"
    }
  }
}

Другой вариант — указать поиск с символами подстановки в строке запроса (правильно экранируя символ *), например: city.\*:something:

GET /_search
{
  "query": {
    "query_string" : {
      "query" : "city.\\*:(this AND that OR thus)"
    }
  }
}

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

GET /_search
{
  "query": {
    "query_string" : {
      "fields" : ["content", "name.*^5"],
      "query" : "this AND that OR thus"
    }
  }
}

При выполнении query_string запроса по нескольким полям поддерживаются следующие дополнительные параметры.