Managing Datasets

A dataset is a collection of generated records that conform to a schema. This guide covers creating, browsing, editing, and deleting datasets in the Data Studio UI.

Creating a Dataset

1. Navigate to Data Studio in the sidebar
2. Click New Dataset
3. Fill in the dataset details:
   • Name — a descriptive name (e.g., "Customer Records")
   • Description (optional) — what this dataset models
   • Tags (optional) — categorization labels (e.g., customers, b2b, staging)
4. Define your schema by adding fields (see Schemas for details)
5. Click Create

Your dataset appears in the dataset list and is ready for data generation.

Browsing Datasets

The Dataset List page shows all datasets in your organization:

• Name and description for quick identification
• Row count — total records in the latest version
• Tags — color-coded chips for filtering
• Last generated — timestamp of the most recent generation
• Version count — number of generation snapshots

Filtering and Search

• Type in the search bar to filter by name or description
• Click a tag chip to filter datasets by that tag
• Sort by name, date created, or last generated using the column headers

Dataset Detail View

Click any dataset to open the detail view. The detail view has the following tabs:

Tab	What It Shows
Schema	Field definitions — name, type, description for each field
Data	Tabular view of the latest generated records with column sorting and search
Versions	Generation history with row counts, tokens used, duration, and the prompt used
Scenarios	Named data variants for different test cases
Bindings	Connections to mock simulations
Chat	AI assistant for data exploration and manipulation
Share	Public share links and access settings

Editing a Dataset

Update Metadata

1. Open the dataset detail view
2. Click the pencil icon next to the dataset name or description
3. Edit the name, description, or tags inline
4. Press Enter or click away to save

Update Tags

1. Open the dataset detail view
2. Click the Tags area below the description
3. Type to add new tags, or click the x on existing tags to remove them
4. Tags save automatically

Organizing with Tags

Tags help you categorize and filter datasets. Common strategies:

Strategy	Example Tags
By domain	customers, orders, products, users
By environment	staging, qa, demo
By test type	load-testing, integration-tests, manual-qa
By team	frontend-team, backend-team, qa-team

Cloning a Dataset

1. Open the dataset detail view
2. Click the more options menu (three dots) in the top-right corner
3. Select Clone
4. The cloned dataset copies the schema and tags but starts with no generated data
5. Rename the clone and generate fresh data

Deleting a Dataset

1. Open the dataset detail view
2. Click the more options menu (three dots) in the top-right corner
3. Select Delete
4. Confirm in the dialog

caution

Deleting a dataset permanently removes all versions, scenarios, bindings, and share links. This action cannot be undone.

Next Steps

• Schemas — define and edit data structures
• Generation — generate test data from your schema
• Scenarios — create test case variants