SQuirreL SQL

You can use SQuirreL SQL to interface with the MapD 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 MapD JDBC Driver. You can find the MapD 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 MapD JDBC Driver

Configure the MapD 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 MapD, the required components are “jdbc”, “mapd”, a valid DNS name for a machine running MapD, the MapD port number, and the name of the MapD 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 MapD Alias

  1. Click Aliases.
  2. Click + to add a new Alias.
  3. Give the Alias a Name.
  4. Choose MapD as the Driver.
  5. Update the example URL with the specific URL for your MapD 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.