> For the complete documentation index, see [llms.txt](https://www.elastic.co/docs/api/doc/elasticsearch-serverless/llms.txt)

# Create or update an ES|QL dataset

> PUT /_query/dataset/{name}
> 
> Creates or replaces a dataset that references a data source in ES|QL data federation.
> Dataset names participate in the index namespace and must follow index or alias naming rules.
> Returns `404` if the referenced data source does not exist.
> 
> ## Required authorization
> 
> * Index privileges: `manage`


[ES|QL Data Federation](https://www.elastic.co/docs/reference/query-languages/esql/esql-data-federation)

## Servers
- http://api.example.com: http://api.example.com


## Authentication methods
- Api key auth


## Parameters

### Path parameters

- **name** (string)
  The dataset name to create or update.


### Query parameters

- **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.


### Body: application/json (object)

- **data_source** (string)
  The name of the referenced data source. The data source must already exist.

- **resource** (string)
  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.

- **description** (string)
  A free-text description of the dataset.

- **mappings** (object)
  User-declared mapping on the dataset definition

- **settings** (object)
  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.



## Responses
### 200


#### Body: application/json (object)
- **acknowledged** (boolean)
  For a successful response, this value is always true. On failure, an exception is returned instead.



[Powered by Bump.sh](https://bump.sh)
