SQuirreL SQL

You can use SQuirreL SQL to interface with the OmniSci Core Database.

SQuirreL SQL client is a graphical Java program for performing common tasks such as viewing the structure of a JDBC-compliant database, browsing data in tables, and issuing SQL commands.

For more information about SQuirreL SQL, see http://squirrel-sql.sourceforge.net.

Installing SQuirreL SQL

  1. Download the OmniSci JDBC Driver. You can find the OmniSci JDBC Driver in $MAPD_PATH/bin/mapdjdbc-1.0-SNAPSHOT-jar-with-dependencies.jar. Alternatively, you can download the latest JDBC driver from https://s3-us-west-2.amazonaws.com/mapd-artifact/mapdjdbc-1.0-SNAPSHOT-jar-with-dependencies.jar.

  2. Verify that Java is installed on your client:

    • On Windows, navigate to Control Panel > Programs > Programs and Features.
    • On OSX, navigate to System Preferences > Java and click About....

  3. Download SQuirreL SQL

    Download the version of SQuirreL SQL for your platform from http://squirrel-sql.sourceforge.net.

  4. Follow the instructions on the SQuirreL SQL website to install SQuirreL SQL.

Configuring SQuirreL SQL for the OmniSci JDBC Driver

Configure the OmniSci Driver

  1. Open SQuirreL SQL.
  2. Click Drivers.
  3. Click + to add a new driver.
  4. Enter the Name for your driver. The name is an alias within SQuirreL for this driver.
  5. Enter the Example URL. For OmniSci, the required components are “jdbc”, “mapd”, a valid DNS name for a machine running OmniSci, the OmniSci port number, and the name of the OmniSci database. For example, jdbc:mapd:machine:9091:dbname. If you are not sure of these values, contact your system administrator.
  6. Enter the Website URL.
  7. Enter the Class Name: com.mapd.jdbc.MapDDriver.
  8. Click the Extra Class Path tab.
  9. Click Add and navigate to the directory where mapdjdbc-1.0-SNAPSHOT-jar-with-dependencies.jar is located.
  10. Click Open.
  11. Click OK.

Configure the OmniSci Alias

  1. Click Aliases.
  2. Click + to add a new Alias.
  3. Give the Alias a Name.
  4. Choose OmniSci as the Driver.
  5. Update the example URL with the specific URL for your OmniSci instance.
  6. Enter your User Name and Password.
  7. (Optional) Set Auto Logon.
  8. (Optional) Set Connect at Startup.
  9. Click Test to verify the connection.
  10. Click OK.