Connect with DBeaver

You can manage your SingleStore databases with DBeaver using the SingleStore JDBC driver.

Prerequisites

Connect with SingleStore from DBeaver

To connect to your cluster from DBeaver,

  1. In DBeaver, select Database > Driver Manager.

  2. On the Driver Manager dialog, select MariaDB > Copy. The Create New Driver dialog opens.

  3. In the Create new driver dialog, on the Settings tab, enter the following details:

    • Driver Name: Enter SingleStore.

    • Driver Type: From the list, select MySQL.

    • Class Name: Specify the Class Name for the SingleStore JDBC driver: com.singlestore.jdbc.Driver.

    • URL Template: Enter the following template:

      jdbc:singlestore://{host}[:{port}]/[{database}].

    • Default Port: The default is 3306.

  4. On the Libraries tab,

    1. Remove the existing MariaDB dependencies.

    2. Select Add file. Select the SingleStore JDBC driver .jar file downloaded earlier, and select Open.

      Alternatively, you can select Add Artifact, and then add the following dependency for the SingleStore JDBC driver under Dependency Declaration.

      <dependency>
      <groupId>com.singlestore</groupId>
      <artifactId>singlestore-jdbc-client</artifactId>
      <version>1.1.9</version>
      </dependency>

      Update the version in the dependency declaration with the latest version.

  5. Select OK. The SingleStore driver is now configured in DBeaver.

  6. In DBeaver, select New Database Connection > SingleStore.

  7. On the Connect to a database dialog, enter the connection settings for your SingleStore cluster. Select Test Connection to test your connection.

The connection is now configured, and you can connect to your SingleStore databases from DBeaver.

Last modified: April 1, 2024

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

  1. (Optional) Run the following command to view the associated signature files.

    curl undefined
  2. Download the signature file from the SingleStore release server.

    • Option 1: Click the Download Signature button next to the SingleStore file.

    • Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.

    • Option 3: Run the following command to download the signature file.

      curl -O undefined
  3. After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

    echo -n undefined |
    cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
    --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
    --bundle undefined \
    --new-bundle-format -
    Verified OK