Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version next

D toc


For smaller datasets, the Transformer page displays the entire dataset. For larger ones, the source data is sampled for use in the Transformer page. Through the Samples panel, you can create new samples and select them for display in the Transformer page.

At the top of the Transformer page, the type of the current sample is displayed next to the dataset name. To open the Samples panel, click the link. current sample indicator:

Image Added

D caption
Click the current sample button.

In the example below, the Full Data link indicates above, you can see that the current sample is a Random sample.

Initial Data: The sample is taken from the first set of rows in


the first file or table that is part of the dataset. 

  • In some cases, the Initial Data sample is the entire dataset


Image Removed


  • Tip

    Tip: For purposes of loading the data, the initial data sample is generated and displayed at first. For a better representation of the entire dataset, you should create a new sample.

  • In other cases, the Initial Data sample is generated from a collection of files. For more information on this special sampling type, see Overview of Sampling.

To create a new sample, click Collect a new sample.

The Samples panel is displayed on the right side of the screen:


Tip: You can also open the Samples panel by clicking the Eyedropper icon at the top of the page.

To review all samples that you have created, see Sample Jobs Page.

D caption
Samples Panel


At the top of the panel, you can review the currently loaded sample. Each user has his own active sample on a dataset.


NOTE: When a new sample is generated, any Sort transformations that have been applied previously must be re-applied. Depending on the type of output, sort order may not be preserved.

  • Initial Data: By default, the application loads the first N rows of the dataset as the initial data sample when the Transformer page is opened. The number of rows depends on column count, data density, and other factors. If the dataset is small enough, the full dataset is used. 


    NOTE: By default, samples may be up to 10 MB in size or may be limited based on the maximum number of files that can be scanned. For datasets smaller than this limit, the entire dataset is loaded. See Overview of Sampling.

  • Click the link in the current sample card to see the list of all available samples.


    Tip: To change the name of a sample, click its card in the list of all available. Then, click the Edit icon.


  • To collect a new sample, click the appropriate sample card. See below.


    Tip: A sample execution is a type of job. Any issues related to the execution of a sampling can be reviewed through the job logs.

  • To cancel a sample collection, click the X next to the progress bar. The interrupted sample is listed as unavailable. You can download the logs from the unfinished sample collection.


When a new sample is collected, it is gathered based on the current location in the recipe when the sample is gathered. So, if the recipe contains steps that join in other datasets, those joins are performed to bring together the data from which the sample is executed. 

D caption
Collect new sample panel

NOTE: Except for the initial data sample, all samples are generated based on the steps leading up to the location of the cursor in the recipe. If earlier steps are deleted or modified, the collected sample can be invalidated.


  • Name: You can enter a new name of the sample as needed. 


    Tip: Naming your samples can assist in tracking them later. For example, you might choose to add a date stamp to the name to track when you captured the sample.

  • Scan TypeScan Type: (Does not apply to all sampling methods) Types of scans: 
    • Quick - performs a random scan of the dataset to extract the appropriate number of rows for the
    • sample.
    • Full - gathers the sample from the entire dataset. Depending on the size of the dataset, this method can take a while.

  • Column or columns: (Stratified, Cluster-based) Name of the column from which to gather values to evaluate (Anomaly-based) Specify the name or names of one or more columns containing the anomalies to include in your sample. Multiple columns can be specified by comma-separated values. A column range can be specified using the tilde (~) character.


  • Anomaly type:(Anomaly-based) Select the type of anomalous values to include in your sample: invalid, missing, or both types.
  • Variable overrides: If one or more variables is associated with your dataset, you can define the value overrides to be applied when the sample is executed. 
    • You can use these overrides to sample data from different source files in your dataset with parameters. 
    • A variable can have an empty value.
    • For more information, see Overview of Parameterization.
  • To begin collecting the sample, click Collect.
  • You can continue working while the sample is collected. When the sample is available, a status message is displayed in the Transformer page.
  • You can click Load Sample in the Samples panel to begin using it.


To use one of the available samples, select its cardclick Load. The sample is loaded in the data grid. For more information, see Generate a Sample.


NOTE: If you add recipe steps that change the number of rows in your dataset (or a few other edge case steps), some of your existing samples may no longer be valid. When you execute a join, union, or delete action or edit steps before this action, you may be prompted with the Change Recipe dialog, which includes the following message:

Your change will invalidate some of the currently available samples for this source. The invalid samples will be deactivated.

For more information on the types of transformations that can invalidate samples, see Reshaping Steps.

Cancel sample jobs

You can cancel a sample job that is currently being executed.

  • In the Samples panel, locate the job in-progress. Click the X.

  • You can also review and cancel sample jobs through a page in the
    D s webapp
    . For more information, see Sample Jobs Page.

D s also
label(label = "sample") OR (label = "sample_ui") OR (label = "sample_ui")