{
  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do not edit it. See ../README.md for how to regenerate it.",
  "type" : "scalar",
  "name" : "qstr",
  "description" : "Performs a query string query. Returns true if the provided query string matches the row.",
  "signatures" : [
    {
      "params" : [
        {
          "name" : "query",
          "type" : "keyword",
          "optional" : false,
          "description" : "Query string in Lucene query string format."
        },
        {
          "name" : "options",
          "type" : "function_named_parameters",
          "mapParams" : "{name='max_determinized_states', values=[10000], description='Maximum number of automaton states required for the query. Default is 10000.', type=[integer]}, {name='fuzziness', values=[AUTO, 1, 2], description='Maximum edit distance allowed for matching.', type=[keyword]}, {name='auto_generate_synonyms_phrase_query', values=[true, false], description='If true, match phrase queries are automatically created for multi-term synonyms. Defaults to true.', type=[boolean]}, {name='phrase_slop', values=[0], description='Maximum number of positions allowed between matching tokens for phrases. Defaults to 0 (which means exact matches are required).', type=[integer]}, {name='default_field', values=[standard], description='Default field to search if no field is provided in the query string. Supports wildcards (*).', type=[keyword]}, {name='allow_leading_wildcard', values=[true, false], description='If true, the wildcard characters * and ? are allowed as the first character of the query string. Defaults to true.', type=[boolean]}, {name='minimum_should_match', values=[standard], description='Minimum number of clauses that must match for a document to be returned.', type=[string]}, {name='fuzzy_transpositions', values=[true, false], description='If true, edits for fuzzy matching include transpositions of two adjacent characters (ab → ba). Defaults to true.', type=[boolean]}, {name='fuzzy_prefix_length', values=[0], description='Number of beginning characters left unchanged for fuzzy matching. Defaults to 0.', type=[integer]}, {name='time_zone', values=[standard], description='Coordinated Universal Time (UTC) offset or IANA time zone used to convert date values in the query string to UTC.', type=[keyword]}, {name='lenient', values=[true, false], description='If false, format-based errors, such as providing a text query value for a numeric field, are returned. Defaults to false.', type=[boolean]}, {name='rewrite', values=[standard], description='Method used to rewrite the query.', type=[keyword]}, {name='default_operator', values=[OR, AND], description='Default boolean logic used to interpret text in the query string if no operators are specified.', type=[keyword]}, {name='analyzer', values=[standard], description='Analyzer used to convert the text in the query value into token. Defaults to the index-time analyzer mapped for the default_field.', type=[keyword]}, {name='fuzzy_max_expansions', values=[50], description='Maximum number of terms to which the query expands for fuzzy matching. Defaults to 50.', type=[integer]}, {name='quote_analyzer', values=[standard], description='Analyzer used to convert quoted text in the query string into tokens. Defaults to the search_quote_analyzer mapped for the default_field.', type=[keyword]}, {name='allow_wildcard', values=[false, true], description='If true, the query attempts to analyze wildcard terms in the query string. Defaults to false.', type=[boolean]}, {name='boost', values=[2.5], description='Floating point number used to decrease or increase the relevance scores of the query.', type=[float]}, {name='quote_field_suffix', values=[standard], description='Suffix appended to quoted text in the query string.', type=[keyword]}, {name='enable_position_increments', values=[true, false], description='If true, enable position increments in queries constructed from a query_string search. Defaults to true.', type=[boolean]}, {name='fields', values=[standard], description='Array of fields to search. Supports wildcards (*).', type=[keyword]}",
          "optional" : true,
          "description" : "(Optional) Additional options for Query String as <<esql-function-named-params,function named parameters>>. See <<query-dsl-query-string-query,query string query>> for more information."
        }
      ],
      "variadic" : false,
      "returnType" : "boolean"
    },
    {
      "params" : [
        {
          "name" : "query",
          "type" : "text",
          "optional" : false,
          "description" : "Query string in Lucene query string format."
        },
        {
          "name" : "options",
          "type" : "function_named_parameters",
          "mapParams" : "{name='max_determinized_states', values=[10000], description='Maximum number of automaton states required for the query. Default is 10000.', type=[integer]}, {name='fuzziness', values=[AUTO, 1, 2], description='Maximum edit distance allowed for matching.', type=[keyword]}, {name='auto_generate_synonyms_phrase_query', values=[true, false], description='If true, match phrase queries are automatically created for multi-term synonyms. Defaults to true.', type=[boolean]}, {name='phrase_slop', values=[0], description='Maximum number of positions allowed between matching tokens for phrases. Defaults to 0 (which means exact matches are required).', type=[integer]}, {name='default_field', values=[standard], description='Default field to search if no field is provided in the query string. Supports wildcards (*).', type=[keyword]}, {name='allow_leading_wildcard', values=[true, false], description='If true, the wildcard characters * and ? are allowed as the first character of the query string. Defaults to true.', type=[boolean]}, {name='minimum_should_match', values=[standard], description='Minimum number of clauses that must match for a document to be returned.', type=[string]}, {name='fuzzy_transpositions', values=[true, false], description='If true, edits for fuzzy matching include transpositions of two adjacent characters (ab → ba). Defaults to true.', type=[boolean]}, {name='fuzzy_prefix_length', values=[0], description='Number of beginning characters left unchanged for fuzzy matching. Defaults to 0.', type=[integer]}, {name='time_zone', values=[standard], description='Coordinated Universal Time (UTC) offset or IANA time zone used to convert date values in the query string to UTC.', type=[keyword]}, {name='lenient', values=[true, false], description='If false, format-based errors, such as providing a text query value for a numeric field, are returned. Defaults to false.', type=[boolean]}, {name='rewrite', values=[standard], description='Method used to rewrite the query.', type=[keyword]}, {name='default_operator', values=[OR, AND], description='Default boolean logic used to interpret text in the query string if no operators are specified.', type=[keyword]}, {name='analyzer', values=[standard], description='Analyzer used to convert the text in the query value into token. Defaults to the index-time analyzer mapped for the default_field.', type=[keyword]}, {name='fuzzy_max_expansions', values=[50], description='Maximum number of terms to which the query expands for fuzzy matching. Defaults to 50.', type=[integer]}, {name='quote_analyzer', values=[standard], description='Analyzer used to convert quoted text in the query string into tokens. Defaults to the search_quote_analyzer mapped for the default_field.', type=[keyword]}, {name='allow_wildcard', values=[false, true], description='If true, the query attempts to analyze wildcard terms in the query string. Defaults to false.', type=[boolean]}, {name='boost', values=[2.5], description='Floating point number used to decrease or increase the relevance scores of the query.', type=[float]}, {name='quote_field_suffix', values=[standard], description='Suffix appended to quoted text in the query string.', type=[keyword]}, {name='enable_position_increments', values=[true, false], description='If true, enable position increments in queries constructed from a query_string search. Defaults to true.', type=[boolean]}, {name='fields', values=[standard], description='Array of fields to search. Supports wildcards (*).', type=[keyword]}",
          "optional" : true,
          "description" : "(Optional) Additional options for Query String as <<esql-function-named-params,function named parameters>>. See <<query-dsl-query-string-query,query string query>> for more information."
        }
      ],
      "variadic" : false,
      "returnType" : "boolean"
    }
  ],
  "examples" : [
    "FROM books\n| WHERE QSTR(\"author: Faulkner\")",
    "FROM books\n| WHERE QSTR(\"title: Hobbjt~\", {\"fuzziness\": 2})"
  ],
  "preview" : false,
  "snapshot_only" : false
}