Browse Source

[DOCS] Fuzzy wildcard not supported in `query_string` (#50466)

The `query_string` does not support mixing wildcards with fuzziness.
This adds a related warning to the `query_string` docs.
James Rodewig 5 years ago
parent
commit
e090b9bcad
1 changed files with 12 additions and 0 deletions
  1. 12 0
      docs/reference/query-dsl/query-string-syntax.asciidoc

+ 12 - 0
docs/reference/query-dsl/query-string-syntax.asciidoc

@@ -44,6 +44,7 @@ You can specify fields to search in the query syntax:
 
 
     _exists_:title
     _exists_:title
 
 
+[[query-string-wildcard]]
 ====== Wildcards
 ====== Wildcards
 
 
 Wildcard searches can be run on individual terms, using `?` to replace
 Wildcard searches can be run on individual terms, using `?` to replace
@@ -112,6 +113,7 @@ Elasticsearch to visit every term in the index:
 Use with caution!
 Use with caution!
 =======
 =======
 
 
+[[query-string-fuzziness]]
 ====== Fuzziness
 ====== Fuzziness
 
 
 We can search for terms that are
 We can search for terms that are
@@ -132,6 +134,16 @@ sufficient to catch 80% of all human misspellings. It can be specified as:
 
 
     quikc~1
     quikc~1
 
 
+[[avoid-widlcards-fuzzy-searches]]
+[WARNING]
+.Avoid mixing fuzziness with wildcards
+====
+Mixing <<fuzziness,fuzzy>> and <<query-string-wildcard,wildcard>> operators is
+_not_ supported. When mixed, one of the operators is not applied. For example,
+you can search for `app~1` (fuzzy) or `app*` (wildcard), but searches for
+`app*~1` do not apply the fuzzy operator (`~1`).
+====
+
 ====== Proximity searches
 ====== Proximity searches
 
 
 While a phrase query (eg `"john smith"`) expects all of the terms in exactly
 While a phrase query (eg `"john smith"`) expects all of the terms in exactly