Connect to SQL Workbench/J

This article describes how to use SQL Workbench/J with Databricks.

Step 1: Get Databricks connection information

  1. Get a personal access token.

    Note

    As a security best practice, when authenticating with automated tools, systems, scripts, and apps, Databricks recommends you use access tokens belonging to service principals instead of workspace users. For more information, see Service principals for Databricks automation.

  2. Get the server hostname, port, and HTTP path.

Step 2: Configure Databricks cluster connection in Workbench/J

  1. Launch SQL Workbench/J.

  2. Select File > Connect window.

  3. In the Select Connection Profile dialog, click Manage Drivers.

    1. In the Name field, type Spark JDBC.

    2. In the Library field, click the Select the JAR file(s) icon. Browse to the directory where you downloaded the Simba Spark JDBC driver JAR.

    3. Verify that the Classname field is populated.

      Spark JDBC driver
    4. Click OK.

  4. Click the Create a new connection profile Connection Profile Icon icon.

    1. Type a name for the profile.

    2. In the Driver field, select com.simba.spark.jdbc.Driver.

    3. In the URL field, enter the URL you constructed in Step 1.

    4. In the Username field, enter token.

    5. In the Password field, enter your personal access token from Step 1.

      Connection profile
    6. Click Test.

      Connection test
    7. Click OK twice.