Elasticsearch Minimum Should Match Example

Doc.md

Source : https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-minimum-should-match.html

Minimum Should Matchedit

The minimum_should_match parameter possible values:

Type	Example	Description
Integer	3	Indicates a fixed value regardless of the number of optional clauses.
Negative integer	-2	Indicates that the total number of optional clauses, minus this number should be mandatory.
Percentage	75%	Indicates that this percent of the total number of optional clauses are necessary. The number computed from the percentage is rounded down and used as the minimum.
Negative percentage	-25%	Indicates that this percent of the total number of optional clauses can be missing. The number computed from the percentage is rounded down, before being subtracted from the total to determine the minimum.
Combination	3<90%	A positive integer, followed by the less-than symbol, followed by any of the previously mentioned specifiers is a conditional specification. It indicates that if the number of optional clauses is equal to (or less than) the integer, they are all required, but if it’s greater than the integer, the specification applies. In this example: if there are 1 to 3 clauses they are all required, but for 4 or more clauses only 90% are required.
Multiple combinations	2<-25% 9<-3	Multiple conditional specifications can be separated by spaces, each one only being valid for numbers greater than the one before it. In this example: if there are 1 or 2 clauses both are required, if there are 3-9 clauses all but 25% are required, and if there are more than 9 clauses, all but three are required.

NOTE:

When dealing with percentages, negative values can be used to get different behavior in edge cases. 75% and -25% mean the same thing when dealing with 4 clauses, but when dealing with 5 clauses 75% means 3 are required, but -25% means 4 are required.

If the calculations based on the specification determine that no optional clauses are needed, the usual rules about BooleanQueries still apply at search time (a BooleanQuery containing no required clauses must still match at least one optional clause)

No matter what number the calculation arrives at, a value greater than the number of optional clauses, or a value less than 1 will never be used. (ie: no matter how low or how high the result of the calculation result is, the minimum number of required matches will never be lower than 1 or greater than the number of clauses.

queries.txt

PUT test_msm
{
  "settings": {
    "number_of_shards": 1,
    "number_of_replicas": 1
  },
  "mappings": {
    "test": {
      "properties": {
        "text": {
          "type": "text"
        }
      }
    }
  }
}

POST test_msm/test
{
  "text": "I have a dog"
}


POST test_msm/test
{
  "text": "I have a golden"
}

POST test_msm/test
{
  "text": "Dogs bark when they see other friends"
}

POST test_msm/test
{
  "text": "Sometimes dogs can bark to ask for food from their sitter."
}


POST test_msm/test
{
  "text": "My dogs are barking and they have lots of dog food."
}

GET test_msm/test/_search

# query içerisindeki terimlerden en az 2 tanesi ya da daha fazlası eşleşen sonuçları getir
GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"have golden but not bark",
        "minimum_should_match":"2"
      }
    }
  }
}

# query içerisindeki terimlerden en az 1 tanesi ya da daha fazlası eşleşen sonuçları getir
GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"have dogs",
        "minimum_should_match":"1"
      }
    }
  }
}

# query içerisindeki terimlerden en az 2 tanesi ya da daha fazlası eşleşen sonuçları getir
GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"have dog",
        "minimum_should_match":"2"
      }
    }
  }
}

# query içerisindeki terimlerden en az 1 tanesi ya da daha fazlası eşleşen sonuçları getir
GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"dogs food bark",
        "minimum_should_match":"1"
      }
    }
  }
}

# Bunda topalm terimlerin sayısından 3 azına kadarı eşleşenleri getir. 
# Aşağıdaki örnekte 3 terim olduğu için otomatik en az 1 terim olarak alınır. 
# 5 terim olsaydı 2 veya daha fazlası olacaktı.
GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"dogs food bark",
        "minimum_should_match":"-3"
      }
    }
  }
}

# query içerisindeki terimlerden en az 3 tanesi ya da daha fazlası eşleşen sonuçları getir
GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"dogs food bark",
        "minimum_should_match":"3"
      }
    }
  }
}


GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"dogs food bark",
        "minimum_should_match":"10%"
      }
    }
  }
}



GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"have dog"
      }
    }
  }
}


GET test_msm/test/_search
{
  "query": {
    "match": {
      "text": {
        "query":"have dog",
        "minimum_should_match":"-2"
      }
    }
  }
}

Makale için çok teşekkürler minimum should match kavramını tam anlayamamıştım bu yazı gerçkten çok yardımcı oldu.