All Products
Search
Document Center

:query_term_match_count

Last Updated:Sep 09, 2021

Feature functions

You can use feature functions in sort expressions. Most feature functions can be used only in fine sort expressions. You can combine various syntax and clauses to perform complex sorts.

The fields that you reference in parameters of feature functions must be configured as index or attribute fields based on the description of each function.

query_term_match_count: returns the number of terms in the search query that are hit in a specific field in documents

1.Syntax:

query_term_match_count(field_name)

2.Parameters:

field_name: the name of the field for which you want to collect statistics. The field must be of the TEXT or SHORT_TEXT type. The analyzer can be the general analyzer for Chinese, a custom analyzer, the single character analyzer for Chinese, an analyzer for English, or the fuzzy analyzer. This parameter is optional. If you do not specify this parameter, the number of terms that are hit in all fields in documents is returned by default.

3.Return value:

int

4.Scenarios:

Scenario 1: Conduct custom processing based on the number of terms in the search query that are hit in the title field in documents. Example: if (query_term_match_count(title) > 10, 0.5, 1).

Scenario 2: Conduct custom processing based on the number of terms in the search query that are hit in all fields in documents. Example: if (query_term_match_count() > 10, 0.5, 1).

5.Usage notes:

  • The field that you reference in the parameter of the function must be configured as an attribute field.

  • You can use this feature function in fine sort expressions.

  • All terms in the search query that are hit in documents are counted. Repeated terms are counted each time they are hit.