Connections > Connection properties > Oracle connection properties
  

Oracle connection properties

When you create an Oracle connection, you must configure the connection properties.
The following table describes the Oracle connection properties:
Connection property
Description
Runtime Environment
The name of the runtime environment where you want to run the tasks.
Specify a Secure Agent, Hosted Agent, or serverless runtime environment.
User Name
User name for the database login. The user name cannot contain a semicolon.
Password
Password for the database login. The password cannot contain a semicolon.
Host
Name of the machine that hosts the database server.
Port
Network port number used to connect to the database server. Default is 1521.
Service Name
Service name or System ID (SID) that uniquely identifies the Oracle database.
Specify the SID in the following format to connect to Oracle databases:
SID:<ORACLE_SID>
Schema
Schema used for the Oracle connection.
Code Page
The code page of the database server.
Encryption Method
The method that the Secure Agent uses to encrypt the data exchanged between the Secure Agent and the database server.
Not applicable when you use the Hosted Agent or the serverless runtime environment.
Crypto Protocol Version
Cryptographic protocols to use when you enable SSL encryption.
Not applicable when you use the Hosted Agent or the serverless runtime environment.
Validate Server Certificate
Validates the certificate that is sent by the database server. If you specify the HostNameInCertificate parameter, the Secure Agent also validates the host name in the certificate.
Trust Store
The location and name of the trust store file.
For the serverless runtime environment, specify the following certificate path in the serverless agent directory:
data2/home/cldagnt/SystemAgent/serverless/configurations/ssl_store/<TrustStore_filename>
Trust Store Password
The password to access the contents of the trust store file.
Host Name in Certificate
Host name of the machine that hosts the secure database.
If you specify a host name, the Secure Agent validates the host name included in the connection with the host name in the SSL certificate.
Key Store
The location and the file name of the key store.
For the serverless runtime environment, specify the following certificate path in the serverless agent directory:
data2/home/cldagnt/SystemAgent/serverless/configurations/ssl_store/<KeyStore_filename>
Key Store Password
The password for the key store file required for secure communication.
Key Password
The password for the individual keys in the key store file required for secure communication.
Connection Retry Period
Number of seconds the Secure Agent attempts to reconnect to the Oracle database if the connection fails. If the Secure Agent cannot connect to the database in the retry period, the operation fails.
Used for all operations. Default is 0.
Metadata Advanced Connection Properties
The additional properties for the JDBC driver to fetch the metadata. If you specify more than one property, separate each key-value pair with a semicolon.
For example, ConnectionRetryCount=2;
ConnectionRetryDelay=20
To connect to an Oracle database enabled for advanced security, you can specify the Oracle advanced security options for the JDBC driver.
For example, EncryptionTypes=AES256;
EncryptionLevel=accepted;DataIntegrityLevel=accepted;
DataIntegrityTypes=SHA1
Runtime Advanced Connection Properties
The additional properties for the ODBC driver for running mappings. If you specify more than one property, separate each key-value pair with a semicolon.
For example, charset=sjis;readtimeout=180
To connect to an Oracle database enabled for advanced security, you can specify the Oracle advanced security options for the ODBC driver.
For example, EncryptionTypes=AES256;EncryptionLevel=1;
DataIntegrityLevel=1;DataIntegrityTypes=SHA1;
DataIntegrityTypes=SHA1
You can configure the following Oracle-specific custom properties under the Secure Agent configuration properties:
Custom property
Description
OdbcDataDirectNonWapi
For replication tasks, synchronization tasks, mappings, and mapping tasks that use relational multibyte data, add the OdbcDataDirectNonWapi property and set the property to 0 to process Unicode data.
Note: When you set this property to 0, the processing time of single-byte data might increase.
Enter the following values:
  • - For Type, select DTM.
  • - For Sub-type, select INFO.
  • - For Name, enter OdbcDataDirectNonWapi.
  • - For Value, enter 0.
oracle.use.varchar.for.number
For replication tasks, synchronization tasks, mappings, and mapping tasks that have an Oracle source and a Salesforce target, set the oracle.use.varchar.for.number custom property if the Oracle source contains many fields with the Number data type. Values for fields with the Number data type do not load correctly in Salesforce. Enter the following values:
  • - For Type, select Tomcat.
  • - For Name, enter oracle.use.varchar.for.number.
  • - For Value, enter true.