SQL Server and DBeaver
An Easy Guide on How to Connect

What is DBeaver: DBeaver overview

DBeaver is a free, open source multiplatform database management tool and SQL client for developers and database administrators. DBeaver can be used to access any database or cloud application that has an ODBC or JDBC driver, such as SQL Server, SQL Server, MySQl, Salesforce, or Mailchimp. Devart DBeaver provides you with the most important features you'd need when working with a database in a GUI tool, such as:

  • Metadata browsing and editing
  • SQL scripts management
  • Data export/import
  • Data backup
  • DDL generation
  • ER diagrams rendering
  • Test data generation
  • BLOB/CLOB support
  • Database objects browsing
  • Scrollable resultsets
  • Recommended hardware drives, hardware sizing, and disc space

    The tool comes in two editions — Community and Enterprise. Enterprise Edition supports NoSQL databases, such as MongoDB or Cassandra, persistent query manager database, SSH tunneling, vector graphics (SVG) and a few other enterprise-level features. Note though that you can access a MongoDB database from DBeaver Community Edition using the respective Devart ODBC driver. For the purposes of this guide, we'll use the Community Edition of DBeaver to retrieve data from SQL Server via the Open Database Connectivity driver.


    Before using this tutorial you need to download ODBC driver for SQL Server (30 Days Free Trial). Driver is compatible with 32-bit and 64-bit Windows, macOS, and Linux.

    Creating an ODBC Data Source to Use SQL Server Data in DBeaver

    The correct connection parameters, such as the hostname assigned to your computer, the username, and the password associated with your SQL Server account, must be used in the client software in order to connect to the SQL Server server. There is a default value for each connection parameter, but you can alter those according to your needs using program options provided either from the command line or in an option file.

    1. Click the Start menu and select Control Panel.
    2. Select Administrative Tools, then click ODBC Data Sources.
    3. Click on the System DSN tab if you want to set up a DSN name for all users of the system or select User DSN to configure DSN only for your account.
    4. Click the Add button and double-click Devart ODBC Driver for SQL Server in the list.
    5. Give a name to your data source and set up the connection parameters.
    6. Click the Test Connection button to verify that you have properly configured the DSN.

    When using ODBC driver for SQL Server with DBeaver, SQL_WVARCHAR data types may be displayed incorrectly in DBeaver. To prevent this, you need to set the string data types to Ansi either in the Advanced Settings tab of the driver configuration dialog or directly in the connection string (String Types=Ansi) — all string types will be returned as SQL_CHAR, SQL_VARCHAR and SQL_LONGVARCHAR.

    Using in DBeaver

    Connecting to SQL Server Data from DBeaver via ODBC Driver for SQL Server

    Follow the steps below to establish a connection to SQL Server in DBeaver.

    1. In the Database menu, select New Database Connection.
    2. New Database Connection for SQL Server in DBeaver

    3. In the Connect to database wizard, select ODBC and click Next.
    4. Select ODBC Data Source in DBeaver

    5. Enter the previously configured DSN in the Database/Schema field.
    6. DBeaver ODBC Connection Settings

    7. Click Test Connection. If everything goes well, you'll see the Success message.

    Viewing SQL Server Database Objects and Querying Data

    You can expand out the database structure in DBeaver's Database Navigator to visualize all the tables in SQL Server database. To view and edit the data in a table, you need to right-click on the target table name and select View data.The content of the table will be displayed in the main workspace.

    Retrieve data from SQL Server in DBeaver

    If you want to write a custom SQL query that will include only the necessary columns from the table, you can select New SQL Editor in the SQL Editor main menu. Create your query and run it by clicking Execute SQL Statement to view the results in the same window.

    Execute SQL query in DBeaver against SQL Server database

    ODBC Drivers

    Reliable and simple to use data connectors for ODBC data sources. Compatible with multiple third-party tools.