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

• Projects benefits
• Creating a project
• Deleting Project
• Exporting and importing projects

Projects in DBeaver offer a flexible way to organize and manage your database connections, scripts, diagrams, and other resources.

Projects benefits

Projects help you organize connections, resources, and workflows. Here are some scenarios where you might want to use them:

• Separate different environments, like production, staging, and development, to avoid making accidental changes.
• Streamline collaboration by organizing shared resources when using version control systems like Git.
• Manage different credentials for the same database, such as switching between read-only and admin access easily.
• Group multiple connections, scripts, and diagrams by context, making your workspace simpler to navigate.

Creating a project

1. To create a project, go to the Projects view, and click Create Project button in the toolbar. This opens the Project Create Wizard.

   

2. Enter a name for your project in the Project name field.

3. To use the default storage location, keep Use default location selected. To choose a different directory, uncheck the box, enter a new path, or click Browse to select a folder.

4. Click Finish. The new project appears in the Projects tree.

Note

: You can’t rename or delete an active project.

Deleting Project

To delete a project, in the Projects view, right-click its name in the tree and click Delete on the context menu. Two confirmation dialog boxes will appear one after another:

1. Delete object dialog box is to confirm the deletion of the project itself. Click Yes if you are sure you want to delete it. Otherwise, click No.

To delete a project, right-click its name in the Projects view and select Delete from the context menu. You’ll see a confirmation dialog:

• Confirm the deletion by clicking Yes or cancel by clicking Cancel.
• To delete the project’s files (e.g., configurations, scripts) from disk, check the Delete project contents on disk box before confirming.

Note

: If you have deleted a project and then re-create it with the same name, the new project picks up all the database connections of the deleted project.

Exporting and importing projects

Transfer projects between environments using the built-in import and export tools.

1. Go to File -> Import (to import) or Export (to export)

2. In the opened window, select DBeaver, then choose Projects

3. In the next step:

   • for importing, select the location that contains the exported projects, then click Finish
   • for exporting, choose where to save the projects, then click Finish

4. If prompted, restart DBeaver to apply the imported projects.

Tip: Exporting and importing items is helpful for sharing or backing up configurations without migrating the entire workspace.