Запрос Match

Вы можете упростить синтаксис запроса соответствия, объединив параметры <field> и query. Например:

resp = client.search(
    query={
        "match": {
            "message": "this is a test"
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      match: {
        message: 'this is a test'
      }
    }
  }
)
puts response

res, err := es.Search(
	es.Search.WithBody(strings.NewReader(`{
	  "query": {
	    "match": {
	      "message": "this is a test"
	    }
	  }
	}`)),
	es.Search.WithPretty(),
)
fmt.Println(res, err)

const response = await client.search({
  query: {
    match: {
      message: "this is a test",
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "match": {
      "message": "this is a test"
    }
  }
}

Запрос match имеет тип boolean. Это означает, что предоставленный текст анализируется, и процесс анализа создаёт булеву конструкцию из предоставленного текста. Параметр operator можно установить в or или and для управления булевыми условиями (по умолчанию or). Минимальное количество необязательных should условий для соответствия можно задать с помощью параметра minimum_should_match.

Вот пример с параметром operator:

resp = client.search(
    query={
        "match": {
            "message": {
                "query": "this is a test",
                "operator": "and"
            }
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      match: {
        message: {
          query: 'this is a test',
          operator: 'and'
        }
      }
    }
  }
)
puts response

res, err := es.Search(
	es.Search.WithBody(strings.NewReader(`{
	  "query": {
	    "match": {
	      "message": {
	        "query": "this is a test",
	        "operator": "and"
	      }
	    }
	  }
	}`)),
	es.Search.WithPretty(),
)
fmt.Println(res, err)

const response = await client.search({
  query: {
    match: {
      message: {
        query: "this is a test",
        operator: "and",
      },
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "match": {
      "message": {
        "query": "this is a test",
        "operator": "and"
      }
    }
  }
}

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

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

fuzziness позволяет использовать неточное соответствие, основываясь на типе запрошенного поля. См. Неточность для разрешённых настроек.

В этом случае можно установить параметры prefix_length и max_expansions, чтобы управлять процессом неточности. Если опция неточности установлена, запрос будет использовать top_terms_blended_freqs_${max_expansions} в качестве метода переписывания переписывания запроса. Параметр fuzzy_rewrite позволяет управлять способом переписывания запроса.

Неточные транспозиции (ab → ba) разрешены по умолчанию, но могут быть отключены, установив fuzzy_transpositions в false.

resp = client.search(
    query={
        "match": {
            "message": {
                "query": "this is a testt",
                "fuzziness": "AUTO"
            }
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      match: {
        message: {
          query: 'this is a testt',
          fuzziness: 'AUTO'
        }
      }
    }
  }
)
puts response

res, err := es.Search(
	es.Search.WithBody(strings.NewReader(`{
	  "query": {
	    "match": {
	      "message": {
	        "query": "this is a testt",
	        "fuzziness": "AUTO"
	      }
	    }
	  }
	}`)),
	es.Search.WithPretty(),
)
fmt.Println(res, err)

const response = await client.search({
  query: {
    match: {
      message: {
        query: "this is a testt",
        fuzziness: "AUTO",
      },
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "match": {
      "message": {
        "query": "this is a testt",
        "fuzziness": "AUTO"
      }
    }
  }
}

Если используемый анализатор удаляет все токены в запросе, как фильтр stop, то по умолчанию не будет соответствовать ни одному документу. Чтобы изменить это, можно использовать опцию zero_terms_query, которая принимает значения none (по умолчанию) и all, что соответствует запросу match_all.

resp = client.search(
    query={
        "match": {
            "message": {
                "query": "to be or not to be",
                "operator": "and",
                "zero_terms_query": "all"
            }
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      match: {
        message: {
          query: 'to be or not to be',
          operator: 'and',
          zero_terms_query: 'all'
        }
      }
    }
  }
)
puts response

res, err := es.Search(
	es.Search.WithBody(strings.NewReader(`{
	  "query": {
	    "match": {
	      "message": {
	        "query": "to be or not to be",
	        "operator": "and",
	        "zero_terms_query": "all"
	      }
	    }
	  }
	}`)),
	es.Search.WithPretty(),
)
fmt.Println(res, err)

const response = await client.search({
  query: {
    match: {
      message: {
        query: "to be or not to be",
        operator: "and",
        zero_terms_query: "all",
      },
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "match": {
      "message": {
        "query": "to be or not to be",
        "operator": "and",
        "zero_terms_query": "all"
      }
    }
  }
}

Запрос match поддерживает расширение синонимов с несколькими терминами с помощью фильтра токенов synonym_graph. При использовании этого фильтра, парсер создаёт запрос фразы для каждого синонима с несколькими терминами. Например, следующий синоним: "ny, new york" создаст:

(ny OR ("new york"))

Также можно сопоставлять синонимы с несколькими терминами с помощью конъюнкций:

$params = [
    'body' => [
        'query' => [
            'match' => [
                'message' => [
                    'query' => 'ny city',
                    'auto_generate_synonyms_phrase_query' => false,
                ],
            ],
        ],
    ],
];
$response = $client->search($params);

resp = client.search(
    query={
        "match": {
            "message": {
                "query": "ny city",
                "auto_generate_synonyms_phrase_query": False
            }
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      match: {
        message: {
          query: 'ny city',
          auto_generate_synonyms_phrase_query: false
        }
      }
    }
  }
)
puts response

res, err := es.Search(
	es.Search.WithBody(strings.NewReader(`{
	  "query": {
	    "match": {
	      "message": {
	        "query": "ny city",
	        "auto_generate_synonyms_phrase_query": false
	      }
	    }
	  }
	}`)),
	es.Search.WithPretty(),
)
fmt.Println(res, err)

const response = await client.search({
  query: {
    match: {
      message: {
        query: "ny city",
        auto_generate_synonyms_phrase_query: false,
      },
    },
  },
});
console.log(response);

GET /_search
{
   "query": {
       "match" : {
           "message": {
               "query" : "ny city",
               "auto_generate_synonyms_phrase_query" : false
           }
       }
   }
}

Приведённый выше пример создаёт булев запрос:

(ny OR (new AND york)) city

который соответствует документам с термином ny или конъюнкцией new AND york. По умолчанию параметр auto_generate_synonyms_phrase_query устанавливается в true.