Skip to content

Commit 4174ee5

Browse files
kolchfa-awsepugh
authored andcommitted
Add analysis paragraph to the DQL page (opensearch-project#9464)
Signed-off-by: Fanit Kolchina <[email protected]> Signed-off-by: Eric Pugh <[email protected]>
1 parent 2f49b61 commit 4174ee5

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

_dashboards/dql.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,10 @@ By default, OpenSearch Dashboards uses DQL syntax. To switch to query string que
1919

2020
The syntax changes to **Lucene**. To switch back to DQL, select the **Lucene** button and toggle the **Off** switch.
2121

22+
## Queries on analyzed text
23+
24+
When running queries, understanding whether your fields are analyzed ([`text`]({{site.url}}{{site.baseurl}}/field-types/supported-field-types/text/) type) or non-analyzed ([`keyword`]({{site.url}}{{site.baseurl}}/field-types/supported-field-types/keyword/) type) is crucial because it significantly impacts search behavior. In analyzed fields, text undergoes tokenization and filtering, while non-analyzed fields store exact values. For simple field queries like `wind`, searches against analyzed fields match documents containing `wind` regardless of case, while the same query on keyword fields requires exact matching of the full string. For more information about analyzed fields, see [Text analysis]({{site.url}}{{site.baseurl}}/analyzers/).
25+
2226
## Setup
2327

2428
To follow this tutorial in OpenSearch Dashboards, expand the following setup steps.
@@ -142,7 +146,7 @@ The following table provides a quick reference for both query language commands.
142146
| Boolean `NOT` | `NOT media_type: article` <br><br> `not media_type: article` | `NOT media_type:article` <br><br> `-media_type:article` |
143147
| Boolean `OR` | `title: wind OR description: film` <br><br> `title: wind or description: film` | `title: wind OR description: film` |
144148
| Required/Prohibited operators | Not supported | Supports both `+` (required operator) and `-` (prohibited operator) <br><br> `+title:wind -media_type:article` (returns documents in which `title` contains `wind` but `media_type` does not contain `article`) |
145-
| Wildcards | `title: wind*`<br><br> `titl*: wind` <br><br> Only supports `*` (multiple characters) | `title:wind*` or `title:w?nd` <br><br> Does not support wildcards in field names <br><br> Supports `*` (multiple characters) and `?` (single character) |
149+
| Wildcards | `title: wind*`<br><br> `titl*: wind` <br><br> Does not support wildcards in phrase searches (within quotation marks) <br><br> Only supports `*` (multiple characters) | `title:wind*` or `title:w?nd` <br><br> Does not support wildcards in field names <br><br> Does not support wildcards in phrase searches (within quotation marks) <br><br> Supports `*` (multiple characters) and `?` (single character) |
146150
| Regular expressions | Not supported | `title:/w[a-z]nd/` |
147151
| Fuzzy search | Not supported | `title:wind~2` |
148152
| Proximity search | Not supported | `"wind rises"~2` |

0 commit comments

Comments
 (0)