Updated on 2025-12-10 GMT+08:00

Backing Up Doris Data

Scenarios

To ensure Doris service data security, you need to back up Doris service data especially before you perform a major operation on Doris (such as upgrade or migration). The backup data can be used to recover the system if an exception occurs or the operation has not achieved the expected result, minimizing the adverse impacts on services.

Doris service data backup tasks can be created on FusionInsight Manager. The system supports both automatic and manual backup modes.

MRS clusters support multiple data path types for backing up Doris service data.

  • RemoteHDFS: indicates that backup files are stored in the HDFS directory of the standby cluster.
  • OBS: indicates that backup files are stored in OBS.

Notes and Constraints

This section applies only to MRS 3.3.1 or later clusters.

Prerequisites

  • To back up data to a remote HDFS, the following conditions must be met:
    • A standby cluster for backing up data has been created. Its authentication mode must be the same as that of the active cluster.
    • At least one DBroker instance of the Doris service has been deployed in the active cluster.
    • If the active and standby clusters are deployed in security mode and they are not managed by the same FusionInsight Manager, mutual trust has been configured. For details, see Configuring Mutual Trust Between MRS Clusters. If the active and standby clusters are deployed in normal mode, mutual trust is not required.
    • Time is consistent between the active and standby clusters, with the NTP services on both clusters configured to use the same time source.
    • The HDFS in the standby cluster has sufficient space. You are advised to save backup files in a custom directory.
    • The value of hadoop.rpc.protection of Doris must be the same as that of hadoop.rpc.protection of HDFS in both active and standby clusters.
  • You have planned the backup type, period, object, and directory based on service requirements.
  • If you want to back up data to OBS, you have connected the current cluster to OBS and have the permission to access OBS.

Backing Up Doris Data

  1. Log in to FusionInsight Manager of the MRS cluster.

    For details about how to log in to FusionInsight Manager, see Accessing MRS Manager.

  2. Choose O&M > Backup and Restoration > Backup Management.
  3. Click Create.
  4. Set Name to the name of the backup task.
  5. Select the cluster to be operated from Backup Object.
  6. Set Mode to the type of the backup task.

    • Periodic: indicates that the backup task is periodically executed. If you select this mode, you need to set other parameters by referring to Table 1.
    • Manual: indicates that the backup task is manually executed.
    Table 1 Periodic backup parameters

    Parameter

    Description

    Started

    Time when the task should start for the first time.

    Period

    Task execution interval. Supported values are Hours and Days.

    Backup Policy

    • Full backup at the first time and incremental backup subsequently
    • Full backup every time
    • Full backup once every n times

    Currently, Doris supports only full backup each time. Incremental backup is not supported.

  7. In Configuration, select Doris under Metadata and other data.
  8. Select a backup directory type for Path Type of Doris.

    Table 2 Backup directory types

    Path Type

    Parameter

    Description

    RemoteHDFS

    Destination NameService Name

    Name of the NameService in the standby cluster.

    You can obtain it from the NameService Management page of HDFS in the standby cluster. For example, the name is hacluster.

    IP Mode

    IP version of the target IP address. The system automatically determines the IP version, such as IPv4 or IPv6, based on the cluster network type.

    Target NameNode IP Address

    Service plane IP address of the active NameNode in the standby cluster.

    Destination NameNode RPC Port

    Value of dfs.namenode.rpc.port in the HDFS configuration of the destination cluster.

    DBroker IP

    Service plane IP address of the DBroker role in the cluster. The DBroker is used to transmit data during backup.

    Target Path

    HDFS directory in the standby cluster for storing backup data.

    • The path cannot be configured as an HDFS hidden directory, such as a snapshot or recycle bin directory.
    • The path cannot be configured as a default system directory, such as /hbase or /user/hbase/backup.

    OBS

    Target Path

    OBS directory for storing backup data.

  9. Set Maximum Number of Recovery Points to the number of snapshots that can be retained in the cluster.
  10. Set Backup Content to one or multiple Doris tables to be backed up.

    You can select backup data using either of the following methods:

    • Adding a backup data file

      Click the name of a database in the navigation pane to show all the tables in the database, and select specified tables.

    • Selecting using regular expressions
      1. Click Query Regular Expression.
      2. Enter the database where the Doris tables are located in the first text box as prompted. The database must be the same as the existing database, for example, /example_db.
      3. Enter a regular expression in the second text box. Standard regular expressions are supported. For example, to search for all tables that contain the keyword test in the database, enter test.*.
      4. Click Refresh to view the displayed tables in Directory Name.
      5. Click Synchronize to save the result.
      • When entering regular expressions, click or to add or delete an expression.
      • If the selected table or directory is incorrect, click Clear Selected Node to deselect it.

  11. Click Verify to check whether the backup task is configured correctly.

    The possible causes of the verification failure are as follows:

    • The target NameNode IP address is incorrect.
    • The name of the NameService is incorrect.
    • The table to be backed up does not exist.
    • The format of the table to be backed up is incorrect.
    • The tables to be backed up must come from the same database.

  12. Click OK.
  13. In the Operation column of the created task in the backup task list, click More and select Back Up Now to execute the backup task.

    After the backup task is executed, the system automatically creates a subdirectory for each backup task in the backup directory. The format of the subdirectory name is Backup task name_Data source_Task creation time, and the subdirectory is used to save latest data source backup files. All the backup file sets are stored in the related snapshot directories.

Helpful Links

Backup Doris service data may be restored if data is accidentally modified, deleted, or requires retrieval; if major Doris operations (such as upgrades or significant data adjustments) cause exceptions in system data or fail to achieve the expected result; if all modules fail and become unavailable; or if data needs to be migrated to a new cluster. For detailed operations, refer to Restoring Doris Service Data.