OpenSearch/docs/reference/query-dsl/script-query.asciidoc

[[query-dsl-script-query]]
== Script Query

A query allowing to define
<<modules-scripting,scripts>> as filters. For
example:

[source,js]
----------------------------------------------
"filtered" : {
    "query" : {
        ...
    }, 
    "filter" : {
        "script" : {
            "script" : "doc['num1'].value > 1"
        }
    }
}
----------------------------------------------

[float]
=== Custom Parameters

Scripts are compiled and cached for faster execution. If the same script
can be used, just with different parameters provider, it is preferable
to use the ability to pass parameters to the script itself, for example:

[source,js]
----------------------------------------------
"filtered" : {
    "query" : {
        ...
    }, 
    "filter" : {
        "script" : {
            "script" : "doc['num1'].value > param1"
            "params" : {
                "param1" : 5
            }
        }
    }
}
----------------------------------------------