Before you begin

Before you create a catalog source, ensure that you have the information required to connect to the source system.

Perform the following tasks:

•Assign the required permissions.

•Configure an Oracle connection to connect to the master and work repository of the Oracle Data Integrator source system in Administrator.

•If your Oracle database is SSL-enabled, specify appropriate values for the Trust Store and Key Store fields in the Oracle connection properties. Test Connection to an SSL-enabled Oracle database fails if either the truststore or keystore value is not specified in the connection properties.

•Create endpoint catalog sources for connection assignment.

Verify permissions

To extract metadata and to configure other capabilities that a catalog source might include, you need account access and permissions on the source system. The permissions required might vary depending on the capability.

Permissions to extract metadata

Ensure that you have the required permissions to enable metadata extraction.

Grant the following permissions:

•CONNECT permission for the database user account that you use to access the Oracle database.

• One of the following permissions:

- Grant a predefined SELECT_CATALOG_ROLE role
- Grant permissions that allow you to perform the following operations:

▪ select on SYS.DBA_ARGUMENTS
▪ select on SYS.DBA_COL_COMMENTS
▪ select on SYS.DBA_COLL_TYPES
▪ select on SYS.DBA_CONS_COLUMNS
▪ select on SYS.DBA_CONSTRAINTS
▪ select on SYS.DBA_DB_LINKS
▪ select on SYS.DBA_DIRECTORIES
▪ select on SYS.DBA_EXTERNAL_LOCATIONS
▪ select on SYS.DBA_EXTERNAL_TABLES
▪ select on SYS.DBA_MVIEWS
▪ select on SYS.DBA_OBJECTS
▪ select on SYS.DBA_OPBINDINGS
▪ select on SYS.DBA_SEQUENCES
▪ select on SYS.DBA_SOURCE
▪ select on SYS.DBA_SYNONYMS
▪ select on SYS.DBA_TAB_COLUMNS
▪ select on SYS.DBA_TAB_COMMENTS
▪ select on SYS.DBA_TABLES
▪ select on SYS.DBA_TRIGGERS
▪ select on SYS.DBA_TYPE_ATTRS
▪ select on SYS.DBA_USERS
▪ select on SYS.DBA_VIEWS
▪ select on SYS.NLS_SESSION_PARAMETERS
▪ select on V$PARAMETER

Create a connection

Before you configure the Oracle Data Integrator catalog source, create a connection object in Administrator.

1In Administrator, select Connections.

2Click New Connection.

3Enter 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.
Type	Type of connection. Select Oracle from the list.

4Enter properties specific to the Oracle connection:

Property	Description
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.
User Name	User name for the database login. The user name can't contain a semicolon.
Password	Password for the database login. The password can't 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. Required when you configure an Oracle Data Integrator catalog source.
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. Default is No Encryption. This property doesn't apply if you use the Hosted Agent.
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 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. For the serverless runtime environment, specify the following certificate path in the serverless agent directory: /home/cldagnt/SystemAgent/serverless/configurations/ssl_store/<KeyStore_filename>
Key Store Password	The password for the keystore file required for secure communication.
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 . 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

5Click Test Connection.

6Click Save.

Create endpoint catalog sources for connection assignment

An endpoint catalog source represents a source system that the catalog source references. Before you perform connection assignment, create endpoint catalog sources and run the catalog source jobs.

You can then perform connection assignment to reference source systems and run connection-aware scans to view complete lineage with source system objects.

Note: When you create an Oracle endpoint catalog source, configure a different Oracle connection than the one used for the Oracle Data Integrator catalog source. If you use the same Oracle connection and run the Oracle Data Integrator catalog source again after connection assignment, you can't view the lineage of data elements.