Cockroach JDBC Driver & How to Connect

DbSchema is connecting to Cockroach using JDBC Drivers.

  1. What are JDBC Drivers
  2. What is the JDBC URL
  3. Download the Cockroach JDBC Driver
  4. How to Connect using the DbSchema Cockroach

What are JDBC Drivers?

JDBC drivers are Java library files with the extension '.jar', used by Java applications to connect to the database. Usually they are provided by the same company which developed the database software. DbSchema is an Cockroach Client which already includes the Cockroach JDBC driver. DbSchema can configure the Cockroach JDBC URL and test the connectivity.

What is the JDBC URL?

The URL is a string (text) with a specific format containing information about the host where the database is running, the port, username, database name, etc. The URL format is specific to each driver. Any wrong character in the URL may make the database connectivity fail. Therefore we recommend installing DbSchema and try to get connected, and you will find the JDBC URL in the connection dialog.

Driver Information

  • Required File(s): postgresql-nn.jdbc3.jar
  • Java Driver Class: org.postgresql.Driver
  • URL: jdbc:postgresql://HOST[:PORT]/DB
  • Website: Cockroach

Download Cockroach JDBC Driver

The driver files are compressed in a zip file.

Please write to us if this version of the driver is not the latest, we will update it !

Connect to Cockroach using DbSchema

DbSchema is using JDBC Drivers to connect to the database. Installing the application you can easy set up a connection. DbSchema will build the JDBC URL for you.
  1. 1 Download DbSchema. DbSchema has a free community edition. No email or registration is required.
  2. 2 Choose to connect to the database, and choose Cockroach. Connect to database
  3. 3 Connection-dialog

    At this point, DbSchema already downloads the JDBC driver into this folders:

    • C:\Users\YourUser\.DbSchema\drivers\Cockroach (Windows) or
    • /Users/YourUser/.DbSchema/drivers/Cockroach (Linux and MacOS).

    In the Connection Dialog, select the driver and the JDBC URL template. For databases using multiple possibilities to connect, may exists multiple templates. Choose if the database is running on the current machine or a different port. If is running on a different machine (remote), you need to find the host name. Hover the Host info label using the mouse to get instructions.

  4. 4 Press the Ping button to test the connectivity.
  5. 5 Edit JDBC URL In the URL combo there is an option to 'Manually Edit the URL'. Select this option to see the generated JDBC URL.
  6. 6 DbSchema Layouts After connecting, DbSchema will create the first diagrams (layouts). Double-click any table header or column to edit.
  7. 7 SQL Editor Activate the SQL Editor from the menu to edit and execute queries. For a detailed list of features, please read the DbSchema Quick Tour.