Skip to main content Skip to complementary content

tOracleConnection Standard properties

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

The Standard tOracleConnection component belongs to the Databases and the ELT families.

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

Information noteNote: This component is a specific version of a dynamic database connector. The properties related to database settings vary depending on your database type selection. For more information about dynamic database connectors, see DB Generic components.

Basic settings

Database

Select the desired database type from the list and click Apply.

Property type

Either Built-in or Repository.

 

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.

Connection Type

Drop-down list of available drivers:

  • Oracle OCI: Select this connection type to use Oracle Call Interface with a set of C-language software APIs that provide an interface to the Oracle database.
  • Oracle Custom: Select this connection type to access a clustered database.
  • Oracle Service Name: Select this connection type to use the TNS alias that you give when you connect to the remote database.
  • WALLET: Select this connection type to store credentials in an Oracle wallet.
  • Oracle SID: Select this connection type to uniquely identify a particular database on a system.
Information noteNote: Connections that are of WALLET type are for the tCreateTable component, the tOracleInput component, and the tOracleOutput component only. Errors may occur if connections of the WALLET type are used by any other components.

DB Version

Select the Oracle version in use.

Use tns file

Select this check box to use the metadata of a context included in a tns file.

Information noteNote: One tns file may have many contexts.

TNS File: Enter the path to the tns file manually or browse to the file by clicking the [...] button next to the filed.

Select a DB Connection in Tns File: Click the [...] button to display all the contexts held in the tns file and select the desired one.

Host

Database server IP address.

Port

Listening port number of DB server.

Database

Name of the database.

Schema

Name of the schema.

Username and Password

DB user authentication data.

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

Use SSL

Select this check box to use the SSL protocol to protect the communication with your database server.

This property is available only when ORACLE CUSTOM is selected from the Connection Type drop-down list and Oracle 12-7 or Oracle 18 and above is selected from the DB Version drop-down list.

TrustStore file

The path to the TrustStore file used to authenticate your database server in SSL authentication.

This property is available only when the Use SSL check box is selected.

TrustStore password

The password for the TrustStore file.

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

This property is available only when the Use SSL check box is selected.

Need Client authentication

Select this check box if SSL client authentication is needed.

This property is available only when the Use SSL check box is selected.

KeyStore file

The path to the keystore file used for SSL client authentication.

This property is available only when the Need Client authentication check box is selected.

KeyStore password

The password for the KeyStore file.

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

This property is available only when the Need Client authentication check box is selected.

Disable CBC protection

Select this check box to disable the use of CBC (Cipher Block Chaining) in SSL authentication.

This property is available only when the Use SSL check box is selected.

Additional JDBC parameters

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

Information noteNote:

You can set the encoding parameters through this field.

Use or register a shared DB Connection

Select this check box to share your database connection or fetch a database connection shared by a parent or child Job, and in the Shared DB Connection Name field displayed, enter the name for the shared database connection. This allows you to share one single database connection (except the database schema setting) among several database connection components from different Job levels that can be either parent or child.

This option is incompatible with the Use dynamic Job and Use an independent process to run subJob options of the tRunJob component. Using a shared connection together with a tRunJob component with either of these two options enabled will cause your Job to fail.

This check box is not available when the Specify a data source alias check box is selected.

Specify a data source alias

Select this check box and specify the alias of a data source created on the Talend Runtime side to use the shared connection pool defined in the data source configuration. This option works only when you deploy and run your Job in Talend Runtime .

Advanced settings

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.

Support NLS

Select this option to enable globalization support. See Overview of Globalization Support for related information.

This option is available when Oracle 18 and above is selected from the DB Version drop-down list in the Basic settings view.

Information noteNote: This option is available only when you have installed the 8.0.1-R2022-09 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

Usage

Usage rule

This component is more commonly used with other Oracle components, especially with the tOracleCommit and tOracleRollback components.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!