Salesforce JDBC Driver

This article will explain what are JDBC drivers, how to download the Salesforce JDBC driver and how to connect to Salesforce using DbSchema Free Database Designer.

What are JDBC Drivers?

JDBC drivers are Java library files with the extension .jar used by all Java applications to connect to the database. Usually, they are provided by the same company which implemented the Salesforce software. DbSchema Tool already includes an Salesforce driver, which is automatically downloaded when you connect to Salesforce.

What is the JDBC URL?

Each JDBC driver is using a specific 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 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. Then you can find the right URL directly in the DbSchema connection dialog.

Driver Information

  • Required File(s): dbschema-salesforce-jdbc-xxx.jar
  • Java Driver Class: com.dbschema.salesforce.SalesforceJdbcDriver
  • URL: jdbc:dbschema:salesforce:// or jdbc:dbschema:salesforce://tables=all or jdbc:dbschema:salesforce://sessionid={PARAM} orjdbc:dbschema:salesforce://sessionid={PARAM}&tables=all
  • Website: GitHub Salesforce Open Source JDBC Driver

Download Salesforce JDBC Driver

The driver files are compressed in a zip file.

for any issues with the driver, you can write to us.

The DbSchema JDBC Driver is Open Source

The driver is build by DbSchema team is free and open source. The driver can be found on GitHub.

Visit GitHub Driver Source Code

How To Create a Salesforce Database

Salesforce database is a cloud hosted database. You can register for a free trial account at There you have to go on 'View Profile Settings' on top right and follow the link on the left to 'Reset Security Token'. You will receive a security token per email. When logging in using DbSchema enter in the password field the regular web login password concatenated with the security token. More details in DbSchema help.

Connect to Salesforce using DbSchema Free Edition

Installing DbSchema Free edition will help to test the database connectivity and the JDBC driver URL.

Free Download DbSchema

When the download finished please follow this steps:

  1. 1 Select an Alias for your database connection. This will be the name of this specific connection to the database.
  2. 2 Select 'Salesforce' from the list of DBMS (Database Management Systems).
  3. 3 The driver for your database will be automatically downloaded for you in the folder
    • C:\Users\YourUser\.DbSchema\drivers\Salesforce (Windows) or
    • /Users/YourUser/.DbSchema/drivers/Salesforce (Linux and MacOS).
    Each database can have multiple connection and authentication methods. Switch to a different method from the dropdown menu.
Choose database and alias
  1. 4

    There are two tabs you can use to connect. 'Compose URL' will ask for the host, port, username, etc., and will create the JDBC URL for you.

    The 'Edit URL' will let you directly enter the JDBC URL.

    You can use the first tab to connect, and then see the created URL in the second tab.

Compose URL Tab Edit URL Tab
  1. 5 If connectivity succeeds, you should get your first DbSchema project and first diagrams.
Database Diagram

Connectivity Troubleshooting

If you get problems connecting to the database, please remember :
  • Press the ping button in the connection dialog to make sure the host and port are reachable.
  • Enable Remote connections as they are not always enabled by default. This may require configuration changes.
  • Windows Firewall may block the communication. You may need to reconfigure or disable it.
  • Check the driver version is compatible with the database software. It may be that DbSchema provided a JDBC driver is not the latest version. Please inform us in this case.
Further connectivity tips can be found on the Salesforce Connectivity Tips page.