elasticsearch/docs/reference/esql/processing-commands/where.asciidoc
Abdon Pijpelink e87c49cb4b
[DOCS] Improve ES|QL functions reference for functions E-Z (#104623)
* Functions E-Z

* Incorporate changes from #103686

* More functions

* More functions

* Update docs/reference/esql/functions/floor.asciidoc

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

* Update docs/reference/esql/functions/left.asciidoc

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Alexander Spies <alexander.spies@elastic.co>

* Review feedback

* Fix geo_shape description

* Change 'colum'/'field' into 'expressions'

* Review feedback

* One more

---------

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Co-authored-by: Alexander Spies <alexander.spies@elastic.co>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2024-01-25 16:32:24 +01:00

62 lines
No EOL
1.2 KiB
Text

[discrete]
[[esql-where]]
=== `WHERE`
**Syntax**
[source,esql]
----
WHERE expression
----
*Parameters*
`expression`::
A boolean expression.
*Description*
The `WHERE` processing command produces a table that contains all the rows from
the input table for which the provided condition evaluates to `true`.
*Examples*
[source,esql]
----
include::{esql-specs}/docs.csv-spec[tag=where]
----
Which, if `still_hired` is a boolean field, can be simplified to:
[source,esql]
----
include::{esql-specs}/docs.csv-spec[tag=whereBoolean]
----
Use date math to retrieve data from a specific time range. For example, to
retrieve the last hour of logs:
[source,esql]
----
include::{esql-specs}/date.csv-spec[tag=docsNowWhere]
----
`WHERE` supports various <<esql-functions,functions>>. For example the
<<esql-length>> function:
[source,esql]
----
include::{esql-specs}/docs.csv-spec[tag=whereFunction]
----
For a complete list of all functions, refer to <<esql-functions>>.
include::../functions/predicates.asciidoc[tag=body]
include::../functions/like.asciidoc[tag=body]
include::../functions/rlike.asciidoc[tag=body]
include::../functions/in.asciidoc[tag=body]
For a complete list of all operators, refer to <<esql-operators>>.