Advanced Query Tool

This section explains how to connect Advanced Query Tool (AQT) to an Exasol database.

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.

Environment

The following procedure uses the evaluation version of AQT v10 on Windows.

Prerequisites

  • A running Exasol SaaS database. For more information, see Manage Databases 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 ODBC driver is installed
  • AQT client is installed

Get ODBC Driver and Connection Details

To connect to your Exasol SaaS database from this 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 ODBC 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 ODBC 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 ODBC 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 the AQT Client

  1. Launch AQT.

    Connect AQT to Exasol

  1. Click on Add new Datasource and select EXASolution Driver.

    Connect AQT to Exasol

  1. In the Exasol ODBC configuration dialog, enter the following details:
    • Data source name: Exasol
    • Connection string: IP address of the Exasol database

    • User name and password: The database username and personal access token (PAT).

      Connect AQT to Exasol

  1. Click on Test connection to verify that the connection configuration works. If the test is successful, click on OK.

  2. To connect to Exasol, enter the database username in Userid and the PAT in Password.

    Connect AQT to Exasol

  1. After a successful connection, the database details are displayed in the left tree as shown below.

    Connect AQT to Exasol

You can now run SQL queries on your Exasol database using AQT. For more information on how to use AQT, refer to the AQT Documentation.