DBeaver Documentation

DOWNLOAD pdf

Team Edition Migration

This article explains the key differences between single-user DBeaver products and DBeaver Team Edition. We will look at vital information for users considering or undergoing migration.

Problem Overview

DBeaver desktop, which is a versatile database management suite, includes editions like Community, Lite, Enterprise, and Ultimate. These editions are primarily designed for individual use. All configurations, database connections, SQL scripts, diagrams, and other related files are stored on the local machine.

While these single-user editions provide powerful tools for individual database management, they are not optimized for team collaboration. Sharing resources between multiple users via email, message applications, or disk shares can lead to inconveniences and the need to constantly synchronize.

Using shared version control systems like Git is a potential solution, but this approach has its own challenges, particularly for non-programmers who might find Git concepts a bit complex. In addition, merge conflicts can sometimes disrupt the configuration.

On the security front, the single-user editions of DBeaver do not mandate authentication. This means that anyone who gains access to a computer can also access all saved configurations and sensitive data, such as database server credentials. Though workarounds like workspace master passwords or project-based passwords with configuration encryption exist, they can be especially cumbersome, especially in larger organizations.

Recognizing these challenges, DBeaver has introduced the DBeaver Team Edition, tailored for multi-user collaboration.

DBeaver Team Edition

DBeaver Team Edition is a multi-user application designed for distributed team work. The solution comprises:

  • DBeaver Team Edition server (For deployment details, refer to Deployment)
  • DBeaver Team Edition desktop client (With functionality similar to classic DBeaver)
  • DBeaver Team Edition web client (Comparable to CloudBeaver)

Important: DBeaver Team Edition requires users to deploy the server on their own infrastructure. It is not provided as a hosted solution or a Software as a Service (SaaS) offering.

This article does not discuss server installation and configuration. For that information, consult the links provided above. Instead, this document focuses on guiding users through the process of migrating their existing configurations to adapt to the multi-user environment.

Authentication

To utilize DBeaver Team Edition, each user is required to authenticate within the system. Various authentication methods can be configured by system administrators to suit their organizational needs:

  • Username and Password
  • Cloud provider authentication (AWS, Google, Azure)
  • Windows NTLM

The authentication dialog appears on the initial screen when launching the desktop client or accessing the web application.

Working in Desktop client

The DBeaver Team Edition client is very similar to DBeaver Ultimate in terms of user interface, editors, and views. However, there are some key differences:

  • Database connections, SQL scripts, and other resources are stored on a remote server, fetched to the local machine on demand.
  • Saved database credentials are securely stored and encrypted on the server. In the case of a desktop client, these credentials are requested on-demand and are never saved on the local disk.
  • The database task scheduler initiates tasks on the remote server, not the local machine.
  • The User interface varies slightly depending on the user's roles (see below).
  • Git integration is omitted from desktop clients as files are not saved on the local file system. Git Integration is available through the administration panel.
  • Quick file search functionality is not available in the DBeaver Team Edition client.

Working in the Web client

The Web client is very similar to the classic CloudBeaver, with the following notable differences:

  • DBeaver Team Edition supports an infinite number of global projects (in classic CloudBeaver there is only one global project).
  • The user interface varies based on the user's roles (see below).

Projects, Teams, and Roles in DBeaver Team Edition

In DBeaver Team Edition, the concept of projects is similar to that in classic desktop versions:

  • A project contains database connections, SQL scripts, datasets, and other resources.
  • Every user has access only to some projects (it is controlled by the administrator).

A team functions as a group of users, and users can belong to multiple teams. Access to projects can be granted either to a team or to individual users.

Roles serve as access levels for users, and each user can have only one role:

Capability \ Roles Administrator Developer Manager Editor Viewer
Full system administration + - - - -
Manage users and licenses + - - - -
Create/delete projects + - - - -
Edit connections + + - - -
View connections + + + - -
Create/edit/delete resources and scripts + + + - -
Create/edit datasets + + + - -
Create/edit folders + + + - -
Save datasets to private project + + + - -
Use DBeaver desktop + + + - -
In-line data editing + + + + -
View, browse, filter, export datasets + + + + +

Working with database credentials

Unlike other products, in DBeaver Team Edition, credentials are entered at the application's startup.

Users can reuse the credentials used for logging in when connecting to databases. This approach also streamlines the process of connecting to various databases, especially those hosted on cloud servers, by using the same set of credentials for both the DBeaver Team Edition and database access.

Database Tasks and Scheduling

In DBeaver Team Edition, tasks are scheduled on the server, which differs from other DBeaver products. As a result, task outcomes are stored exclusively on the server. To access these results on a local machine, download them from the server.

Version Control

In DBeaver Team Edition, Git integration is engineered for collaborative work:

  • Admin-Configured credentials: Administrators establish Git credentials, which means all changes made by the users are committed on behalf of the administrator-set user, not the individual users themselves.
  • Local repository management: The local Git repository is not directly accessible for standard Git operations. Team Edition automates Git interactions, streamlining version control for collaborative work.

For further details on version control within DBeaver Team Edition, refer to the Git TE integration documentation. For Desktop DBeaver, see the Project team work documentation.

Migration steps

To migrate the project from DBeaver Desktop to Team Edition, follow these steps:

  • Open DBeaver Team Edition and log in as an administrator.
  • Go to File -> Import local project to Team Edition.
  • In the import window:

    Field Action
    Select root directory Choose the project directory. For information on how to find directory, see Workspace Location
    Select archive file Choose the project archive file.
    Choose source project Select the project to import.
    Import user credentials Check this option if you wish to include user credentials for connections in the import.
    Target project Enter a name for the new project in Team Edition.
    Team project description Optionally, provide a description for the project.
  • Click Finish to initiate the project import.

  • Find the imported project in the Projects view.

Tip: Open the Projects view through Window -> Projects if it is not already open.