24 Custom Diagrams
dbeaver-devops edited this page 2026-01-30 09:38:13 +00:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Table of contents

Custom diagrams let you work with database structure in a separate visual workspace. 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.

Create a custom diagram

You can create a custom diagram in two ways.

From the Menu Bar

  1. In the Menu Bar, click File -> New.
  2. In the wizard, select DBeaver -> ER Diagram and click Next.

From the Project Explorer

  1. In the Project Explorer, right-click the Diagrams node.
  2. Choose Create New Diagram.

Create Diagram wizard

In both cases, the Create Diagram wizard opens. Specify the diagram name and optionally select initial tables to add to the diagram.

Work with a custom 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 dont 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.

Combine tables from different connections

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.

Create custom relationships

Custom relationships are used for analysis and documentation purposes. To create a relationship:

  1. Select Connection from the Palette panel.

  2. Click the source table, then the target table.

  3. Select the columns to define the relationship.

    Note

    : Relationships created in custom diagrams are stored as virtual foreign keys and dont affect the database.