UnityJDBC Data Virtualization with Aqua Data Studio

Aqua Data Studio can query multiple databases with different SQL queries. However, you cannot query more than one database at the same time in one SQL query. UnityJDBC allows a user to write one query to join, aggregate, and summarize data across any number of databases. It also performs translation of SQL dialects and functions.


This example assumes that the installation of UnityJDBC has already been completed. The following is an example of creating sources and executing multiple database queries with Aqua Data Studio.

  1. Create a New Source Group - Under File Menu, Select New Source Group.

    Aqua Example: Creating a New Source Group Data Virtualization

  2. Select Sources File Name and Location - Use the default sources.xml or select a file location.

    Aqua Example: Specifying a Source File Location

  3. Select New Source - Under File Menu, Select New Source.

    Aqua Example: Creating a New Source

  4. Add a Microsoft Database - Enter connection information for Microsoft SQL Server to add it to the data virtualization.

    Aqua Example: Adding a Microsoft SQL Server Database to the Data Virtualization

  5. Add a MySQL Database - Enter connection information for MySQL database to add it to the data virtualization.

    Aqua Example: Adding a MySQL Database to the Data Virtualization

  6. Viewing Data Virtualization of Sources - Select Exit to return to the main screen and see data virtualization of MySQL and Microsoft SQL Server sources.

    Aqua Example: Resulting Data Virtualization of Two Database Sources

  7. Multiple Database Query and Cross-Database Join Example - Type in a cross-database query and execute it to view results.

    Aqua Example: Executing a Cross-Database Join of Two Databases

  8. Finding Sources and Schema Files - Now that the data virtualization is complete, find the sources.xml file and schema files for your sources. The image below shows the default location which would be inside the UnityJDBC installation directory.

    Aqua Example: Finding Source and Schema Files

  9. Moving Sources and Schema Files - Optionally, move the sources and schema files to a permanent location. In this example, they are moved to C:/unityjdbc.

    Aqua Example: Moving Source and Schema Files to Another Location

  10. Adding UnityJDBC data source to Aqua Data Studio - Copy unityjdbc.jar and all JDBC drivers for databases into jre/lib/ext in Aqua Installation directory.

    Aqua Example: Installing unityjdbc.jar in Aqua Data Studio

  11. Start Aqua and Register a Generic JDBC Source - The configuration information is:

    • Driver: unity.jdbc.UnityDriver

    • URL: jdbc:unity://<path to sources.xml file>

    Aqua Example: Adding a UnityJDBC Virtual Data Source in Aqua Data Studio

  12. Multiple Database Query in Aqua Data Studio - Create a query like usual except it can contain multiple databases.

    Aqua Example: Executing a Multiple Database Join Query and Displaying Results

  13. Function and SQL Dialect Translation with Aqua Data Studio - Forget what functions you can use on each database? No problem – UnityJDBC will translate automatically. This translation is supported for common databases and can be freely extended by user-defined functions and translations for each database dialect.

    Aqua Example: Performing SQL Dialect and Function Translation