Skip to content

Docu Change: Query String Queries, fuzziness queries not analyzed, missing documentation #73299

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
SamyAteia opened this issue May 21, 2021 · 2 comments · Fixed by #73921
Closed

Docu Change: Query String Queries, fuzziness queries not analyzed, missing documentation #73299

SamyAteia opened this issue May 21, 2021 · 2 comments · Fixed by #73921
Labels
>docs General docs changes :Search/Search Search-related issues that do not fall into other categories Team:Docs Meta label for docs team Team:Search Meta label for search team

Comments

@SamyAteia
Copy link

The documentation for the fuzziness parameter in the query string query is missing the information that fuzziness queries are not analyzed.
This can lead to some confusion and unexpected results:
https://discuss.elastic.co/t/terms-with-fuzzy-operator-dont-use-mapping-analyzer-but-always-standard-analyzer/68593/4
Especially because the multi match queries which has a similar fuzziness setting behaves differently.

There was one old documentation that was mentioning this:

Whether terms of wildcard, prefix, fuzzy, and range queries are to be automatically lower-cased or not (since they are not analyzed). Defaults to true.

https://www.elastic.co/guide/en/elasticsearch/reference/2.4/query-dsl-query-string-query.html

But the setting war removed and this documentation with it.

I propose the following change to the documentation of the Query String Query:

Change:

fuzziness
(Optional, string) Maximum edit distance allowed for matching. See Fuzziness for valid values and more information.

To:

fuzziness
(Optional, string) Maximum edit distance allowed for matching. See Fuzziness for valid values and more information. 
Fuzzy queries are lowercased and not analyzed.
@jrodewig jrodewig added :Search/Search Search-related issues that do not fall into other categories >docs General docs changes labels May 24, 2021
@elasticmachine elasticmachine added Team:Search Meta label for search team Team:Docs Meta label for docs team labels May 24, 2021
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-docs (Team:Docs)

@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-search (Team:Search)

@jrodewig jrodewig mentioned this issue Jun 8, 2021
Merged
jrodewig added a commit that referenced this issue Jun 28, 2021
@jrodewig
[DOCS] Query strings are normalized for fuzzy (~) operator (#73921)
139eaba 
Notes that `fuzzy` queries made using the query string query's `~`
operator are normalized.

Closes #73299
jrodewig added a commit that referenced this issue Jun 28, 2021
@jrodewig
[DOCS] Query strings are normalized for fuzzy (~) operator (#73921) (…
3a5e0f2 
…#74646)

Notes that `fuzzy` queries made using the query string query's `~`
operator are normalized.

Closes #73299
jrodewig added a commit that referenced this issue Jun 28, 2021
@jrodewig
[DOCS] Query strings are normalized for fuzzy (~) operator (#73921) (…
c6df1d9 
…#74645)

Notes that `fuzzy` queries made using the query string query's `~`
operator are normalized.

Closes #73299
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
>docs General docs changes :Search/Search Search-related issues that do not fall into other categories Team:Docs Meta label for docs team Team:Search Meta label for search team
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

[DOCS] Query strings are normalized for fuzzy (~) operator
3 participants
@elasticmachine @jrodewig @SamyAteia