tCombinedSQLInput – Docs for ESB 5.x

Component family

ELT/CombinedSQL

Function

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.

Purpose

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.

Basic settings

Table

Name of the source database table.

Schema

Name of the source table’s schema. This field has to be filled if
the database is Oracle.

Schema and Edit
schema

A schema is a row description. It defines the number of fields to be processed and passed on
to the next component. The schema is either Built-In or
stored remotely in the Repository.

Since version 5.6, both the Built-In mode and the Repository mode are
available in any of the Talend solutions.

Click Edit schema to make changes to the schema. If the
current schema is of the Repository type, three options are
available:

Built-in: You create and store
the schema locally for this component only. Related topic: see
Talend Studio User
Guide.

Repository: You have already
created the schema and stored it in the Repository. You can reuse it
in various projects and Jobs. Related topic: see Talend Studio User
Guide.

Add additional columns

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.

Name: Type in the name of the
schema column to be altered.

SQL expression: Type in the SQL
statement to be executed in order to alter the data in the
corresponding column.

Advanced settings

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a
Job level as well as at each component level.

Global Variables

NB_LINE: the number of rows read by an input component or
transferred to an output component. This is a Flow variable and it returns an
integer.

QUERY: the SQL query statement being processed. This is a
Flow variable and it returns a string.

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

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 it.

For further information about variables, see Talend Studio
User Guide.

Usage

This component is an intermediary component. The use of the
corresponding connection and commit components is recommended when
using this component to allow a unique connection to be open and
then closed during the Job execution.

Limitation

n/a