Azure Synapse JDBC Driver & How to Connect

DbSchema is connecting to Azure Synapse using JDBC Drivers.

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

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 Azure Synapse Client which already includes the Azure Synapse JDBC driver. DbSchema can configure the Azure Synapse 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): mssql-jdbc-12.8.0.jre11.jar
  • Java Driver Class: com.microsoft.sqlserver.jdbc.SQLServerDriver
  • URL: jdbc:sqlserver://:1433;user=;password=;database=;encrypt=true;trustServerCertificate=true;hostNameInCertificate=*.database.windows.net;loginTimeout=30;
  • Website: Azure Synapse

Download Azure Synapse JDBC Driver

The driver files are compressed in a zip file. The driver can be found also here.

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

Connect to Azure Synapse 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 Azure Synapse. Connect to database
  3. 3 Connection-dialog

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

    • C:\Users\YourUser\.DbSchema\drivers\Azure Synapse (Windows) or
    • /Users/YourUser/.DbSchema/drivers/Azure Synapse (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.