Zoomdata Version

Managing the Oracle Connector

The Zoomdata Oracle connector lets you access the data available in Oracle databases for visualization and exploration using the Zoomdata client. The Zoomdata Oracle connector supports Oracle versions 11.2 - 18.3.

Before you can establish a connection from Zoomdata to Oracle storage, a connector server needs to be installed and configured. See Managing Connectors and Connector Servers for general instructions and Connecting to Oracle for details specific to the Oracle connector.

After the connector has been set up, you can create data source configurations that specify the necessary connection information and identify the data you want to use. See Managing Data Source Configurations for more information. After data sources are configured, they can be used to create dashboards and charts from your data. See Creating Dashboards and Creating Charts.

Zoomdata Feature Support

The Oracle connector supports all Zoomdata features, except for the following features:

Connecting to Oracle

The Oracle connector requires a JDBC driver to be configured before you can connect to your data source. You can download the driver from the vendor's site. If you are upgrading, keep in mind you need to configure the JDBC driver- see Upgrading the Zoomdata Server for instructions. For more information and steps, see Adding a JDBC Driver.

When setting up a connection to Oracle, provide the following.

  • Specify the connection name and JDBC URL. The JDBC URL for Oracle database being connected must be: jdbc:oracle:thin@//ORACLEHOST:PORT/DATABASE_NAME or jdbc:oracle:thin:@ORACLEHOST:PORT:SID

    To connect to Oracle with TLS enabled, see Connecting to Oracle with TLS Enabled.

  • Provide the user name and password for Oracle database.

  • You can use an Impersonation feature to work with Oracle data source on behalf of a proxy user. Before you begin, you must configure proxy users with the corresponding privileges in the Oracle database. To use this, select the Impersonation Enabled check box and specify the Impersonation Username and Impersonation Password. See Configuring Settings to Use a Proxy User.

  • If you need to use Zoomdata's Oracle connector to access a table that uses the XML data type, complete the additional setup steps described in Enabling Access to Oracle Tables That Use the XML Data Type.

If there are any changes in the Oracle database, you must clear the Zoomdata cache. See How Zoomdata Caches Data.

Connecting to Oracle with TLS Enabled

Before you attempt to connect to Oracle with TLS enabled, make sure you have first installed Java Cryptography Extension (JCE). See https://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html.

To connect to Oracle with TLS enabled:

  1. Create a JDBC URL with TLS parameters. To specify TLS-related parameters, use the following template for a JDBC URL:

    jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=<oracle_host>)
    (PORT=<oracle_tls_port))CONNECT_DATA=(SID=<service_id>)))

    where:

    • <oracle_host> is the host of the Oracle database.
    • <oracle_tls_port> is the port of the Oracle database with TLS enabled
    • <service_id> is the Oracle service ID or database to which you want to connect

    Make sure your JDBC URL uses the correct protocol. For a TLS connection, you should use tcps.

  2. If your Oracle database is configured with a custom certificate, you should configure a truststore for the Oracle connector, as described in the following steps:

    1. Copy a truststore to the machine on which Zoomdata's Oracle connector is running.

    2. Add the following lines to file /etc/zoomdata/edc-oracle.jvm. Copy the file edc-oracle.jvm from the /opt/zoomdata/conf directory if a copy is not in /etc/zoomdata/.

      -Djavax.net.ssl.trustStore=<path_to_truststore>
      -Djavax.net.ssl.trustStorePassword=<truststore_password>

      where:

      • <path_to_truststore> is the absolute path to your truststore
      • <truststore_password> is the password for your truststore
  3. Restart the Oracle connector microservice, zoomdata-edc-oracle. See Restarting Zoomdata Microservices.

Configuring Settings to Use a Proxy User

To enable a Zoomdata user work as a proxy user, specify the user attributes of corresponding oracle user (that will be used as proxy user) in the account details of a Zoomdata user.

You must specify the user attributes for each Zoomdata user that will access the Oracle data source as a proxy user.

Perform the following steps:

  1. Select Settings and then select Users & Groups.
  2. Select a user from the list and click the Custom Attributes tab.
  3. Select Add Custom Attribute. Specify credentials for a user as follows:
  • Key - specify the login attribute for proxy user. Corresponding reference name is listed in the Usage column. You have to specify the value from the Usage column in the Impersonation Username field while creating a connection.
  • Value - specify the actual name of the oracle user, that you want to use as proxy user.
  • Select the checkbox in the Secure column to encrypt the value of the key.
  1. If the proxy user requires a password, click Add Custom Attribute and specify the key and value for the password. You have to specify the reference name from the Usage column in the Impersonation Password field while creating the connection.

Enabling Access to Oracle Tables That Use the XML Data Type

Before you enable access to Oracle tables that use the XML data type, be sure you have set up the Oracle JDBC driver. See Adding a JDBC Driver.

To enable access to Oracle tables that use the XML data type:

  1. Download the xdb6.jar and xmlparserv2.jar files from Oracle to the corresponding Zoomdata instance. You can download obtain xdb6.jar by downloading it from https://www.oracle.com/technetwork/database/features/jdbc/jdbc-ucp-122-3110062.html. You can obtain xmlparserve2.jar by extracting it from the lib directory in the Oracle XML Developers Kit, which can be downloaded from https://www.oracle.com/technetwork/database/database-technologies/xmldb/downloads/index-100632.html.

    Place these files in the following folder: /usr/local/share/java/zoomdata.

    Note that this is the same folder where you downloaded the Oracle JDBC driver (see Adding a JDBC Driver).

  2. Add the following lines to the connector JVM file in /etc/zoomdata/edc-oracle.jvm:

    -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl
    -Djavax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl
  3. Restart the Oracle connector microservice, zoomdata-edc-oracle. See Restarting Zoomdata Microservices.

 

Was this topic helpful?