stack es esql put-dataset cli command

elastic stack es esql put-dataset \
  --data-source <data-source> \
  --resource <resource> \
  --name <name> \
  [options]

Create or update an ES|QL dataset.

Behaviour flags:

--dry-run — validate all inputs and exit without performing any action

--data-source string required

The name of the referenced data source. The data source must already exist.

--resource string required

The URI that identifies the data to read, resolved against the referenced data source. It can include glob patterns. For example, a recursive pattern can match all Parquet files under the s3://logs-bucket/access prefix.

--name string required

The dataset name to create or update.

--master-timeout string

Period to wait for a connection to the master node.

--timeout string

The time to wait for the request to be completed.

--description string

A free-text description of the dataset.

--mappings string

User-declared mapping on the dataset definition

--settings string

Format and parsing-specific settings that configure how the resource is read. Common keys include format, which explicitly selects a registered format, and partition_detection, which accepts auto, hive, template, or none. Additional keys depend on the format reader. Compression can be inferred from the resource URI.

--error-trace

When set to true Elasticsearch will include the full stack trace of errors when they occur.

--filter-path string

Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch.

Repeatable: pass --filter-path multiple times to supply more than one value

--human

When set to true will return statistics in a format suitable for humans. For example "exists_time": "1h" for humans and "exists_time_in_millis": 3600000 for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines.

--pretty

If set to true the returned JSON will be "pretty-formatted". Only use this option for debugging only.

--input-file string

path to a JSON file to use as command input

--dry-run

validate all inputs and exit without performing any action (preview changes without applying them)

--no-validate

skip input validation and send the request as-is

--output-fields string

comma-separated list of fields to include in output (dot-notation supported)

--output-template string

Mustache-like template for custom text output (e.g. "{{id}}: {{name}}")

--json

output as JSON