---
url: >-
  /statelake/administering-statelake/designer/actions/add-data-data-tab/new-db-definition-item.md
---

# New DB Definition Item

Selecting **DB Definition** creates a **New DB Definition Item** under the **Data Tab**.

Click on the item to access the fields.

## Fields

| Field Name | Description |
|---|---|
| Definition | Select the **Data Definition** you want to reference. |
| DB Connection | Select the **DB Connection** used on this **Data Definition**. This is a run time setting and overrides the design time setting done on the **Data Definition**. |
| Use a separate "SQL Transaction" for this database connection | Select whether this **DB Definition** will uses it own SQL Transaction against the database. Also refer to the **Transaction Commit Action** under **Add Action** for this **Action Step**. |
| Parameters | Select any available **Parameter** to reference. |
| Allow DB Connection to change to those specified on trading partner | Select to allow the **DB Connection** to change to those configured on any **Trading Partner** assigned to this **Action**. Useful when working with a configuration where different **Trading Partner**s have their own databases. |
| Allow user to populate parameters when action is executed | Select to have the Dynamic Search Parameters pop-up at run time so they user can provide values specific to that execution of the **Action**.This is only allowed if the **Action** has been configured to run manually. |
| Preview data before saving to database | Select to have the results of a mapping displayed in a grid editor prior to be saved to the output. This allows you to manually modify the results prior to output.This is only allowed if the **Action** has been configured to run manually. |