1. Overview

Connecting to a database through IntelliJ IDEA involves configuring a data source and selecting the appropriate database driver.

In this tutorial, we’ll learn how to connect to a database through IntelliJ data sources and drivers.

2. Enable the Database Tools and SQL Plugin

The Database Tools and SQL plugin is usually enabled by default in IntelliJ IDEA Ultimate. However, if we encounter a situation where it’s not enabled, we can follow these steps to ensure it’s enabled:

  1. First, let’s open IntelliJ IDEA and then navigate to “File” -> “Settings” (on Windows/Linux) or “IntelliJ IDEA” -> “Preferences” (on macOS)
  2. Once the Settings/Preferences dialog pops up, we can navigate to “Plugins”
  3. Now we need to look for the “Database Tools and SQL” plugin in the list of installed plugins
  4. If the “Database Tools and SQL” plugin is not already checked, we’ll need to check it
  5. If the plugin is not installed, we must click on the “Marketplace” tab and search for “Database Tools and SQL” to install it from there
  6. After enabling or installing the plugin, we may need to restart IntelliJ IDEA to apply the changes:
restart IntelliJ

3. Configuring the Data Source

Let’s see how to use the database view in IntelliJ IDEA, which allows an easy data source configuration. For demonstration purposes, we’ll use the PostgreSQL database.

3.1. Open the Database Tool Window

First, let’s open the “Database Tool Window”. To do so, we can simply navigate to the “View” menu and select “Tool Windows” -> “Database” or use the shortcut Alt + 8 (Windows/Linux) or ⌘ + 8 (Mac):

Database Tool Window

A new Database tool window will open and must be visible on IntelliJ IDEA:

IntelliJ IDEA tool window

3.2. Add a Data Source

Second, in the Database tool window:

  1. Let’s click on the “+” icon and then on “Data Source”, or right-click in the window and choose “New” and then “Data Source”
  2. Next, we can select the appropriate database type from the list (e.g., MySQL, PostgreSQL, Oracle):
Database Type

3.3. Configure Connection Details

After choosing a database, a new window “Data Sources and Drivers” pops up. We can now configure the connection details for our database:

Data Sources and Drivers

We need now to click on “Test Connection” to ensure that IntelliJ IDEA can successfully connect to the database. Once the connection is successfully established, the last step is to click on the “OK” button to save the data source configuration.

4. Configuring the Database Driver

In order to properly connect a database to IntelliJ IDEA, we typically need to download a JDBC driver. Luckily, in IntelliJ, we can simply click on the “Download” link next to the “Driver” field to download the appropriate database driver:


If the database driver is not bundled with IntelliJ IDEA, we’ll need to download it separately and configure the driver manually as follows:

First, we need to click on the “Drivers” tab of the “Data Sources and Drivers” window:

Data sources and drivers

Second, let’s click on the “+” icon to add a new driver.

Finally, we can choose the appropriate driver we already downloaded for the database type and fill in the required details. The appropriate driver class information can usually be found in the documentation for our specific database:Driver Class Information

5. Connect and Explore the Database

At this step, we can find our newly added data source along with all created data sources in the Database tool window. Furthermore, a green dot appears next to the Data sources icons that have an active connection to a database.

Data Sources Icons

Once connected, we can explore the database structure, execute SQL queries, and perform other database-related tasks directly from IntelliJ IDEA.

6. Conclusion

In this tutorial, we learned how to connect to a database through IntelliJ data sources and drivers. Remember that the exact steps may vary slightly based on the database type and version, as well as the specific IntelliJ IDEA version.

Course – LSD (cat=Persistence)
announcement - icon

Get started with Spring Data JPA through the reference Learn Spring Data JPA


res – Persistence (eBook) (cat=Persistence)
Comments are open for 30 days after publishing a post. For any issues past this date, use the Contact form on the site.