Script transformation

Overview

Script transformation is the transformation type used when a transformation needs to run script logic instead of being built only from table, reference, and column grids. Use it for scripted transformation steps that belong in the transformation flow and may need to create a result table or run through an execution package.

Function

A Script transformation stores the transformation metadata, the script text, the selected script execution style, optional package information, and table-output metadata. The editor changes the normal VIEW tab to Script and makes the script text editable.

The Script type selector controls how the script text is interpreted. For database-side script logic, enter the script directly in the Script tab. For executable-style script logic, the editor can prepare a template with fields for the executable path, arguments, working directory, and timeout.

Use Create result table when the script should produce a result table managed by the transformation. Use SSIS package to select or name the package that executes the scripted transformation. The Tables grid remains available so table entries can be associated with the script and marked as output tables when needed.

Use Don't detect dependencies when the script should be saved and executed without automatic dependency detection. This is useful for scripts where dependency discovery is not reliable or where the dependency order is controlled outside the visible script text.

Access

Create a Script transformation from the Transformation Wizard by selecting Script, or open an existing one from the transformation list. Script transformations can also be opened from the architecture diagram when the transformation is shown there.

How to access

Navigation tree

Schema -> Transformations -> open a script transformation

Toolbar

ETL -> New -> New Transformation or ETL -> List -> Transformations

Diagram

Open an existing script transformation node from the architecture diagram when present

Visual element

Transformation editor -> TransType / Script type / Script tab

Screen overview

IDPropertyDescription
1NameTransformation name used for the scripted transformation step.
2SchemaSchema where the script transformation is maintained.
3TransTypeIdentifies the transformation as Script and switches the editor to script-oriented controls.
4Script typeSelects whether the script is handled as database-side script logic or executable-style script logic.
5Script tabEditable script area used to maintain the scripted transformation logic.
6Executable template fieldsTemplate fields for executable path, arguments, working directory, and timeout are inserted when executable-style scripting is selected on an empty script.
7Result tableResult-table option used when the script transformation should create a managed output table.
8SSIS packagePackage name or selection used to execute the scripted transformation step.
9Create result tableMarks the script transformation as producing a result table.
10TablesLists table metadata associated with the script transformation.
11Is output tableMarks a table row as an output table for the script transformation.
12Don't detect dependenciesDisables automatic dependency detection for the scripted transformation.
13SaveStores the script text, script type, package setting, result-table setting, table metadata, and dependency setting.
14Create in DWHCreates or refreshes the script transformation in the data warehouse after the definition is saved.

Related topics