# Configure transformation properties

Transformation properties are a collection of properties that describe the transformation and configure its behavior. You can use transformation properties to customize the processing of your data to achieve the desired output.

To view the transformation properties, click CTRLT or right-click on the canvas and select **Properties** from the menu that appears. The following sections provide a detailed description of the available settings:

* Transformation tab
* Parameters tab
* Logging tab
* Dates tab
* Dependencies tab
* Miscellaneous tab
* Monitoring tab

After you have adjusted your settings, click SQL to generate the SQL code necessary for creating the logging table. The Data Definition Language (DDL) displays in the Simple SQL Editor allowing you to execute this or any other SQL statements against the logging connection. For information on how to use the SQL Editor, see [Use the SQL Editor](/pdia-data-integration/archived-merged-pages/transforming-data-with-pdi-archive/logging-and-performance-monitoring/use-the-sql-editor.md).

## Transformation tab

Use the **Transformation** tab to specify general properties about the transformation.

![Transformation properties - Transformation tab](/files/LThpJsswcrcClPbjO8GM)

This tab includes the following options:

| Property                | Description                                                                                  |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| Transformation name     | The name of the transformation. This field is required to save the settings to a repository. |
| Transformation filename | The file name (\*.ktr) of the transformation.                                                |
| Description             | Short description of the transformation which displays in the repository explorer.           |
| Extended description    | Long extended description of the transformation.                                             |
| Status                  | Draft or production status                                                                   |
| Version                 | Version description                                                                          |
| Directory               | The directory in the repository where the transformation is stored.                          |
| Created by              | Name of the original creator of the transformation.                                          |
| Created at              | Date and time when the transformation was created.                                           |
| Last modified by        | The username of the last user that modified the transformation.                              |
| Last modified at        | Date and time when the transformation was last modified.                                     |

## Parameters tab

Use the **Parameters** tab to add parameters to customize your transformation.

![Transformation properties - Parameters tab](/files/zh3nWPoHFfjiCdZwQjIp)

This tab includes the following options:

| Property      | Description                                                                                   |
| ------------- | --------------------------------------------------------------------------------------------- |
| Parameter     | Acts as a local variable that can be shared across all steps in an individual transformation. |
| Default Value | Value that is used if the parameter is not set somewhere else in the transformation.          |
| Description   | Description of the user-defined parameter.                                                    |

## Logging tab

Use the **Logging** tab to configure how and where logging information is captured. For more information about how to configure transformation logging, see [Set up transformation logging](/pdia-data-integration/archived-merged-pages/transforming-data-with-pdi-archive/logging-and-performance-monitoring/set-up-transformation-logging.md).

![Transformation properties - Logging tab](/files/Xw5ntGSO1yVXV9Ho7Mql)

In the left navigation pane, select which type of logging you want to use. This tab includes the following options:

| Property                     | Description                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Log Connection               | Specify the database connection you are using for logging. You can configure a new connection by clicking **New**.                                                                                                                                                                                                                                                                   |
| Log table schema             | Specify the schema name, if supported by your database.                                                                                                                                                                                                                                                                                                                              |
| Log table name               | Specifies the name of the log table. **Note:** If you are also using job logging, use a different table name for Transformation logging.                                                                                                                                                                                                                                             |
| Logging interval (seconds)   | Specify the interval in which logs are written to the table. This property only applies to Transformation and Performance logging types.                                                                                                                                                                                                                                             |
| Log record timeout (in days) | <p>Specify the number of days to keep log entries in the table before they are deleted.</p><p>This property only applies to Transformation and Performance logging types.</p><p>If you find that data in the log table is not deleted as expected, see <a href="/pages/9HtASsy2sz6ublUNYozS">Log table data is not deleted</a> in Troubleshooting for best practice information.</p> |
| Log size limit (in lines)    | <p>Enter the limit for the number of lines that are stored in the LOG\_FIELD. PDI stores logging for the transformation in a long text field (CLOB).</p><p>This property only applies to the Transformation logging type.</p>                                                                                                                                                        |
| Fields to log                | Select the fields you want to log in the **Fields to log** pane.                                                                                                                                                                                                                                                                                                                     |

## Dates tab

Use the **Dates** tab to configure date ranges and limits for this connection.

![Transformation properties - Dates tab](/files/ICxt5USRoU8wIUrBb4ly)

This tab includes the following options:

| Property                          | Description                                                                                                                                                                                                                                                                  |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Maxdate connection                | Get the upper limit for a date range on this connection.                                                                                                                                                                                                                     |
| Maxdate table                     | Get the upper limit for a date range in this table.                                                                                                                                                                                                                          |
| Maxdate field                     | Get the upper limit for a date range in this field.                                                                                                                                                                                                                          |
| Maxdate offset (seconds)          | Increases the upper date limit with this amount. Use this for example, if you find that the field DATE\_LAST\_UPD has a maximum value of 2004-05-29 23:00:00, but you know that the values for the last minute are not complete. In this case, simply set the offset to -60. |
| Maximum date difference (seconds) | Sets the maximum date difference in the obtained date range. This will allow you to limit job sizes.                                                                                                                                                                         |

## Dependencies tab

Use the **Dependencies** tab to specify all of the dependencies for the transformation.

![Transformation properties - Dependencies tab](/files/T8wFJTaq7XRy39sXdXq3)

The **Dependencies** tab allows you to enter all of the dependencies for the transformation. For example, if a dimension depends on three lookup tables, make sure that the lookup tables have not changed. If the values in these lookup tables have changed, extend the date range to force a full refresh of the dimension.

Dependencies allow you to determine if a table has changed when you have a "data last changed" column in the table. Click **Get dependencies** to detect dependencies automatically.

| Property   | Description                                                                                       |
| ---------- | ------------------------------------------------------------------------------------------------- |
| Connection | A dropdown to select a database connection that has already been created for that transformation. |
| Table      | A specific table from the selected database connection.                                           |
| Field      | A specific field within the selected table.                                                       |

## Miscellaneous tab

Use the **Miscellaneous** tab to configure buffer and feedback size and performing various administrative tasks.

![Transformation properties - Miscellaneous tab](/files/szpkSX5rKL56BTiSWMyI)

This tab includes the following options:

| Property                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Number of rows in rowset                       | Allows you to change the size of the buffers between the connected steps in a transformation. Do not change this parameter unless you are running low on memory, for example.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Show a feedback row in transformation steps?   | Controls whether or not to add a feedback entry into the log file while the transformation is being executed. By default, this feature is enabled and configured to display a feedback record every 5000 rows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| The feedback size                              | Sets the number of rows to process before entering a feedback entry into the log. Set this higher when processing large amounts of data to reduce the amount of information in the log file.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Make the transformation database transactional | <p>This allows you to open one unique connection per defined and used database connection in the transformation. Enabling this option is required to allow a failed transformation to be completely rolled back.</p><p>Enabling this option is also necessary when trying to alter connection settings before a query using an "Execute SQL script" step. (See also the <strong>Advanced</strong> section in the Database Connection dialog box "Enter the SQL statements (separated ...) to execute right after connecting")</p><p>Further information can be found in <a href="https://pentaho-public.atlassian.net/wiki/spaces/EAI/pages/386803253/Database+transactions+in+jobs+and+transformations">Database transactions in jobs and transformations</a>.</p><p><strong>Note:</strong> A transformation wide commit for all steps is done when the last step finishes. When the transformation fails, a rollback is done. It is not necessary to set any commit sizes since they are ignored.</p> |
| Shared objects file                            | Specifies the location of the XML file used to store shared objects like database connections, clustering schemas, and more.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Manage thread priorities?                      | Allows you to enable or disable the internal logic for changing the Java thread priorities based on the number of input and output rows in the "rowset" buffers. This can be useful in some situations where the cost of using the logic exceeds the benefit of the thread prioritization.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

## Monitoring tab

Use the **Monitoring** tab for enabling and disabling step performance monitoring and setting related performance parameters.

![Transformation properties - Monitoring tab](/files/aJxmmlcXAHGYNY5S2xi0)

This tab includes the following options:

| Property                                   | Description                                                                                                                                                                                                                                                                                |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Enable step performance monitoring?        | This activates performance monitoring for transformation steps. It shows how many rows of data are being written, read, inputted, or outputted for each step. These metrics can be viewed on the **Performance Graph** tab that’s part of the**Execution Results** panel below the canvas. |
| Step performance measurement interval (ms) | This is the interval in milliseconds used to take a snapshot. Example: 10 ms                                                                                                                                                                                                               |
| Maximum number of snapshots in memory      | Sets the maximum number of measurement snapshots that can be held in memory during runtime.                                                                                                                                                                                                |


---

# Agent Instructions: 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.pentaho.com/pdia-data-integration/archived-merged-pages/transforming-data-with-pdi-archive/work-with-transformations-cp/configure-transformation-properties.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.
