Database tool window

Enable the Database Tools and SQL plugin

This functionality relies on the Database Tools and SQL plugin, which is bundled and enabled in PyCharm by default. If the relevant features are not available, make sure that you did not disable the plugin.

Press Ctrl+Alt+S to open settings and then select Plugins.
Open the Installed tab, find the Database Tools and SQL plugin, and select the checkbox next to the plugin name.

Overview

In the Database tool window, you can work with databases and DDL data sources. You can view and modify data structures in your databases and perform other associated tasks.

The available data sources are shown as a tree of data sources, schemas, tables, and so on.

If no data sources are currently defined, use the New command Alt+Insert to create a data source and connect to a database. For more information about data sources, refer to Data sources topic.

Once PyCharm is connected to a database, Database tool window will display the introspected database objects. For more information about database tree viewing options, refer to View Options chapter. For more information about working with database objects in PyCharm, refer to the corresponding object topics.

Most of the functions in this window are accessed by using the toolbar icons or context menu commands. Many of the commands have keyboard shortcuts.

Browse your databases

Show more schemas

Database tool window displays introspected databases and schemas of your data sources. For a database or schema to be shown in the tree, select it in the schema selector of a data source.

For more information about introspection, refer to Glossary.

To see more schemas under your new data source node, click the N of M button and select the ones you need. PyCharm will introspect and show them.

Find database objects

To search for a database object in Database tool window, start typing the object's name. Matching database objects will be highlighted.
To toggle the speed search filter, click Speed Search Filter. To move between several highlighted items, press Up and Down.

For more information about speed search, refer to Speed Search in tool windows.

Filter database objects

You can filter database objects and hide the objects you do not need to see. To do this, use either the object filter in data source settings or the tool window item filter.

Object filter in data source settings
For example, you can filter out all tables with names starting with payment_.
1. To filter database objects, open Data Sources and Drivers dialog ( Shift+Enter) .
2. On the left pane of the dialog, select the data source in which you want to filter database objects.
3. In the Schemas tab, navigate to Object filter and enter the pattern. In our example, table:-payment_.*.
In the Object filter field, press Ctrl+Q for the information about syntax.
Item filter in the tool window view options
1. In the toolbar, click View Options and select Filter.
2. Select or deselect the items that you want to see or hide.
3. To confirm the selection, click any area in the Database tool window.

Copy data source

In the Database tool window, select the data source you want to copy.
Press Ctrl+C.
The IDE copies the XML snippet with connection settings.
In the target IDE, open Database tool window.
Press Ctrl+V.
In the Data Sources and Drivers that opens, enter the password in the Password field.
PyCharm does not store passwords unless they are provided as a parameter in the JDBC URL for the URL only connection type. For more information about password storage, refer to the Passwords topic.
Click OK to save your new data source and close the dialog.

For more information about copying data sources in XML format, refer to Share data sources between IDE instances.

Group data sources in folders

To group data sources in folders, right-click a data source and select Move to Folder. In the Move to Folder dialog, you can either move the data source to an existing folder or create a new one.

For more information about grouping data sources, refer to Group data sources in folders.

View quick documentation

Quick documentation displays information about the item. To view the information, select the item and press Ctrl+Q.

Scroll to the object opened in editor

To scroll to a database object in the database tree, place the caret over the object's name in code editor. Then, in Database tool window tool window toolbar, click Scroll from Editor.
The corresponding nodes will open and the object will be highlighted in the database tree.

Create a quick table backup

You can create a quick table backup before any significant data manipulation. To do this, drag the table to the original schema and create a copy of the table in Import dialog.

For more information about the dialog, refer to Import dialog.

Speed Search Filter toggle

In Database tool window, you can toggle the Speed Search Filter results.

Start typing the name of the database object you want to find.
Click Speed Search Filter on the toolbar.

Adjust tree view

Toggle groups for non-major objects

By default, non-major objects are grouped in the Database Objects and Server Objects nodes. To toggle this grouping, click View Options in the toolbar, navigate to View in Groups and click Database and Server Objects.

For more information about view options, refer to the Database topic.

Grouping enabled
Grouping disabled

Assign a color to a data source and its objects

In the Data Sources and Drivers dialog ( Shift+Enter) , click the circle at the end of the Name field and select the color.
Apply the changes and close the dialog.

For more information about assigning colors to data sources, refer to Assign a color to a data source and Assign a color to query consoles and grids.

Show tree indent guides

In the Database tool window, you can display vertical lines that mark indent levels and help you better understand the hierarchy of the objects in your databases.

Press Ctrl+Alt+S to open settings and then select Appearance & Behavior | Appearance.
In the Tree Views section, enable the Show indent guides option.

Tree indent guides are enabled
Tree indent guides are disabled

Show comments and last refresh date

You can view comments and last refresh timestamps for the objects in the database tree.

In the toolbar, click View Options, navigate to Node Details and select Comments and Schema Refresh Time.

Reference info

Header toolbar

You can right-click the window header and use the context menu to configure its viewing mode, associate the window with a different tool window bar, or resize and hide the window.

You can also use the toolbar buttons:

Item	Shortcut	Description
		Automatically sets the focus on the object name in the Database tool window when the editor area is in focus.
	`Ctrl+NumPad +`	Expand all nodes in the current view.
	`Ctrl+NumPad -`	Collapse all expanded nodes in the current view.
	Hide`Shift+Escape`	Hide the tool window . To hide all the tool windows, press `Ctrl+Shift+F12`.

Header context menu

Item	Description
Autoscroll from Editor	Makes the database object, that is opened in the editor, automatically selected in the Database tool window. Disables the Scroll from Editor setting.
Show Query Console Toolbar	Display the toolbar in the query console tabs.
Speed search	Opens the input field of the Speed Search in tool windows feature.
Show Toolbar	Display the toolbar in the Database tool window.
View Mode	This option lets you control general appearance and behavior of the tool window. For full information, refer to Tool window view modes.
Move to	To associate the tool window with a different tool window bar, select this command, and then select the destination tool window bar (Top, Left, Bottom or Right). For full information, refer to the Move tool windows chapter.
Resize	To resize the tool window by moving one of its borders, select this command, and then select the necessary Stretch to option. Note that this command is not available for the floating mode.
Remove from Sidebar	This command hides the tool window, removes the associated tool window button from the tool window bar, and removes the tool window from the quick access menu ( or ). To open the tool window again (and restore the associated features), use the main menu: View \| Tool Windows \| <Window Name> or press `Alt+1`.
Help	This command opens the description of the Project tool window in the PyCharm online help.

Toolbar

New

Create a new data source, query console, or a driver.

Available for: Data sources and their elements.

Data Source Properties Shift+Enter

Open the Data Sources and Drivers dialog to manage your data sources and their settings.

Available for: All node types.

Refresh Ctrl+F5

Update the view of the selected element (that is to synchronize the view of the element with its actual state in the database).

Available for: Data sources and their elements.

Deactivate Ctrl+F2

Close the database connection for the selected data source or data sources.

Available for: Data sources with active connections and their elements.

Jump to Query Console Ctrl+Shift+F10

Open the list of query consoles for the selected data source.

Available for: Data sources and their elements.

Edit Data F4

Open a table view of the object in the data editor. This option works for tables, views, and materialized views.

Available for: Corresponding elements in data sources.

DDL

Go to DDL Ctrl+B

Open the DDL script of the selected object.

For example, if you press this shortcut on a table's name in the SELECT statement, you will see the DDL of this table (the CREATE TABLE statement).

Available for: Corresponding elements in data sources.

Compare Structure Ctrl+D

Compare the structure of two database objects in the Migration dialog. The comparison results are shown in the Diff Viewer.

Available for: Two selected database objects of the same kind.

View Options

Open the list of database object tree viewing options, including the item filter. For more information about the options, refer to the View Options chapter.

Available for: All items.

View Options

The view options, generally, define what is shown in the tool window and how. To view or change these options, click View Options on the toolbar.

Filter

Open a list of database objects that you can filter. The list of database objects depends on the selected database. To see a full list of available database objects and their icons, go to Icons for data sources and their elements.

The green dot in the corner of filter icon indicates that the filter is on and some objects are filtered out.

Everything is filtered out except views and tables

Only views and tables are selected to view in Database tool window

Nothing is filtered out

All items are selected to view in Database tool window

View in Groups | Data Sources

Displays folders for data sources.

For more information about creating folders, refer to Group data sources in folders chapter.

View in Groups | Databases and Schemas

Displays folders for databases and schemas.

View in Groups | Server and Database Objects

Displays folders for server and database objects, Server Objects and Database Objects correspondingly. This setting concerns users, roles, tablespaces, modules, foreign data wrappers, and other rarely used objects.

View in Groups | Object Elements

This option defines how table elements are shown.

When on, there are separate nodes for columns, indexes, primary and foreign key constraints, and triggers (shown as folders). The elements appear in the corresponding groups.
When off, there is no such grouping and, generally, only columns are shown for tables.

View in Groups | Schema Objects

Defines how schema elements are shown.

When on, there are separate nodes for tables, views, and stored routines (shown as folders). Tables, views and routines (procedures and functions) are shown as elements of the corresponding groups.
When off, there is no explicit grouping for tables, views, and routines. Tables and views are followed by procedures and functions.

View in Groups | Separate Procedures and Functions

In Microsoft SQL Server, Oracle, and PostgreSQL, separates procedures and functions into different folders.

View in Groups | Place Constraints and Similar Objects under Schema

Display nodes for object names that exist in a schema namespace. For example, nodes for keys, CHECK constraints, indexes, triggers, rules, and other objects.

You can use this option in the following situations:

To find an object inside a schema with the help of a quick search.
To see the columns under the table node. To do this, turn off the Empty Groups.

View in Groups | Sort Alphabetically

Order database objects alphabetically. When the option is disabled, the natural sort order is applied.

Show Elements | All Namespaces

Show all databases and schemes even if they are not selected for introspection.

When the All Namespaces option is disabled, the databases that are not selected for introspection do not appear in the Database tool window.
When the All Namespaces option is enabled, the databases that are not selected for introspection are displayed in the Database tool window.

Show Elements | Empty Groups

If the Schema Objects or Object Elements options are selected, you can select to show or hide the categories that contain no elements.

Show Elements | Intermediate Nodes

Shows or hides parent nodes only when you do not have other objects on the same level with a parent.

Show Elements | Generated Objects

For Oracle, shows or hides auto-generated objects in the tree. It concerns the following objects:

Materialized view logs
The underlying tables for materialized views
Secondary tables

Show Elements | Virtual Objects

Show or hides the following objects:

Virtual foreign keys
Virtual views
Virtual columns

Node details | Comments

Display comments for database objects.

Node details | Schema Refresh Time

Display the local date and time of the last performed introspection for schemas.

The feature is currently not supported for ClickHouse, Redis, Apache Cassandra, and Apache Hive.

Context-menu actions appear when you right-click an object in the Database tool window.

Properties Shift+Enter

Open the Data Sources and Drivers dialog to manage your data sources and their settings.

Available for: Data source and DDL data source nodes.

New

Create a new data source, role, database, schema, query console, table, column, index, a primary, or a foreign key. The list of options depends on which element is currently selected.

Available for: Data sources and their elements.

Copy/Paste | Copy Data Source Ctrl+C

Copy the XML code snippet with connection settings to the clipboard.

Available for: Data source nodes.

Copy/Paste | Copy Reference Ctrl+Alt+Shift+C

Copy the fully qualified name of the selected item to the clipboard.

Available for: Data sources and their elements.

Copy/Paste | Duplicate Ctrl+D

Create a copy of the selected data source. Specify the properties of the data source in the Data Sources and Drivers dialog that opens.

Available for: Data source and DDL data source nodes.

Edit Data F4

Open a table view of the object in the data editor. This option works for tables, views, and materialized views.

Available for: Corresponding elements in data sources.

Move to Folder F6

Move the selected data source to a folder. If no folders exist yet, create the first one in the Move to Folder popup that appears.

For more information about grouping data sources, refer to Group data sources in folders.

Available for: Data source and DDL data source nodes.

Refresh Ctrl+F5

Update the view of the selected element (that is to synchronize the view of the element with its actual state in the database).

Available for: Data sources and their elements.

Deactivate Ctrl+F2

Close the database connection for the selected data source or data sources.

Available for: Data sources with active connections and their elements.

Quick Documentation Ctrl+Q

View basic information about the selected element.

To close the documentation popup, press Escape.

Available for: Data sources and their elements.

For more information about quick documentation, refer to quick documentation.

Compare Structure With Ctrl+D

Compare the structure of two database objects in the Migration dialog. The comparison results are shown in the Diff Viewer.

Available for: Two selected database objects of the same kind.

Navigation | Go to DDL Ctrl+B

Open the DDL script of the selected object.

For example, if you press this shortcut on a table's name in the SELECT statement, you will see the DDL of this table (the CREATE TABLE statement).

Available for: Corresponding elements in data sources.

Navigation | Jump to Query Console Ctrl+Shift+F10

Open the list of query consoles for the selected data source.

Available for: Data sources and their elements.

Run Function or Run Procedure

Run the selected function or procedure.

Available for: Data source elements: functions, procedures.

Introspection Level

Change the introspection level either for the whole database or for a particular schema. Children inherit a level that is set for a parent.

Available for: Data Source nodes.

SQL Scripts | SQL Generator Ctrl+Alt+G

Generate data definition structures for database objects. For example, you can generate DDL files for a single table or for all the tables in the schema. Also, you can customize generation settings. For example, you can set what syntax to use for table creation: CREATE TABLE or CREATE TABLE IF NOT EXISTS.

Available for: Data source elements.

For more information about using SQL Generator, refer to the Generate DDL definitions for database objects and Change output settings of the SQL Generator chapters.

SQL Scripts | Request and Copy Original DDL

Requests the DBMS server to get or generate a source text for this object, receives this text, and puts it to the clipboard.

Available for: Data sources and their elements.

SQL Scripts | Generate DDL to Clipboard Ctrl+Alt+Shift+G

Generate a DDL of the object and copy it to the clipboard.

Available for: Data sources and their elements.

SQL Scripts | Generate DDL to Query Console Ctrl+Alt+Shift+B

Generate a DDL of the object and copy it to the query console.

Available for: Data sources and their elements.

Object Actions | Rename Shift+F6

Rename the selected item. Specify the new name in the dialog that opens.

Available for: Data sources and their elements.

Object Actions | Enable triggers/constraints

Enable triggers and constraints for the selected table.

Available for: Data source elements: tables.

Object Actions | Disable triggers/constraints

Disable triggers and constraints for the selected table.

Available for: Data source elements: tables.

Object Actions | Modify Comment

Modify the database object comment in the Modify Comment dialog.

Object Actions | Modify Grants

Modify the grants of a database object in the Modify Grants of <object_name> dialog.

Object Actions | Truncate…

Remove all the rows in the selected table.

Available for: Data source elements: tables.

Object Actions | Drop or Object Actions | Remove Data Source Delete

Remove the selected item.

Available for: Data sources and their elements.

Tools | Manage Shown Schemas

Open a popup with available schemas for the current data source.

Icons

Data sources and their elements

Icon	Description
	Access Method
	Aggregate
	Alias Type
	Argument
	Body
	Check
	Cluster
	Collation
	Collection Type
	Column. For more information about column icon combinations, refer to Possible icon combinations for columns.
	Data File
	Database
	Read-only status
	DDL data source
	Default
	Exception
	Extension
	External Schema
	Foreign Data Wrapper
	Foreign Key
	Foreign Table
	Index
	Key
	Materialized Log
	Materialized View
	Object Attribute
	Object Type
	Operator
	Package
	Primary key
	Projection
	Data sources
	Role
	Routine
	Rule
	Scheduled Event
	Schema
	Sequence
	Server
	Stored procedure or function
	Synonym
	Table
	Table Type
	Tablespace
	Trigger
	User
	User Mapping
	Variable
	View
	Virtual column
	Virtual foreign key
	Virtual view
	Virtual Table