O parâmetro minimum_should_match
deve ser usado em conjunto com cláusulas opcionais do tipo should
. Quando minimum_should_match=1
um item só será retornado pela consulta se ao menos uma das cláusulas should
for verdadeira.
A sua consulta não possui cláusulas should
. Ela possui apenas uma cláusula must
. Por definição, quando você usa must
, todos os itens retornados devem satisfazer a condição da cláusula. Logo, a sua query com must
já filtra pelo campo TermoBusca
em 100% dos casos (o uso de minimum_should_match
não é necessário).
Em versões antigas do Elasticsearch (antes da versão 5), na ausência de cláusulas should
o parâmetro minimum_should_match
era ignorado. Esse comportamento mudou e em versões modernas do Elasticsearch. Hoje em dia uma query com minimum_should_match
maior que o número de cláusulas should
não retorna nenhum item.
Essa mudança impactou alguns sistemas que construíam cláusulas should
dinamicamente.
Eu tive que lidar com esse problema no passado após uma atualização do Elasticsearch ter quebrado a funcionalidade de busca de um sistema. No caso, quando nenhum filtro opcional era especificado as buscas pararam de retornar resultados. A solução foi modificar a lógica que construía a busca para apenas incluir o parâmetro minimum_should_match
quando a quantidade de cláusulas should
for maior do que 1.
Mais detalhes sobre esse problema podem ser encontradas no seguinte issue do GitHub (em inglês):