OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Cloud Platform

V4.2.2

    Download PDF

    OceanBase logo

    The Unified Distributed Database for the AI Era.

    Follow Us
    Products
    OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
    Resources
    DocsBlogLive DemosTraining & CertificationTicket
    Company
    About OceanBaseTrust CenterLegalPartnerContact Us
    Follow Us

    © OceanBase 2026. All rights reserved

    Cloud Service AgreementPrivacy PolicySecurity
    Contact Us
    Document Feedback
    1. Documentation Center
    2. OceanBase Cloud Platform
    3. V4.2.2
    iconOceanBase Cloud Platform
    V 4.2.2
    Databases
    • OceanBase Database
    • OceanBase Cloud
    • OceanBase Tugraph
    • Interactive Tutorials
    • OceanBase Best Practices
    Tools
    • OceanBase Cloud Platform
    • OceanBase Migration Service
    • OceanBase Developer Center
    • OceanBase Migration Assessment
    • OceanBase Admin Tool
    • OceanBase Loader and Dumper
    • OceanBase Deployer
    • Kubernetes operator for OceanBase
    • OceanBase Diagnostic Tool
    • OceanBase Binlog Service
    Connectors and Middleware
    • OceanBase Database Proxy
    • Embedded SQL in C for OceanBase
    • OceanBase Call Interface
    • OceanBase Connector/C
    • OceanBase Connector/J
    • OceanBase Connector/ODBC
    • OceanBase Connector/NET
    • V 4.3.6
    • V 4.3.5
    • V 4.3.4
    • V 4.3.3
    • V 4.3.2
    • V 4.3.1
    • V 4.3.0
    • V 4.2.2
    • V 4.0.0 and earlier

    Create a tenant-level backup strategy

    Last Updated:2026-04-14 07:56:02  Updated
    Share
    What is on this page
    Prerequisites
    Procedure

    folded

    Share

    OceanBase Cloud Platform (OCP) allows you to configure personalized backup and restore strategies based on the tenant dimension. After you create a tenant-level backup strategy for a tenant, the tenant is no longer affected by the cluster-level backup strategy.

    Note

    If a cluster-level backup strategy exists in the cluster to which the tenant belongs, the cluster-level backup strategy content is populated by default when you create a tenant-level backup strategy.

    Prerequisites

    • You can create backup strategies only for tenants of a cluster of OceanBase Database V4.0.0 or later.

    • If the OceanBase Database version of the cluster is V4.0.0 or later, second backup is disabled by default. To enable this feature, change the value of the ocp.backup.advanced-secondary-backup.enable parameter to true in System Parameters.

    • If the OceanBase Database version of the cluster is V4.0.0 or later, ensure that the following requirements are met before you configure second backup:

      • The storage medium for both regular backup and second backup is Alibaba Cloud Object Storage Service (OSS).
      • The retention period of second backup files is shorter than that of regular backup files.
      • If the backup scheduling cycle is weekly, the retention period of second backup files must be greater than or equal to 7 days. If the backup scheduling cycle is monthly, the retention period of second backup files must be greater than or equal to 30 days.
      • Regular backup files and second backup files cannot be stored in the same bucket. In addition, you cannot specify a custom storage path for second backup files.
      • The AccessKey pair of a regular backup task must have the permissions for cross-region replication. Otherwise, the task cannot be scheduled. If the task fails to be executed, you can retry the task after you configure the permissions.
      • The bucket for regular backup cannot be configured with cross-region replication rules. Otherwise, the task cannot be scheduled. If the task fails to be executed, you can retry the task after you delete these rules.
      • If the destination of a second backup task is an independently deployed OSS bucket, you must configure the cloudName and cloudLocation fields of the OSS bucket in the ocp.backup.advanced-secondary-backup.target-cloud-name and ocp.backup.advanced-secondary-backup.target-cloud-location parameters respectively in System Parameters.

    Procedure

    You can create a tenant-level backup strategy by using the following two methods:

    • Method 1

      Log on to the OCP console. In the left-side navigation pane, choose Backup & Recovery > Backup. Then, you can create a tenant-level backup strategy on the Backup page.

    • Method 2

      Log on to the OCP console and go to the Overview page of a cluster. In the left-side navigation pane, click Backup & Recovery. Then, you can create a tenant-level backup strategy on the Backup & Recovery page.

    The procedure of Method 1 is described as follows:

    1. In the left-side navigation pane, choose Backup & Recovery > Backup.

    2. On the Backup page, move the pointer over New Backup Strategy and select Create Tenant-level Backup Strategy.

    3. Select the tenant to back up from the drop-down list.

      • For a cluster of a version earlier than OceanBase Database V2.2.60, logical backup is used.

      • For a cluster of OceanBase Database V2.2.60 and later, physical backup is used.

    4. Specify the following storage configuration parameters and click Test.

      • For logical backup, select the storage configuration configured during service installation.

        If no backup service is installed, you must first install the backup service. For more information, see Install a service.

      • For physical backup, specify fields described in the following table.

        Parameter
        Description
        Storage Configuration Name You can configure a custom configuration or select an existing configuration.
        • For a custom configuration, specify the following fields.
        • If you select an existing configuration, click Select Existing Configuration. Then, the system automatically populates the following fields.
        Storage Class The type of storage media for backup files. Valid values:
        • File: Your local file storage system. Generally, Network File System (NFS) is used.
        • OSS: Alibaba Cloud OSS is supported only in OceanBase Database V2.2.76 and later.
        • COS: Cloud Object Storage (COS) of Tencent Cloud is supported only in OceanBase Database of V2.2.76 and later but earlier than V4.0, or in OceanBase Database V4.2.1 and later.
        • OBS: Huawei Cloud Object Storage Service (OBS) is supported only in OceanBase Database V3.2.3.2-105000062022090916 and later but earlier than V4.0.0.0.
        Storage Directory The directory in which the backup files are stored on the media.
        Notice
        If you have configured a backup strategy for the cluster to which the tenant belongs, we recommend that you specify the same storage directory as that of the cluster. Otherwise, the backup statistics of the tenant will be affected.
        Alert Threshold for Backup Storage Capacity The threshold for backup storage capacity alerts. This parameter is displayed if you select File for Storage Type. The default threshold is 80%.
        Domain Enter the domain name of the cloud storage of backup files.
        • If you select OSS for Storage Type, enter the domain name that has access to the files stored in Alibaba Cloud OSS, for example, oss-cn-hangzhou.aliyuncs.com.
        • If you select COS for Storage Type, enter the domain name that has access to the files stored in the COS bucket of Tencent Cloud, for example, cos.ap-beijing.myqcloud.com.
        • If you select OBS for Storage Type, enter the domain name that has access to the files stored in OBS of Huawei Cloud, for example, obs.cn-north-4.myhuaweicloud.com.
        User If you select OSS for Storage Type, enter the user that has access to the files stored in Alibaba Cloud OSS.
        AccessKey Pair If you select OSS for Storage Type, enter the AccessKey that has access to the files stored in Alibaba Cloud OSS.
        Resource Identity (APPID) If you select COS for Storage Type, move the pointer over the question mark (?) and specify the value as prompted.
        Project ID If you select COS for Storage Type, move the pointer over the question mark (?) and specify the value as prompted.
        Project Key If you select COS for Storage Type, move the pointer over the question mark (?) and specify the value as prompted.

        Image 147

    5. Specify fields in the Scheduling Settings section.

      • Scheduling Cycle: If you set the scheduling cycle to Month, you can select at most 10 days.

      • If you need to perform physical backups, log backup must be enabled.

      Image 37

    6. Schedule the clearing of expired backup files.

      Image 52

    7. Specify alert thresholds. You can specify the timeout threshold for data backup tasks, alert threshold for log backup delays, and alert threshold for the number of days without successful data backup. After you set a threshold, an alert is triggered when the threshold is reached.

      Image 53

    8. Optional. Configure second backup settings.

      To back up the backup data files and log files to another directory, turn on Second Backup.

      1. Configure storage settings for second backup.

      2. Configure scheduling settings for second backup.

    9. Click Submit.

    Previous topic

    View a cluster-level backup stategy
    Last

    Next topic

    Modify a tenant-level backup strategy
    Next
    What is on this page
    Prerequisites
    Procedure