JDBC V2 Connector

JDBC V2 Connector

Rules and guidelines for JDBC V2 objects in mappings configured in advanced mode

Rules and guidelines for JDBC V2 objects in mappings configured in advanced mode

Consider the following rules and guidelines for JDBC V2 objects for mappings configured in advanced mode:
Unicode and special characters
  • When you import multiple source objects, ensure that the table and column names do not contain Unicode characters.
  • Ensure that the source or target table names and field names do not contain special characters.
  • When you import a JDBC V2 object and search for special characters, the search results do not display the objects.
  • The mapping fails when the target table name contains double quotes.
Schema names and table names
  • If you change the schema name in the connection, the updated schema name does not reflect in the user interface in the existing mapping object. However, the updated schema reflects at runtime.
  • When you join multiple Azure SQL Database tables, the schemas must have different table names.
Data types
  • When you preview the data for time(4), time(5) and time(6) data types, the data is truncated beyond precision 3.
  • Do not specify a filter in a mapping for the Azure SQL Database source that contains the Datetime data type.
  • When you read or write data that contains time(4), time(5), and time(6) data types, the data is truncated beyond precision 3.
  • When you write data that contains the Timestamp data type to a PostgreSQL or Azure SQL Database target using the
    Create New at Runtime
    option, the Timestamp data type value is appended with the time zone.
  • When you create a new Azure SQL or PostgreSQL Database target at runtime and the source data contains the Time data type, the Secure Agent writes the date time value until microseconds.
  • When you read from or write to an Oracle table that contains the Number data type, even though the precision does not exceed the maximum allowed value of 38, the mapping adds additional digits to the data. To avoid issues with the Number data type precision, select the
    Apply Custom Schema
    advanced property in the Source or Target transformations, based on the operation that you configure.
Parameterization
  • When you configure the field mapping and the source or target object is parameterized, set the field mapping to
    Automap
    . If you set the field mapping to
    Manual
    , the mapping does not run in advance mode.
  • You can't parameterize multiple JDBC V2 source objects.
Target operations
  • The number of fields in the source and target must be identical when you configure the update mode in the Target transformation.
  • To perform an update, upsert, delete, or data driven operation on the target, you must specify a column in the
    Update Columns
    field even though you define a primary key in the target table.
  • When you specify a column in the
    Update Columns
    field, the Secure Agent inserts rows that contain duplicate data and also updates or upserts data in the target table when both of the following conditions are true:
    • The source table contains columns that have duplicate data.
    • The target table does not have a primary key.
  • You can't use multiple PostgreSQL sources in a mapping when you perform an update, upsert, delete, or data driven operation on the target.
  • You can't perform an update, upsert, delete, or data driven operation on Oracle synonyms.
  • To perform a data driven operation on the target, ensure that the column selected in the
    Update Columns
    field does not contain duplicate or null values.
  • When you run a mapping with an Upsert or Data Driven target operation, the number of processed and failed rows for the target operation is not displayed on the
    Individual Task Results
    page.
Object metadata
  • To retain the same metadata in the target table after you perform an update, upsert, delete, or data driven operation on the target, select the
    Truncate Target
    option in the Target transformation.
Partitioning
When you configure partitioning for the source or target object that contains an Oracle synonym and the synonym contains a primary key, select the partition key in the
Fields
tab of the Source or Target transformation based on the operation that you configure.
Oracle synonym
You can't read from or write to a synonym of an Oracle synonym.

0 COMMENTS

We’d like to hear from you!