tDB2Connection – Docs for ESB 5.x

Component family

Databases/DB2

Function

tDB2Connection opens a connection
to the database for a current transaction.

Purpose

This component is used to open a connection to the specified database that can then be reused in the subsequent subjob or subjobs.

Basic settings

Property type

Either Built-in or
Repository.

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

Built-in: No property data stored
centrally.

Repository: Select the repository
file in which the properties are stored. The fields that follow are
completed automatically using the data retrieved.

Host name

Database server IP address.

Port

Listening port number of DB server.

Database

Name of the database.

Table Schema

Name of the schema.

Username and
Password

DB user authentication data.

To enter the password, click the […] button next to the
password field, and then in the pop-up dialog box enter the password between double quotes
and click OK to save the settings.

Encoding

Select the encoding from the list or select Custom and define it manually. This field is
compulsory for DB data handling.

Use or register a shared DB Connection

Select this check box to share your connection or fetch a
connection shared by a parent or child Job. This allows you to share
one single DB connection among several DB connection components from
different Job levels that can be either parent or child.

Shared DB Connection Name: set or
type in the shared connection name.

Advanced settings

Additional JDBC parameters

Specify additional connection properties for the DB connection you
are creating.

Auto Commit

Select this check box to commit any changes to the database automatically upon the
transaction.

With this check box selected, you cannot use the corresponding commit component to commit
changes to the database; likewise, when using the corresponding commit component, this check
box has to be cleared. By default, the auto commit function is disabled and changes must be
committed explicitly using the corresponding commit component.

Note that the auto commit function commits each SQL statement as a single transaction
immediately after the statement is executed while the commit component does not commit only
until all of the statements are executed. For this reason, if you need more room to manage
your transactions in a Job, it is recommended to use the commit component.

tStatCatcher Statistics

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

Usage

This component is more commonly used with other tDB2* components,
especially with the tDB2Commit and
tDB2Rollback components.

Log4j

The activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User
Guide.

For more information on the log4j logging levels, see the Apache documentation at http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html.

Limitation

This component requires installation of its related jar files. For more information about the
installation of these missing jar files, see the section describing how to configure the
Studio of the Talend Installation and Upgrade Guide.