Skip to content
This repository

Multi match query #2153

martijnvg opened this Issue August 09, 2012 · 1 comment

2 participants

Martijn van Groningen Shay Banon
Martijn van Groningen

Multi match query

The multi_match query builds further on top of the match query by allowing multiple fields to be specified. The idea here is to allow to more easily build a concise match type query over multiple fields instead of using a relative more expressive query by using multiple match queries within a bool query.

The structure of the query is a bit different. Instead of a nested json object defining the query field, there is a top json level field for defining the query fields. Example:

  "multi_match" : {
    "query" : "this is a test",
    "fields" : [ "subject", "message" ]

The multi_match query creates ether a bool or a dis_maxtop level query. Each field is a query clause in this top level query. The query clause contains the actual query (the specified 'type' defines what query this will be). Each query clause is basically a should clause.


All options that apply on the match query also apply on the multi_match query. The 'match' query options apply only on the individual clauses inside the top level query.

  • fields - Fields to be used in the query.
  • use_dis_max - Boolean indicating to either create a dis_max query or a bool query. Defaults to true.
  • tie_breaker - Multiplier value to balance the scores between lower and higher scoring fields. Only applicable when use_dis_max is set to true. Defaults to 0.0.

The query accepts all the options that a regular match query accepts.

Shay Banon

Implemented in #2151.

Shay Banon kimchy closed this August 09, 2012
Martijn Laarman Mpdreamz referenced this issue in elasticsearch/elasticsearch-net April 01, 2013

How to "must" : [ { "match" { "foo" : "bar"} } ] #202

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.