# tCombinedSQLInput

Extracts fields from a database table based on its schema definition.

Then it passes on the field list to the next component via a Combine row link. The schema of tCombinedSQLInput can be different from that of the source database table but must correspond to it in terms of the column order.

tCombinedSQLInput extracts fields from a database table based on its schema. This component also has column filtering capabilities since its schema can be different from that of the database table.

## tCombinedSQLInput Standard properties

These properties are used to configure tCombinedSQLInput running in the Standard Job framework.

The Standard tCombinedSQLInput component belongs to the ELT family.

The component in this framework is available in all Talend products.

## Basic settings

| Properties | Description |
| --- | --- |
| Table | Name of the source database table. |
| Schema | Name of the source table's schema. This field has to be filled if<br>the database is Oracle. |
| Schema and Edit<br>schema | <ul> <li> <p>A schema is a row description. It defines the number of fields            (columns) to be processed and passed on to the next component. When you create a Spark            Job, avoid the reserved word <kbd>line</kbd> when naming the            fields.</p> <p>Click <span>Edit        schema</span> to make changes to the schema. If the current schema is of the <span>Repository</span> type, three options are available:</p> <ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> </li> <li> <p> <span>Built-in</span>: You create and store								the schema locally for this component only. For more information about a component schema in its <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> <li> <p> <span>Repository</span>: You have already								created the schema and stored it in the Repository. You can reuse it								in various projects and Jobs. For more information about a component schema in its <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> </ul> |
| Add additional columns | <ul> <li> <p>This option allows you to call SQL functions to perform actions on								columns, provided that these are not insert, update or delete								actions, or actions that require pre-processing.</p> </li> <li> <p> <span>Name</span>: Type in the name of the								schema column to be altered.</p> </li> <li> <p> <span>SQL expression</span>: Type in the SQL								statement to be executed in order to alter the data in the								corresponding column.</p> </li> </ul> |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher Statistics | Select this check box to gather the Job processing metadata at a<br>Job level as well as at each component level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | NB\_LINE: the number of rows read by an input component<br>or transferred to an output component. This is a Flow variable and it returns an<br>integer.<br><br><br>QUERY: the query statement<br>being processed. This is a Flow variable and it returns a string.<br><br><br>ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is an intermediary component. The use of the<br>corresponding connection and commit components is recommended when<br>using this component to allow a unique connection to be open and<br>then closed during the Job execution. |

**Related concepts**

* [Filtering and aggregating table columns directly on the DBMS](https://help.qlik.com/talend/en-US/components/8.0/combinedsql/tcombinedsqlinput-tcombinedsqlfilter-tmysqlinput-filtering-and-aggregating-table-columns-directly-on-dbms-standard-component-the)