48 lines
1.1 KiB
Markdown
48 lines
1.1 KiB
Markdown
|
## `QSTR` [esql-qstr]
|
||
|
|
|
||
|
|
::::{warning}
|
||
|
|
Do not use on production environments. This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
|
||
|
|
::::
|
||
|
|
|
||
|
|
|
||
|
|
**Syntax**
|
||
|
|
|
||
|
|
:::{image} ../../../../../images/qstr.svg
|
||
|
|
:alt: Embedded
|
||
|
|
:class: text-center
|
||
|
|
:::
|
||
|
|
|
||
|
|
**Parameters**
|
||
|
|
|
||
|
|
`query`
|
||
|
|
: Query string in Lucene query string format.
|
||
|
|
|
||
|
|
**Description**
|
||
|
|
|
||
|
|
Performs a [query string query](/reference/query-languages/query-dsl-query-string-query.md). Returns true if the provided query string matches the row.
|
||
|
|
|
||
|
|
**Supported types**
|
||
|
|
|
||
|
|
| query | result |
|
||
|
|
| --- | --- |
|
||
|
|
| keyword | boolean |
|
||
|
|
| text | boolean |
|
||
|
|
|
||
|
|
**Example**
|
||
|
|
|
||
|
|
```esql
|
||
|
|
FROM books
|
||
|
|
| WHERE QSTR("author: Faulkner")
|
||
|
|
| KEEP book_no, author
|
||
|
|
| SORT book_no
|
||
|
|
| LIMIT 5
|
||
|
|
```
|
||
|
|
|
||
|
|
| book_no:keyword | author:text |
|
||
|
|
| --- | --- |
|
||
|
|
| 2378 | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott] |
|
||
|
|
| 2713 | William Faulkner |
|
||
|
|
| 2847 | Colleen Faulkner |
|
||
|
|
| 2883 | William Faulkner |
|
||
|
|
| 3293 | Danny Faulkner |
|