JDBC V2 Connector

Back Next

JDBC V2 sources in mappings

When you configure a mapping to use a JDBC V2 source, you can configure the source properties.

Specify the name and description of the JDBC V2 source. Configure the source and advanced source properties for the JDBC V2 object.

You can parameterize the source and advanced source properties for the JDBC source object in a mapping.

You can also parameterize the JDBC V2 source connection and source object with values specified in a parameter file when you configure a mapping in advanced mode.

The following table describes the JDBC V2 source properties that you can configure in a Source transformation:

Property	Description
Connection Name	Name of the source connection.
Source Type	Source type. Select one of the following source types: Single Object . Select to specify a single JDBC V2 object. Multiple Objects . Select to specify multiple JDBC V2 objects. Use the advanced relationship option to define the relationship for the objects that you want to join. Parameter . Select to specify a parameter name. You can configure the source object in a mapping task associated with a mapping that uses this Source transformation. Query . Select to define a valid and supported SQL query in the Source transformation.
Object	Source object for the mapping.
Filter	A simple filter or an advanced filter condition to remove rows at the source. You can improve efficiency by filtering early in the data flow. Specify a simple filter by including a field name, operator, and value. Configure an advanced filter to define a more complex filter condition that can include multiple conditions using the AND or OR logical operators. You can choose from the following filter conditions: Not parameterized . Use a basic filter to specify the object, field, operator, and value to select specific records. Completely parameterized . Use a parameter to represent the field mapping. Advanced . Use an advanced filter to define a more complex filter condition.
Sort	Not applicable.

The following table describes the JDBC advanced source properties that you can configure in a Source transformation:

Advanced Source Property	Description
Pre SQL	The SQL query that the Secure Agent runs before reading data from the source.
Post SQL¹	The SQL query that the Secure Agent runs after reading data from the source.
Fetch Size	The number of rows that the Secure Agent fetches from the database in a single call.
Table Name	Overrides the table name used in the metadata import with the table name that you specify.
Schema Name	Overrides the schema name of the source object. If you specify the schema name both in the connection and the source properties, the Secure Agent uses the schema name specified in the source properties.
SQL Override	The SQL statement to override the default query and the object name that is used to read data from the JDBC V2 source.
Tracing Level	Determines the amount of details that logs contain. You can select one of the following tracing levels: Terse . The Secure Agent logs initialization information, error messages, and notification of rejected data. Normal . The Secure Agent logs initialization and status information, errors encountered, and skipped rows due to transformation row errors. Summarizes session results, but not at the level of individual rows. Verbose Initialization . In addition to normal tracing, the Secure Agent logs additional initialization details, names of index and data files used, and detailed transformation statistics. Verbose Data . In addition to verbose initialization tracing, the Secure Agent logs each row that passes into the mapping. Also notes where the Secure Agent truncates string data to fit the precision of a column and provides detailed transformation statistics. When you configure the tracing level to verbose data, the Secure Agent writes row data for all rows in a block when it processes a transformation.
¹Doesn't apply to mappings in advanced mode.