elasticsearch/docs/reference/esql/processing-commands/keep.asciidoc
Abdon Pijpelink 8ac4ba751e
Restructure ES|QL docs (#100806)
* Break out 'Limitations' into separate page

* Add REST API docs

* Restructure commands, functions, and operators refs

* Add placeholder for getting started guide

* Group 'Syntax', 'Metafields', and 'MV fields' under 'Language'

* Add placeholder for Kibana page

* Add link from landing page

* Apply uniform formatting to ACOS, CASE, and DATE_PARSE function refs

* Reword default LIMIT

* Add support for COUNT(*)

* Move 'Commands' and 'Functions and operators' to individual pages

---------

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2023-10-17 17:36:14 +02:00

35 lines
976 B
Text

[discrete]
[[esql-keep]]
=== `KEEP`
The `KEEP` command enables you to specify what columns are returned and the
order in which they are returned.
To limit the columns that are returned, use a comma-separated list of column
names. The columns are returned in the specified order:
[source.merge.styled,esql]
----
include::{esql-specs}/docs.csv-spec[tag=keep]
----
[%header.monospaced.styled,format=dsv,separator=|]
|===
include::{esql-specs}/docs.csv-spec[tag=keep-result]
|===
Rather than specify each column by name, you can use wildcards to return all
columns with a name that matches a pattern:
[source,esql]
----
include::{esql-specs}/docs.csv-spec[tag=keepWildcard]
----
The asterisk wildcard (`*`) by itself translates to all columns that do not
match the other arguments. This query will first return all columns with a name
that starts with an h, followed by all other columns:
[source,esql]
----
include::{esql-specs}/docs.csv-spec[tag=keepDoubleWildcard]
----