This section describes how to connect to CockroachDB following the standard JDBC connection process in DBeaver: Add the driver JAR, provide the driver class name, and provide any CockroachDB-specific parameters in the JDBC URL.
Add the JDBC Driver for CockroachDB
Complete the following steps to add the driver .jar file:
- Open the DBeaver application and, in the Database menu, select the Driver Manager option. Click New to open the Create New Driver form.
- In the Driver Name box, enter a user-friendly name for the driver.
To add the .jar file, click Add File on the Libraries tab. Select the cdata.jdbc.cockroachdb.jar file, located in the lib subfolder of the installation directory.
Note that the.lic file must be located in the same folder as the .jar file.
- Click Find Class, and in the list select, "cdata.jdbc.cockroachdb.CockroachDBDriver".
- In the URL Template field, enter jdbc:cdata:cockroachdb:.
Create the JDBC Data Source
Complete the following steps to select the CockroachDB driver and build the JDBC URL to create the JDBC data source:
- In the main DBeaver window, click Database > New Connection.
- Select the driver definition you created in the dialog that is displayed.
- On the next page of the wizard, click the Driver Properties tab.
Enter any connection properties required to connect to CockroachDB.
Here is a typical connection string:
jdbc:cdata:cockroachdb:User=root;Password=root;Database=system;Server=localhost;Port=26257See Establishing a Connection for a connection and authentication guide.
- Finish creating the connection with the default settings or configure advanced network settings -- proxy, firewall, and SSH.
Discover Schemas and Query CockroachDB Data
Complete the following steps to query information from the tables exposed by the connection:
- Expand the node for the connection to access the database metadata.
- Browse the table metadata and edit the table data by right-clicking a Table and then clicking Edit Table.
To execute an SQL query, select SQL Editor > New SQL Editor and select the CockroachDB connection you created. You can then enter queries using code completion.