Introduction to physical backup and restore

data_backup_dest
├── format.obbak                                            // The format information of the backup path.
├── check_file
│   └── 1002_connect_file_20230111T193020.obbak             // The connectivity check file.
├── backup_sets                                             // The summary directory of data backup lists, which contains all data backup sets.
│   ├── backup_set_1_full_end_success_20230111T193420.obbak // The end placeholder for a full backup.
│   ├── backup_set_1_full_start.obbak                       // The start placeholder for a full backup.
│   ├── backup_set_2_inc_start.obbak                        // The start placeholder for an incremental backup.
│   └── backup_set_2_inc_end_success_20230111T194420.obbak  // The end placeholder for an incremental backup.
└── backup_set_1_full                                        // A full backup set. A directory whose name ends with "full" is a full backup set, and a directory whose name ends with "inc" is an incremental backup set.
    ├── backup_set_1_full_20230111T193330_20230111T193420.obbak //The placeholder that represents the start and end time of a full backup.
    ├── single_backup_set_info.obbak                        // The metadata of the current backup set.
    ├── tenant_backup_set_infos.obbak                       // The full backup set information of the current tenant.
    ├── infos
    │ ├── table_list // The list of table name files.
    │   │   ├── table_list.1702352553000000000.1.obbak      // Table name file 1.
    │   │   ├── table_list.1702352553000000000.2.obbak     // Table name file 2.
    │   │   └── table_list_meta_info.1702352553000000000.obbak  // The file of table name metadata.
    │   ├── major_data_info_turn_1                           // The tenant-level baseline data backup file when the turn ID is 1.
    │   │   ├── tablet_log_stream_info.obbak                 // The file describing the mapping between tablets and log streams.
    │   │   ├── tenant_major_data_macro_range_index.0.obbak  // The macroblock index in the baseline data backup file.
    │   │   ├── tenant_major_data_meta_index.0.obbak         // The meta index in the baseline data backup file.
    │   │   └── tenant_major_data_sec_meta_index.0.obbak     // The mapping between the logic ID and the physical ID of the meta index in the baseline data backup file.
    │   ├── minor_data_info_turn_1                           // The tenant-level minor-compacted backup file when the turn ID is 1.
    │   │   ├── tablet_log_stream_info.obbak                 // The file describing the mapping between tablets and log streams.
    │   │   ├── tenant_minor_data_macro_range_index.0.obbak  // The macroblock index in the minor-compacted backup file.
    │   │   ├── tenant_minor_data_meta_index.0.obbak         // The meta index in the minor-compacted backup file.
    │   │   └── tenant_minor_data_sec_meta_index.0.obbak     // The mapping between the logic ID and the physical ID of the meta index in the minor-compacted backup file.
    │   ├── diagnose_info.obbak                              // The diagnosis information file of the backup set.
    │   ├── locality_info.obbak                              // The tenant locality information of the current backup set.
    │   └── meta_info                                        // The tenant-level log stream metadata file, which contains the metadata of all log streams.
    │       ├── ls_attr_info.1.obbak                         // The snapshot of log streams during backup.
    │       └── ls_meta_infos.obbak                          //  The collection of metadata of all log streams.
    ├── logstream_1                                          // Log stream 1.
    │   ├── major_data_turn_1_retry_0                        // The baseline data when the turn ID is 1 and retry ID is 0.
    │   │   ├── macro_block_data.0.obbak                     // A data file sized between 512 MB and 4 GB.
    │   │   ├── macro_range_index.obbak                      // The macro index.
    │   │   ├── meta_index.obbak                             // The meta index.
    │   │   └── sec_meta_index.obbak                         // The file describing the mapping between the logical ID and the physical ID.
    │   ├── meta_info_turn_1_retry_0                         // The metadata of log streams when the turn ID is 1 and retry ID is 0.
    │   │   ├── ls_meta_info.obbak                           // The log stream metadata.
    │   │   └── tablet_info.1.obbak                          // The metadata of log stream tablets.
    │   ├── minor_data_turn_1_retry_0                        // The minor-compacted data when the turn ID is 1 and retry ID is 0.
    │   │   ├── macro_block_data.0.obbak
    │   │   ├── macro_range_index.obbak
    │   │   ├── meta_index.obbak
    │   │   └── sec_meta_index.obbak
    │   └── sys_data_turn_1_retry_0                          // The system tablet data when the turn ID is 1 and retry ID is 0.
    │       ├── macro_block_data.0.obbak
    │       ├── macro_range_index.obbak
    │       ├── meta_index.obbak
    │       └── sec_meta_index.obbak
    └── logstream_1001                                       // Log stream 1001.
        ├── major_data_turn_1_retry_0
        │   ├── macro_block_data.0.obbak
        │   ├── macro_range_index.obbak
        │   ├── meta_index.obbak
        │   └── sec_meta_index.obbak
        ├── meta_info_turn_1_retry_0
        │   ├── ls_meta_info.obbak
        │   └── tablet_info.1.obbak
        ├── minor_data_turn_1_retry_0
        │   ├── macro_block_data.0.obbak
        │   ├── macro_range_index.obbak
        │   ├── meta_index.obbak
        │   └── sec_meta_index.obbak
        └── sys_data_turn_1_retry_0
            ├── macro_block_data.0.obbak
            ├── macro_range_index.obbak
            ├── meta_index.obbak
            └── sec_meta_index.obbak

log_archive_dest
    ├── check_file
    │   └── 1002_connect_file_20230111T193049.obbak // The connectivity check file.
    ├── format.obbak                                // The format information of the backup path.
    ├── rounds                                      // The round placeholder directory.
    │   └── round_d1002r1_start.obarc               // The round start placeholder.
    ├── pieces                                      // The piece placeholder directory.
    │   ├── piece_d1002r1p1_start_20230111T193049.obarc // The piece start placeholder, in the format of piece_DESTID_ROUNDID_PIECEID_start_DATE.
    │   └── piece_d1002r1p1_end_20230111T193249.obarc   // The piece end placeholder, in the format of piece_DESTID_ROUNDID_PIECEID_end_DATE.
    └── piece_d1002r1p1                             // The piece directory, named in the format of piece_DESTID_ROUNDID_PIECEID.       
        ├── piece_d1002r1p1_20230111T193049_20230111T193249.obarc // The contiguous interval of a piece.
        ├── checkpoint   
        │   └── checkpoint_info.0.obarc             // The archiving progress of a piece that is being archived.
        ├── single_piece_info.obarc                 // The metadata of the piece.
        ├── tenant_archive_piece_infos.obarc        // The metadata of all frozen pieces before this piece.        
        ├── file_info.obarc                         // The list of files in all log streams.
        ├── logstream_1                             // Log stream 1.
        │   ├── file_info.obarc                    // The list of files in log stream 1.
        │   ├── log
        │   │   └── 1.obarc                         // The archive file in log stream 1.  
        │   └── schema_meta                         // The metadata of data dictionaries. This file is generated only in log stream 1.
        │       └── 1677588501408765915.obarc                           
        └── logstream_1001                          // Log stream 1001.
            ├── file_info.obarc                      // The list of files in log stream 1001.
            └── log
                └── 1.obarc                          // The archive file in log stream 1001.      

log_archive_dest
    ├── ......                                   
    └── piece_d1002r1p1                             // The piece directory, named in the format of piece_DESTID_ROUNDID_PIECEID.       
        ├── ......                         					// The list of files in all log streams.
        ├── logstream_1                             // Log stream 1.
        │   ├── file_info.obarc                    // The list of files in log stream 1.
        │   ├── log
        │   │   └── 1.obarc                         // The archive file in log stream 1, which is identified by a prefix.  
        |		|       └── @APD_PART@0-32472973.obarc  // The actual data in the archive file, including the data from byte 0 to byte 32472973 in the log file.
        |		|		    └── ......  
        |		|		    └── @APD_PART@FORMAT_META.obarc // The format of the archive file.
        |		|		    └── @APD_PART@SEAL_META.obarc   // The metadata of the archive file.      
        │   └── schema_meta                         // The metadata of the data dictionary. This file is generated only in log stream 1.
        │       └── 1677588501408765915.obarc                           
        └── logstream_1001                          // Log stream 1001.
            ├── file_info.obarc                      // The list of files in log stream 1001.
            └── log
                └── 1.obarc                          // The archive file in log stream 1001.