Team Edition Documentation

DOWNLOAD pdf

Task Scheduler

Table of contents

Overview

Team Edition allows you to schedule the execution of regular tasks. It supports Windows Task Scheduler on Windows and cron on macOS and GNU/Linux. Additionally, you can manually configure task scheduling via the command line.

Task Scheduling from the Tasks View

For Windows Users

You can open the tasks view from the main toolbar:

or from the main menu Window. Select a task that you want to schedule in the tasks view and open the context menu:

Team Edition will open the scheduler configuration dialog. You can configure task frequency, recurrence period and start time there:

To schedule the task, click on the Schedule button. If everything is OK, you will see the confirmation dialog:

If anything goes wrong, you will see an error message dialog. You can view error details in the Error Log view.

You can change the scheduler settings at any moment by choosing Edit scheduled task command from the context menu. You can also cancel the schedule by clicking on Remove schedule.

For macOS or GNU and Linux Users

You first need to open the tasks view. There are three ways to do that:

  1. Database -> Tasks -> Database Tasks

  2. Window -> Database Tasks

  3. Click on 'Show View (Database Tasks)' icon

Select a task you want to schedule in the tasks view. To open the scheduler dialog, either:

  1. Open the context menu with right-click -> Scheduler -> Schedule task

  2. or click on the 'Schedule task' icon

Team Edition will open the scheduler dialog. It has a lot of similarities with the corresponding dialog in Windows, but unfortunately, there are fewer settings on macOS and GNU/Linux due to the limitations of cron. For instance, when configuring an hourly task, you can only choose the minute at which the scheduler executes the task. In the example below, the task executes at 1:42 PM, 2:42 PM, 3:42 PM, and so on:

There is also no start date option and, in the case of minutely tasks, no start time either. The scheduler will execute the task at the specified time, but there are no guarantees when the execution starts. It is also worth pointing out that even though you can specify the seconds in the start time selector, the scheduler will ignore them. Even though we try to be compliant with as many cron implementations as possible, most cron implementations do not support this type of granularity.

On macOS 10.15 or newer versions, when scheduling a task for the first time, you will be prompted with something like this:

Click 'Yes' to proceed. The reason for that prompt is that macOS considers the cron settings (crontabs) to be system settings, and Team Edition will not be able to change them without your permission.

After that, you will see the confirmation message. Just like in Windows, you can change the scheduler settings at any moment by choosing the 'Edit scheduled task' command from the context menu, or cancel the schedule by clicking on 'Remove schedule'.

Viewing Schedule Details

Windows

You can see and change the scheduled task details in the Windows Task Scheduler. Click on the Open scheduler settings command in the task view context menu:

Team Edition stores all tasks in a folder called DBeaver.

macOS or Linux

You can take a look at the crontab Team Edition uses to schedule tasks in cron by clicking the 'Open scheduler settings' command in the task view context menu. You can also do it in the terminal by using the command crontab -l. Although you can also edit the crontab by using crontab -e, we strongly do not recommend it.

Monitoring Task Execution

You can look through the task execution logs on the right side of the tasks view. By double-clicking on a task run item, you can see the full log with all details, errors, and warnings:

Team Edition keeps the task run logs in the workspace directory, subfolder .metadata/task-stats.

Running tasks from the command line

The task scheduler uses the Team Edition command line interface to perform task executions. Command-line parameter -runTask TASK_ID launches saved task executions (immediately). TASK_ID has the form @projectName:taskName. You can omit the project name part if you have only one project in your workspace. In Windows, you can use the dbeaver-cli executable to run tasks. Please note that if you use dbeaver executable (for any reason), you will need to add the command line parameter -nosplash to avoid a splash screen appearance.

Shared tasks

In Team Edition, you can create shared tasks that are visible to all users with access to a specific project. This feature allows teams to collaborate more effectively by providing a centralized view of all scheduled tasks within a project.

For more information on Projects, see Projects in Team Edition.

Note: Only users with the Admin or Developer roles can access and execute scheduled tasks. For more information on roles, see Roles in Team Edition.

Limitations

In Team Edition, shared tasks have certain limitations for data import and export. A scheduled task will not run if the export or import is set to a local file. To use shared tasks, Cloud Storage must be the target or source for all export and import tasks.

For exports, data needs to be saved in Cloud Storage. Similarly, for imports, the data must come from Cloud Storage.

Tip: You can export and import data directly between databases without needing Cloud Storage.

Troubleshooting

Overview of Windows Scheduler

There are two implementations of the Windows scheduler present:

  1. CLI-based (Legacy): uses schtasks.exe to communicate with the scheduler; sensitive to locale-dependent data, such as Unicode names and date-time format.
  2. COM-based (New): uses COM API to communicate with the scheduler; more flexible and provides more features than the CLI version.

COM-based implementation is used by default, starting from the 21.1 version of DBeaver EE.

Windows Task Scheduler
Excluding Legacy Scheduler

If you encounter an error in Windows which contains the following text: com.sun.jna.platform.win32.COM.COMException,

do the following:

  1. Open the file dbeaver.ini.

    Tip: Detailed instructions on finding dbeaver.ini are available in our article.

  2. Place the line -Ddbeaver.scheduler.windows.legacy=true below the -vmargs line.

Windows Task Scheduler - Incorrect Date Format
Applicable to Legacy Scheduler

If you encounter an error in Windows which looks like this: ERROR: Invalid Start Date (Date should be in %some_format% format).,

do the following:

  1. Open the file dbeaver.ini in the directory with your DBeaver installation
  2. Place the line -Ddbeaver.scheduler.windows.dateFormat=%some_format% (where %some_format% is a format from the error message) below the -vmargs line.

This flag is available starting from the 7.3.4 EA version of DBeaverEnterprise and might be removed in the future.

macOS - Unable to read or write to crontab

When scheduling tasks on macOS 10.15 or newer versions, the OS will prompt you to elevate Team Edition's permissions to administer your computer. If you do not grant these permissions, Team Edition will fail to schedule your tasks with an error Unable to read or write to crontab. To bypass this, simply restart Team Edition and try to schedule the task again. The operating system will prompt you to elevate the permissions again. If macOS never prompted to do that in the first place, you could grant Full disk access permissions in the macOS settings. Here is how to do that:

  1. Open System Preferences.
  2. Click on Security & Privacy.
  3. Choose the Privacy tab.
  4. Choose the Full Disk Access folder.
  5. Unlock the preferences lock to the bottom if it is locked.
  6. Click the + button.
  7. Select DBeaver in the file picker that opens.
  8. Click Open.
  9. Close the lock.

Console task execution without password interruptions

For tasks executed in console mode, such as sending automated emails, consider enabling the Automation (console) setting. This setting allows for uninterrupted task performance, preventing continuous password prompts during operation. Only enable this on machines where task execution is critical and security can be controlled.