NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.
Terms Set Query Usageedit
Returns any documents that match with at least one or more of the provided terms. The terms are not analyzed and thus must match exactly. The number of terms that must match varies per document and is either controlled by a minimum should match field or computed per document in a minimum should match script.
Be sure to read the Elasticsearch documentation on Terms Set query for more information.
Minimum should match with fieldedit
The field that controls the number of required terms that must match must be a number field
Fluent DSL exampleedit
q
.TermsSet(c => c
.Name("named_query")
.Boost(1.1)
.Field(p => p.Branches)
.Terms("master", "dev")
.MinimumShouldMatchField(p => p.RequiredBranches)
)
Object Initializer syntax exampleedit
new TermsSetQuery
{
Name = "named_query",
Boost = 1.1,
Field = Infer.Field<Project>(p => p.Branches),
Terms = new[] { "master", "dev" },
MinimumShouldMatchField = Infer.Field<Project>(p => p.RequiredBranches)
}
Example json output.
{
"terms_set": {
"branches": {
"_name": "named_query",
"boost": 1.1,
"terms": [
"master",
"dev"
],
"minimum_should_match_field": "requiredBranches"
}
}
}
Minimum should match with scriptedit
Scripts can also be used to control how many terms are required to match in a more dynamic way.
The params.num_terms parameter is available in the script to indicate the number of
terms that have been specified in the query.
Fluent DSL exampleedit
q
.TermsSet(c => c
.Name("named_query")
.Boost(1.1)
.Field(p => p.Branches)
.Terms("master", "dev")
.MinimumShouldMatchScript(s => s
.Source("Math.min(params.num_terms, doc['requiredBranches'].value)")
)
)
Object Initializer syntax exampleedit
new TermsSetQuery
{
Name = "named_query",
Boost = 1.1,
Field = Infer.Field<Project>(p => p.Branches),
Terms = new[] { "master", "dev" },
MinimumShouldMatchScript = new InlineScript("Math.min(params.num_terms, doc['requiredBranches'].value)")
}
Example json output.
{
"terms_set": {
"branches": {
"_name": "named_query",
"boost": 1.1,
"terms": [
"master",
"dev"
],
"minimum_should_match_script": {
"source": "Math.min(params.num_terms, doc['requiredBranches'].value)"
}
}
}
}