OceanBase logo

OceanBase

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

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

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

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 Database

SQL - V4.2.0

    Download PDF

    OceanBase logo

    The Unified Distributed Database for the AI Era.

    Follow Us
    Products
    OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
    Resources
    DocsBlogLive DemosTraining & Certification
    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 Database
    3. SQL
    4. V4.2.0
    iconOceanBase Database
    SQL - V 4.2.0
    SQL
    KV
    • V 4.4.2
    • V 4.3.5
    • V 4.3.3
    • V 4.3.1
    • V 4.3.0
    • V 4.2.5
    • V 4.2.2
    • V 4.2.1
    • V 4.2.0
    • V 4.1.0
    • V 4.0.0
    • V 3.1.4 and earlier

    Views related to physical restore

    Last Updated:2023-12-01 03:27:20  Updated
    share
    What is on this page
    CDB_OB_RESTORE_PROGRESS
    CDB_OB_RESTORE_HISTORY

    folded

    share

    OceanBase Database allows you to query the restore progress and result in views.

    CDB_OB_RESTORE_PROGRESS

    CDB_OB_RESTORE_PROGRESS displays the restore progress of tenants.

    Column Description
    TENANT_ID The ID of the tenant that performed the restore job.
    JOB_ID The ID of the restore job.
    RESTORE_TENANT_NAME The name of the tenant to be restored.
    RESTORE_TENANT_ID The ID of the tenant to be restored.
    BACKUP_TENANT_NAME The name of the backup source tenant.
    BACKUP_TENANT_ID The ID of the backup source tenant.
    BACKUP_CLUSTER_NAME The name of the backup source cluster.
    BACKUP_DEST The backup set paths. The value contains the data backup path and log archive path.
    RESTORE_OPTION The restore option specified when restore is initiated.
    RESTORE_SCN The restore system change number (SCN).
    RESTORE_SCN_DISPLAY The restore SCN displayed as a timestamp.
    STATUS The restore status. The possible states of a restore job in the sys tenant are inconsistent with those in the restored tenant.
    For the sys tenant:
    • CREATE_TENANT: The sys tenant is creating the target tenant to be restored.
    • WAIT_TENANT_RESTORE_FINISH: The system is waiting for the restore of the target tenant to complete.
    • RESTORE_SUCCESS: The tenant is restored.
    • RESTORE_FAIL: The restore of the tenant failed.

    For the target tenant:
    • RESTORING: Data of the tenant is being restored.
    • POST_CHECK: The system is checking the role of the tenant and restoring the tenant as a standby database.
    • UPGRADE: The tenant is being upgraded. For restore across versions, an upgrade will be performed for the tenant.
    • RESTORE_SUCCESS: The restore succeeded.
    • RESTORE_FAIL: The restore failed.
    START_TIMESTAMP The start timestamp of the restore job.
    BACKUP_SET_LIST The backup set paths for restore, which are separated with commas (,). For example, file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc.
    BACKUP_PIECE_LIST The paths of log archive pieces for restore, which are separated with commas (,). For example, file:///data/nfs/backup/archive/2_1_2,file:///data/nfs/backup/archive/2_1_3.
    TOTAL_BYTES The total number of bytes to restore.
    TOTAL_BYTES_DISPLAY The total number of bytes to restore, in a storage capacity unit.
    FINISH_BYTES The number of bytes restored.
    FINISH_BYTES_DISPLAY The total number of bytes restored, in a storage capacity unit.
    DESCRIPTION The description specified in the restore statement.

    CDB_OB_RESTORE_HISTORY

    CDB_OB_RESTORE_HISTORY displays the restore results of tenants.

    Column Description
    TENANT_ID The ID of the tenant that performed the restore job.
    JOB_ID The ID of the restore job.
    RESTORE_TENANT_NAME The name of the tenant to be restored.
    RESTORE_TENANT_ID The ID of the tenant to be restored.
    BACKUP_TENANT_NAME The name of the backup source tenant.
    BACKUP_TENANT_ID The ID of the backup source tenant.
    BACKUP_CLUSTER_NAME The name of the backup source cluster.
    BACKUP_DEST The backup set paths. The value contains the data backup path and log archive path.
    RESTORE_SCN The restore SCN.
    RESTORE_SCN_DISPLAY The restore SCN displayed as a timestamp.
    RESTORE_OPTION The restore option specified when restore is initiated.
    START_TIMESTAMP The start timestamp of the restore job.
    FINISH_TIMESTAMP The end timestamp of the restore job.
    STATUS The restore result. Valid values:
    • SUCCESS: The restore succeeded.
    • FAILED: The restore failed.
    BACKUP_PIECE_LIST The paths of log archive pieces for restore, which are separated with commas (,). For example, file:///data/nfs/backup/archive/2_1_2,file:///data/nfs/backup/archive/2_1_3.
    BACKUP_SET_LIST The backup set paths for restore, which are separated with commas (,). For example, file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc.
    BACKUP_CLUSTER_VERSION The version number of the backup source cluster.
    LS_COUNT The total number of log streams to restore.
    FINISH_LS_COUNT The total number of log streams restored.
    TABLET_COUNT The total number of tablets to restore.
    FINISH_TABLET_COUNT The number of tablets restored.
    TOTAL_BYTES The total number of bytes to restore.
    TOTAL_BYTES_DISPLAY The total number of bytes to restore, in a storage capacity unit.
    FINISH_BYTES The number of bytes restored.
    FINISH_BYTES_DISPLAY The total number of bytes restored, in a storage capacity unit.
    DESCRIPTION The description specified in the restore statement.
    COMMENT The information about a failed restore job.

    Previous topic

    Physical restore parameters
    Last

    Next topic

    Overview
    Next
    What is on this page
    CDB_OB_RESTORE_PROGRESS
    CDB_OB_RESTORE_HISTORY