DBeaver
You can run SQL from DBeaver to explore your data in your data lakes and relational databases through Dremio and the JDBC driver for Arrow Flight SQL.
If you want to use DBeaver with the legacy JDBC driver, see the instructions here.
Supported Versions
You can use any version of DBeaver, as long as you use Dremio 21 or later.
Supported Authentication Methods
You can use your Dremio username and password, or you can use a personal access token (PAT) that you obtained from Dremio.
Prerequisites
- Download the JDBC driver for Arrow Flight SQL.
- If you want to authenticate your connection to Dremio by using a personal access token, see Creating a PAT for the steps to obtain one.
Connecting to Dremio
-
In DBeaver, add the JDBC driver for Arrow Flight SQL as a new driver. You need to do this only once, and can skip this step if DBeaver already lists this driver in its Driver Manager dialog:
a. In the menubar, select Database > Driver Manager.
b. In the Driver Manager dialog, click New.
c. In the Settings section, follow these steps:
-
In the Name field, specify a name for the driver, such as "JDBC Driver for Arrow Flight SQL".
-
In the Driver Type field, ensure that Generic is the selected driver type.
-
In the Class Name field, specify
org.apache.arrow.driver.jdbc.ArrowFlightJdbcDriver
. -
In the URL Template field, specify
jdbc:arrow-flight-sql://{host}:{port}
. -
In the Default Port field, specify
32010
.
d. In the Libraries section, click Add File and select the
.jar
file for the JDBC driver for Arrow Flight SQL.e. Click OK.
-
-
Create a connection to Dremio that uses the driver:
a. Select Database > New Connection from JDBC URL.
b. In the Create New Connection from JDBC URL dialog, type
jdbc:arrow-flight-sql://<hostname>:32010
, where<hostname>
is the hostname of your coordinator node. DBeaver lists the driver in the Drivers field.c. Select the driver and click Next.
d. In the Connect to a Database dialog, provide your authentication credentials by following either of these sets of steps:
-
To use a personal access token that you obtained from Dremio:
-
In the Username field, specify the username for which the PAT was generated.
-
In the Password field, paste your personal access token.
-
-
To use your Dremio username and password:
-
In the Username field, specify your username.
-
In the Password field, your password.
-
e. If connections to Dremio Software will not be encrypted, add the
useEncryption
property as a driver property, and set the value tofalse
. The default for this property istrue
.f. (Optional) Click Test Connection. If the connection works, the Connection Test dialog opens and indicates that DBeaver is able to connect to Dremio. The connection is not held open. Click OK.
g. Click Finish.
-