Catalog Source Configuration > Oracle PL/SQL Script > Before you begin
  

Before you begin

Before you create a catalog source, ensure that you have the information required to connect to the source system.
Ensure that the following prerequisites are met:

Verify permissions

To extract Oracle PL/SQL Script metadata, you need account access and permissions to the Oracle PL/SQL Script catalog source and the Oracle Database source system.
Verify that the administrator has the following permissions:

Create a connection

Before you configure the Oracle PL/SQL Script catalog source, create a connection object in Administrator.
    1In Administrator, select Connections.
    2Click New Connection.
    3In Connection Details, enter the following connection details:
    Property
    Description
    Connection Name
    Name of the Oracle PL/SQL Script connection. Must be unique within the organization.
    Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -
    Maximum length is 100 characters.
    Connection names are not case sensitive.
    Description
    Optional description of the connection.
    Maximum length is 255 characters.
    Type
    Type of connection. Ensure that the type is Oracle.
    4In Oracle Connection Properties, enter properties specific to the Oracle PL/SQL Script connection:
    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.
    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.
    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.
    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.
    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 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.
    Key Password
    The password for the individual 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.
    Used for all operations. Default is 0.
    Metadata Advanced Connection Properties
    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
    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
    5Click Test Connection.
    The results of the test appear on the page.
    6Click Save.