Browse Source

[DOCS] Warn about searching across all fields wt. `query_string` (#55853)

Warn about potential performance impact when a large number of fields
is used with query string query and no default field.

Re-adds content from #35570.
That content was erroneously removed in #45296.

Co-authored-by: Peter Dyson <peter.dyson@geekpete.com>
James Rodewig 5 years ago
parent
commit
3791a92603
1 changed files with 14 additions and 4 deletions
  1. 14 4
      docs/reference/query-dsl/query-string-query.asciidoc

+ 14 - 4
docs/reference/query-dsl/query-string-query.asciidoc

@@ -64,13 +64,23 @@ GET /_search
 the query string.
 
 Defaults to the `index.query.default_field` index setting, which has a default
-value of `*`. The `*` value extracts all fields that are eligible to term
-queries and filters the metadata fields. All extracted fields are then combined
-to build a query if no `prefix` is specified.
+value of `*`. The `*` value extracts all fields that are eligible for term
+queries and filters the metadata fields. All extracted fields are then
+combined to build a query if no `prefix` is specified.
 
-WARNING: There is a limit on the number of fields that can be queried at once.
+Searching across all eligible fields does not include <<nested,nested
+documents>>. Use a <<query-dsl-nested-query,`nested` query>> to search those
+documents.
+
+[[WARNING]]
+====
+For mappings with a large number of fields, searching across all eligible fields
+could be expensive.
+
+There is a limit on the number of fields that can be queried at once.
 It is defined by the `indices.query.bool.max_clause_count`
 <<search-settings,search setting>>, which defaults to 1024.
+====
 --
 
 `allow_leading_wildcard`::