Dataset-Level Transforms

Two-panel transform editor — 8 operation types, live preview, CRUD with recipe reference integrity

Transform Management

Transforms are column-level operations applied to the input dataset before it enters the recipe pipeline. They replace the old preparation routes (/datasets/[id]/preparation) which have been removed in v0.12.0.

Transform Operation Types

OperationDescription
RenameChange a column name
CastChange a column's data type
DeriveCreate a new column from an expression using existing columns
FilterRemove rows based on column conditions
SortOrder rows by one or more columns
AggregateGroup and summarise data
JoinCombine with another dataset on matching columns
UnionStack two datasets with matching columns

Live Preview

Each transform operation shows a live preview of its output. The two-panel layout shows operations on the left and a preview of the transformed data on the right. Invalid operations show errors inline.

Recipe Reference Integrity

Transforms belong to datasets — each transform is a column-level operation defined on a specific dataset. Recipes use transforms through a many-to-many intersection: a single transform can be used by multiple recipes, and a recipe can include multiple transforms. Deleting a recipe removes only the intersection rows that linked it to those transforms — the transforms themselves survive for use by other recipes. Shared recipes in read-only mode prevent modification of the intersection but do not lock the underlying transforms.

← Recipe Stages 📋 Contents SQL Execution Engine →