Oracle Sources > Before you begin > Create a connection
  

Create a connection

Before you configure the Oracle catalog source, create a connection object in Administrator.
    1In Administrator, select Connections.
    2Click Add Connection.
    3Search for and select Oracle and then click Next.
    4Enter the following connection details:
    Property
    Description
    Connection Name
    Name of the connection.
    Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
    Maximum length is 255 characters.
    Description
    Description of the connection. Maximum length is 4000 characters.
    5Enter properties specific to the Oracle connection:
    Property
    Description
    Use Secret Vault
    Stores sensitive credentials for this connection in the secrets manager that is configured for your organization.
    This property appears only if secrets manager is set up for your organization.
    When you enable the secret vault in the connection, you can select which credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured.
    Note:
    If you’re using this connection to apply data access policies through pushdown or proxy services, you cannot use the Secret Vault configuration option.
    For information about how to configure and use a secrets manager, see Secrets manager configuration.
    Runtime Environment
    The name of the runtime environment where you want to run the tasks.
    Select a Secure Agent, Hosted Agent, or serverless runtime environment.
    Oracle Subtype
    The Oracle connection subtype that you can use to connect to Oracle on-premises or Oracle Autonomous Database.
    Select one of the following options:
    • - Oracle ADB. Connects to Oracle Autonomous Database.
    • - Oracle On-premise. Connects to Oracle on-premises.
    6Select the authentication type to connect to the Oracle source system and enter the connection properties.
    You can select one of the following authentication types:
    Note:
    You can't configure LDAP authentication when you connect to Oracle databases.
    7Click Test.
    8Click Save.

Oracle Database authentication

Oracle Database authentication uses the Oracle user name and password to connect to Oracle.
The following table describes the basic connection properties:
Property
Description
User Name
The user name to connect to the Oracle database. The user name can't contain a semicolon.
Password
The password for the Oracle database login. The password can't contain a semicolon.
Host
Name of the machine that hosts the Oracle database.
Port
Network port number used to connect to the Oracle database.
Default is 1521.
Service Name
Service name or System ID (SID) that uniquely identifies the Oracle database.
Specify the SID in the following format:
SID:<ORACLE_SID>
Schema
The schema name to select tables during object selection in a mapping.
If you want to select tables from multiple schemas, leave the field blank. When left blank, all schemas you have access to are displayed and you can select tables from the available schemas.
Code Page
The code page of the database server.
The following table describes the advanced connection properties:
Property
Description
Encryption Method
The method that the Secure Agent uses to encrypt the data exchanged between the Secure Agent and the database server.
Default is No Encryption.
This property doesn't apply if you use the Hosted Agent.
Note:
If you configure the Oracle ADB subtype, you must select an encryption option other than No Encryption.
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.
Note:
Select TLSv1.2 if you configured the Oracle ADB connection subtype.
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 truststore file.
For the serverless runtime environment, specify the following certificate path in the serverless agent directory:
/home/cldagnt/SystemAgent/serverless/configurations/ssl_store/<TrustStore_filename>
Trust Store Password
The password to access the contents of the truststore 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 keystore.
Specify the location of the keystore file in the following format: /*/cwallet.sso
You can download the keystore file from Oracle Cloud Infrastructure.
Key Store Password
The password for the keystore file required for secure communication.
Key Password
The password for the keys in the keystore 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 can't connect to the database in the retry period, the operation fails.
Default is 0.
Metadata Advanced Connection Properties
Additional properties for the JDBC driver to fetch the metadata. Enter properties in the following format:
<parameter name>=<parameter value>
If you enter more than one property, separate each key-value pair with a semicolon.
For example, enter the following property to configure the connection timeout when you test a connection:
LoginTimeout=<value_in_seconds>
Note:
The default connection timeout is 270 seconds.
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
Additional properties for the ODBC driver to run 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

Kerberos authentication

When you choose this option on Windows, ensure that the user account that starts the Secure Agent service is available in the Oracle database. You don't need to enter your credentials to access Oracle database.
Note:
You can't configure Kerberos authentication when you use a Hosted Agent or serverless runtime environment.
The following table describes the basic connection properties for Kerberos authentication:
Property
Description
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 name to select tables during object selection in a mapping.
If you want to select tables from multiple schemas, leave the field blank. When left blank, all schemas you have access to are displayed and you can select tables from the available schemas.
Code Page
Code page of the database server.