All Products
Search
Document Center

:field_match_ratio

Last Updated:Mar 03, 2023

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 statements to perform complex sorts.

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

field_match_ratio: Returns the ratio of the number of terms in a field that match a search query to the total number of terms in the field

1. Syntax

field_match_ratio(field_name,index_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.

  • index_name: optional. The name of the index that is created on the field specified by the field_name parameter.

3. Return value

The return value is of the FLOAT type. Valid values: 0 to 1.

4. Scenarios

Scenario 1

Use a fine sort expression to calculate the proximity of the title and body fields to a search query.

 field_match_ratio(title)*10 + field_match_ratio(body)

5. Usage notes

  • The field that you reference in the parameters of this function must be configured as an index field.

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

  • This feature function can be used to calculate the proximity of the title and body fields to a search query.