-
Notifications
You must be signed in to change notification settings - Fork 4.3k
Custom Diagrams
Custom diagrams let you work with database structure in a separate visual canvas. You can combine tables, relationships, and notes in a single diagram without modifying the database schema.
Important: Even in custom diagrams, you can use only existing database objects.

You can create a custom diagram in two ways.
- In the Menu Bar, click File -> New.
- In the wizard, select DBeaver -> ER Diagram and click Next.
- In the Project Explorer, right-click the Diagrams node.
- Choose Create New Diagram.
In both cases, the Create Diagram wizard opens. Specify the diagram name and optionally select initial tables to add to the diagram.
The diagram opens in a separate editor. You can drag and drop any number of tables into it, including tables from different connections and database types, such as combining Oracle and MySQL tables in a single diagram.
In a custom diagram, you can:
-
combine tables from different connections and database types
-
add notes to document structure or decisions
-
create custom relationships for analysis
Note: Relationships created in custom diagrams are stored as virtual foreign keys.
All changes affect only the diagram and don’t modify the database. To create, modify, or delete database objects, use Edit mode.
For details on working with diagram elements, layout, styles, notation, and export options, see How to use Diagrams.
To add tables to a custom diagram, drag database objects from the Database Navigator and drop them onto the diagram canvas.
You can add tables from different connections and even from different database types, for example, combine Oracle and MySQL tables in a single diagram.
Custom relationships are used for analysis and documentation purposes. To create a relationship:
-
Select Connection from the Palette panel.
-
Click the source table, then the target table.

-
Select the columns to define the relationship.

Note: Relationships created in custom diagrams are stored as virtual foreign keys and don’t affect the database.
- Getting started
- DBeaver configuration
-
Security
- Connection settings
- Databases support
- Classic
- Cloud
- Embedded
- File drivers
- Graph
- Database Navigator
- Data Editor
- SQL Editor
- Entity relation diagrams (ERD)
- Cloud services
- AI Smart Assistance
- Data transfer and schema compare
- Task management
- Integrated tools
- Administration
- DBeaver Editions
- Standalone
- Cloud-hosted
- FAQ
- Development