tOracleCDC Standard properties

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

Property of the CDC connection

Either Built-in or Repository.

Built-In: You create and store the schema locally for this component only.

Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs.

Use an existing connection

Select this check box and in the Component List drop-down list, select the desired connection component to reuse the connection details you already defined.

Note that connections that are of WALLET type are for the tCreateTable component, the tOracleInput component, and the tOracleOutput component only. Make sure that the connection selected is not of the WALLET type to prevent possible errors.

Connection Type

Select a connection type from the drop-down list:

• Oracle SID: Select this connection type to uniquely identify a particular database on a system.

• Oracle Service Name: Select this connection type to use the TNS alias that you give when you connect to the remote database.

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

DB Version

Select the version of the Oracle database being used.

Host

Specify the host name or IP address of the Oracle database.

This field appears only when Oracle SID or Oracle Service Name is selected from the Connection Type drop-down list.

Port

Specify the listening port number of the Oracle database.

This field appears only when Oracle SID or Oracle Service Name is selected from the Connection Type drop-down list.

Database

Specify the Oracle database name.

This field appears only when Oracle SID or Oracle Service Name is selected from the Connection Type drop-down list.

Local Service Name

Specify the local service name of the Oracle database.

This field appears only when Oracle OCI is selected from the Connection Type drop-down list.

URL

Specify the URL of the remote Oracle database.

This field appears only when Oracle CUSTOM is selected from the Connection Type drop-down list.

Oracle schema

Specify the name of the Oracle schema.

Username and Password

Specify the user authentication data of the Oracle database.

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.

Schema using CDC 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.

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

• View schema: choose this option to view the schema only.

• Change to built-in property: choose this option to change the schema to Built-in for local changes.

• Update repository connection: choose this option to change the schema stored in the repository and decide whether to propagate the changes to all the Jobs upon completion.

  If you just want to propagate the changes to the current Job, you can select No upon completion and choose this schema metadata again in the Repository Content window.

The schema is set by default according to the CDC mode being used.

Built-In: You create and store the schema locally for this component only.

Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs.

CDC mode

Select a CDC mode to be used:

• Trigger: the CDC trigger mode.

• Log: the CDC Redo/Archive log mode. This mode requires Oracle database Enterprise Editions and is not supported in Oracle 12 or higher versions.

• XStream: the CDC XStream mode. This mode is available only when the Connection Type is Oracle OCI and the DB Version is Oracle 12-7 (or higher).

Generate LCR type

Select a type for the LCR to be generated, either LCR Object or LCR XML Document.

This list appears only when the CDC mode is XStream.

Table using CDC

Specify the source table from which changes made to data are to be captured.

Set data table schema

Select this check box if you want to specify the schema of the CDC table.

This check box appears only when the CDC mode is Trigger or Log.

Subscriber

Specify the name of the application that will use the change table if you use the Trigger mode to capture changes done on data.

This field appears only when the CDC mode is Trigger.

Events to catch

Insert: Select this check box to catch the data inserted in the change table since the last extraction.

Update: Select this check box to catch the data updated in the change table since the last extraction.

Delete: Select this check box to catch the data deleted in the change table since the last extraction.

These check boxes appear only when the CDC mode is Trigger or Log.

Limit

Specify the maximum number of consumed rows a subscriber can recover from the change table, per execution.

This field appears only when the CDC mode is Trigger.

Outbound server name

Specify the XStream outbound server name.

This field appears only when the CDC mode is XStream.

Keep listening

Select this check box to keep monitoring the outbound server for data changes. The Job will not stop until you manually stop it when you need to.

This check box appears only when the CDC mode is XStream.

Keep data in CDC Table

Select this check box to keep the changes made available to one or more target systems, even after they have been consulted.

This field appears only when the CDC mode is Trigger or Log.

Use cursor

Select this check box to specify the number of rows you want to work with at any given time. This option optimises performance.

This field appears only when the CDC mode is Trigger or Log.

Trim all the String/Char columns

Select this check box to delete any spaces found at the beginning or end of fields, in all of the columns containing character strings.

This field appears only when the CDC mode is Trigger or Log.

Trim column

Remove leading and trailing whitespace from defined columns.

This table appears only when the CDC mode is Trigger or Log.

Acknowledge interval(seconds)

Specify the value for the OCI_ATTR_XSTREAM_ACK_INTERVAL attribute for the outbound server. The default value is 30 seconds.

For more infomrmation about this attribute, see http://docs.oracle.com/cd/E18283_01/server.112/e16545/xstrm_oci_intro.htm#CEGDICBB.

This field appears only when the CDC mode is XStream.

Idle timeout(seconds)

Specify the value for the OCI_ATTR_XSTREAM_IDLE_TIMEOUT attribute for the outbound server. The default value is 1 second.

For more information about this attribute, see http://docs.oracle.com/cd/E18283_01/server.112/e16545/xstrm_oci_intro.htm#CEGDICBB.

This field appears only when the CDC mode is XStream.

tStatCatcher Statistics

Select this check box to collect the log data at component level.

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

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

Global Variables 

NB_LINE: the number of rows processed. This is an After variable and it returns an integer.

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 more information about variables, see Using contexts and variables.

Usage rule

This component is used as a start component. It requires an output component and row Main link.