> For the complete documentation index, see [llms.txt](https://docs.wirebootstrap.com/wirebootstrap/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wirebootstrap.com/wirebootstrap/datasets.md).

# Introduction

Executing a query directly against a data source returns a one-time result set.  A [DataSet](/wirebootstrap/reference/wire.data/wire.data.dataset.md) is a class container that combines a query with a data source.  It executes the query on behalf of consumers and stores the result set internally.  It is then able to listen for changes that affect the query using [Data Events](/wirebootstrap/reference/wire.data/untitled.md).  If the dataset picks up any changes, it will refresh the result set by re-running the updated query in the data service, update its internal result set, and alert consumers of the change.

This "live" connection to data services allows UI components to effectively talk to one another responding to user-interaction automatically without having to code them to explicitly handle events, refresh data, and re-bind their UI.

## Configuration

A dataset constructor simply takes a data source and a query as a parameter.

```javascript
const accountService = new wire.data.DataSource("custom", {
    ServiceRoot: "./account"
});

const query = wire.data.select().from("Users")
    .where().eq("fred", "x");
    
const dataset = new wire.data.DataSet({
    Source: accountService,
    Query: query
});
```

For more on datasets, visit the [DataSet](/wirebootstrap/reference/wire.data/wire.data.dataset.md) reference page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wirebootstrap.com/wirebootstrap/datasets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.