Connecting to Oracle
Zoomdata's Oracle connector lets you access the data stored in Oracle databases for visualization and exploration within the Zoomdata Client. Zoomdata supports Oracle
and later versions.
The table below lists information on the features that are supported by Oracle:
|Supports Distinct Count?||Yes|
|Supports Live Mode/ Playback?||Yes|
|Supports Group-by Time?||Yes|
|Supports Multi Group-by Charts?||Yes|
|Supports Box Plot?||Yes|
|Custom SQL Capable?||Yes|
|Supports Last Value?||No|
Starting with Zoomdata v2.5.3, the Oracle connector will require 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 will need to configure the JDBC driver (refer to the article Upgrading Zoomdata Server to v2.5 for instructions). For more information, refer to the Add a JDBC Driver article.
CONFIGURING THE CONNECTION
For details about what is provided on each page of the connection process, review the article Source Connection Workflow . Depending on your needs, you can either follow the steps in order from start to finish or jump to a specific section in the connection process:
- General Page
When the connector server is set up by the Zoomdata Administrator, certain parameters on the Connectors page may be customized. The instructions below assumes that the default configuration parameters were kept. If this is not the case, then your Connection page may differ slightly from the screen captures and references provided.
- Tables Page
- Fields Page
- Refresh Page
- Charts Page
Log into Zoomdata.
Administrators and users with appropriate access privileges can connect data sources in Zoomdata.
Specify the name of your source and add a description (if desired).
Click Next to continue to the next setup page.
This page defines the connection source for Zoomdata to be able to access the data source. If this is the first time setting up a connection, then you need to input the necessary credentials. If a validated connection already exists, you are given the option to use it.
- To create a new connection, select the Input New Credentials option.
- Enter a unique name for the connection (to help distinguish between other connections in this Zoomdata account).
Specify the connection name and JDBC URL. The JDBC URL for Oracle database being connected must be:
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 feature, select the Impersonation Enabled checkbox and specify the Impersonation Username and Impersonation Password . See how to configure settings for a proxy user below.
- Click Validate . If successfully validated, the connection is saved.
The Tables page lets you select the collection and table to connect with and provides a preview of the selected table. In addition, caching options and toggling the availability of the fields can be done on this page.
- Select the schema and then select the desired table to connect to Zoomdata.
- Create a Custom SQL query, if needed.
- Toggle the caching options (SparkIt and Caching) as needed (by default, SparkIt is disabled; access the article How Zoomdata Caches the Data for more information).
- Toggle the availability of the fields, as needed.
- Click Next to continue.
The Fields page lets you (1) configure attribute options, (2) create custom labels for the fields in your data source (that will be displayed in the charts), (3) manage the Volume metric, and (4) work with Calculations.
- Determine whether the field should be visible or not to the user.
- Create unique label names, as needed, for each Label field.
column, you have the option to edit the field type (although
usuallyyou won't need to do this).
column, numeric and time-based fields may be edited:
Numeric types including Money,
Numberand Integer - ability to select a default aggregation function
- Time fields - ability to define the default time pattern and granularity; if the time field provides granularities of hour, minute and second, then a time zone label may be applied
- Numeric types including Money,
- Select fields for Distinct Counts as needed.
- Configure Filter Display settings for fields.
- Edit the Volume Metric settings, as needed.
, if available and as needed.
If you are setting up a new connection, the Calculations section will not be available until after the connection is saved.
- Click Next to continue.
The Refresh page lets you schedule asynchronous jobs to update the source metadata. For guidance to set up a refresh schedule, refer to the article Using the Zoomdata Scheduler .
On the Charts page, you can:
- Edit Global Default Settings .
- Select the Standard and, if available, Custom chart styles to be used with the data source.
- Set default parameters (group, sub-group, colors, sorting, and so on) for each chart style.
Click Finish to save your changes. Once your data connection has been established, it is listed under the My Data Sources section of the page.
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:
- Click the icon and select Users & Groups .
- Select a user from the list and click the Custom Attributes tab.
- Click Add Custom Attribute . Specify credentials for a user as follows:
- Key - specify the login attribute for proxy user. Corresponding reference name will be 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.
- If the proxy user requires a password, click Add Custom Attribute and specify the key and value for the password. You will have to specify the reference name from the Usage column in the Impersonation Password field while creating the connection.