SQL Workbench

This section explains how to use SQL Workbench with Exasol.

Exasol takes no responsibility for any changes in functionality or terms of use for the third-party software described in this section. For more information, refer to the respective software vendor’s website.


The following procedure uses SQL Workbench standard edition on Windows.


  • A running Exasol SaaS database. For more information, see Manage Database and Clusters.
  • The IP address of the host where the tool is running must be in the allowed IP address list. For more information, see Network Security.
  • Exasol JDBC driver is installed
  • Java Runtime Environment (JRE) installed

Get JDBC Driver and Connection Details

To connect to your Exasol SaaS database from a tool you need a valid connection string. You must also allow network access to the database from the tool, and make sure that the latest Exasol JDBC driver is installed.

  1. On the Databases page in the web console, click on Connect via tools on the cluster that you want to connect to.

    connect via tools

  2. In the wizard, enter the IP address of the client or server that will connect to the database and click Add IP, then click Next. This will add the IP address to the list of IP addresses that are allowed network access to the cluster. The allow list is found on the Security page in the web console. For more information, see Network Security.

    If the IP address is already present in the allow list, just click Next.

    enter ip address

  3. If the latest JDBC driver for your operating system is not already installed, select the driver type and operating system and click on Download to download the latest driver to your local system. For more information about how to install the driver, see JDBC Driver.

    download driver

  4. Click on Next to view your connection details:

    connection details

  5. Copy the Connection string, Port, and User name values from the Connect details dialog. You will need to enter this information in your client to connect to your database.

  6. To generate a new Personal Access Token (PAT) to use for authentication in the client, click on the Password row, then click on Copy to copy the PAT to your clipboard. For more information, see Personal Access Token.

    generated pat

    The generated PAT is only shown once and cannot be retrieved after you have closed the wizard.

  7. Click on Done to close the wizard.

Connect SQL Workbench to Exasol

  1. Launch SQL Workbench and provide the following details in the Select Connection Profile dialog. Alternatively, select File > New Window and provide the details;
  • Default group name: Exasol
  • Driver: Select EXASolution (com.exasol.jdbc.EXADriver) from the Driver drop-down.

    Connect SQL Workbench to Exasol

The Exasol driver does not come integrated with SQL Workbench. On selection in the Driver drop-down, it shows a message for editing the driver. Click OK in the message box to edit the driver.

  1. Click Open and provide the path of the JDBC driver installation directory and click OK to continue. For example, C:\Program Files (x86)\Exasol\EXASolution-7.1\JDBC\exajdbc.jar

  1. Provide the following details in the Select Connection Profile dialog:
  • Exasol installation URL with jdbc:exa: prefix
  • Username and personal access token (PAT) for the Exasol user

    To test the connection settings, click on Test. If the connection is successful, click on OK to continue.