物理备份与恢复概述

data_backup_dest
├── format.obbak                                            // 备份路径的格式化信息
├── check_file
│   └── 1002_connect_file_20230111T193020.obbak             // 连通性检查文件
├── backup_sets                                             // 数据备份列表的汇总目录，记录了所有的数据备份集列表
│   ├── backup_set_1_full_end_success_20230111T193420.obbak // 全量备份结束占位符
│   ├── backup_set_1_full_start.obbak                       // 全量备份起始占位符
│   ├── backup_set_2_inc_start.obbak                        // 增量备份起始占位符
│   └── backup_set_2_inc_end_success_20230111T194420.obbak  // 增量备份结束占位符
└── backup_set_1_full                                        // 全量备份集，文件结尾为 full 表示是全量备份，inc 表示是增量备份
    ├── backup_set_1_full_20230111T193330_20230111T193420.obbak //占位符，展示全量备份的开始和结束时间
    ├── single_backup_set_info.obbak                        // 当前备份集的元信息
    ├── tenant_backup_set_infos.obbak                       // 当前租户的全量备份集信息
    ├── infos
    │   ├── table_list                                      //全量表名文件
    │   │   ├── table_list.1702352553000000000.1.obbak      //表名文件 1
    │   │   ├── table_list.1702352553000000000.2.obbak     //表名文件 2
    │   │   └── table_list_meta_info.1702352553000000000.obbak  //表名元信息文件
    │   ├── major_data_info_turn_1                           // major turn 1 下的租户级备份文件
    │   │   ├── tablet_log_stream_info.obbak                 // tablet 与 日志流的映射文件 
    │   │   ├── tenant_major_data_macro_range_index.0.obbak  // major 宏块索引
    │   │   ├── tenant_major_data_meta_index.0.obbak         // major meta 索引
    │   │   └── tenant_major_data_sec_meta_index.0.obbak     // major 逻辑 id 与物理 id 的映射文件
    │   ├── minor_data_info_turn_1                           // minor turn 1 下的租户级备份文件
    │   │   ├── tablet_log_stream_info.obbak                 // tablet 与 日志流映射文件 
    │   │   ├── tenant_minor_data_macro_range_index.0.obbak  // minor 宏块索引
    │   │   ├── tenant_minor_data_meta_index.0.obbak         // minor meta 索引
    │   │   └── tenant_minor_data_sec_meta_index.0.obbak     // minor 逻辑 id 与物理 id 映射
    │   ├── diagnose_info.obbak                              // 备份集诊断信息文件
    |   ├── tenant_parameter.obbak                           // 当前租户非默认设置的租户级配置项信息
    │   ├── locality_info.obbak                              // 当前备份集的所属租户的 locality 信息，包括租户的资源配置信息和副本分布信息
    │   └── meta_info                                        // 租户级别的日志流元信息文件，包含所有日志流的元信息
    │       ├── ls_attr_info.1.obbak                         // 备份时的日志流列表快照
    │       └── ls_meta_infos.obbak                          // 所有日志流的 meta 集合
    ├── logstream_1                                          // 1 号日志流
    │   ├── major_data_turn_1_retry_0                        // turn 1,retry 0 下的基线数据
    │   │   ├── macro_block_data.0.obbak                     // 一个数据文件，大小为 512 MB ~ 4 GB
    │   │   ├── macro_range_index.obbak                      // macro索引
    │   │   ├── meta_index.obbak                             // meta 索引 
    │   │   └── sec_meta_index.obbak                         // 逻辑 id 与物理 id 的映射文件
    │   ├── meta_info_turn_1_retry_0                         // turn 1,retry 0 下的日志流元信息文件
    │   │   ├── ls_meta_info.obbak                           // 日志流元信息
    │   │   └── tablet_info.1.obbak                          // 日志流 tablet meta 列表
    │   ├── minor_data_turn_1_retry_0                        // 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                          //turn 1, retry 0 下的系统 tablet 数据
    │       ├── macro_block_data.0.obbak
    │       ├── macro_range_index.obbak
    │       ├── meta_index.obbak
    │       └── sec_meta_index.obbak
    └── logstream_1001                                       // 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

cluster_parameters_backup_dest
├── cluster_parameter.20240710T103610.obbak # 非默认设置的集群级配置项信息，文件命名格式：`cluster_parameter.[timestamp]`
└── cluster_parameter.20241018T140609.obbak

log_archive_dest
    ├── check_file
    │   └── 1002_connect_file_20230111T193049.obbak // 连通性检查文件
    ├── format.obbak                                // 备份路径的格式化信息
    ├── rounds                                      // Rounds 占位符目录
    │   └── round_d1002r1_start.obarc               // Round 开始占位符
    ├── pieces                                      // Piece 占位符目录
    │   ├── piece_d1002r1p1_start_20230111T193049.obarc // Piece 开始占位符，piece_DESTID_ROUNDID_PIECEID_start_DATE
    │   └── piece_d1002r1p1_end_20230111T193249.obarc   // Piece 结束占位符，piece_DESTID_ROUNDID_PIECEID_end_DATE
    └── piece_d1002r1p1                             // Piece 目录，目录命名格式为 piece_DESTID_ROUNDID_PIECEID       
        ├── piece_d1002r1p1_20230111T193049_20230111T193249.obarc // 记录了 Piece 的连续区间
        ├── checkpoint   
        │   └── checkpoint.1673436649723677822.obarc   // 记录 checkpoint_scn 信息，文件名命令格式为 checkpoint.checkpoint_scn
        │   └── checkpoint_info.0.obarc             // 记录 checkpoint 的元信息
        ├── single_piece_info.obarc                 // 记录该 Piece 的元信息
        ├── tenant_archive_piece_infos.obarc        // 记录该 Piece 之前的所有 frozen Piece 的元信息        
        ├── file_info.obarc                         // 所有日志流文件列表
        ├── logstream_1                             // 1 号日志流
        │   ├── file_info.obarc                    // 日志流1的文件列表
        │   ├── log
        │   │   └── 1.obarc                         // 1 号日志流下的归档文件  
        │   └── schema_meta                         // 记录数据字典的元信息，只会在 1 号日志流生成此文件
        │       └── 1677588501408765915.obarc                           
        └── logstream_1001                          // 1001 号日志流
            ├── file_info.obarc                      // 1001 号日志流的文件列表
            └── log
                └── 1.obarc                          // 1001 号日志流的归档文件      

log_archive_dest
    ├── ......                                   
    └── piece_d1002r1p1                             // Piece 目录，目录命名格式为 piece_DESTID_ROUNDID_PIECEID       
        ├── ......                         					// 所有日志流文件列表
        ├── logstream_1                             // 1 号日志流
        │   ├── file_info.obarc                    // 1 号日志流的文件列表
        │   ├── log
        │   │   └── 1.obarc                         // 1 号日志流下的归档文件, 由前缀标识  
        |		|       └── @APD_PART@0-32472973.obarc  // 归档文件中的实际数据，记录了日志文件的第 0~32472973 Byte 的数据 
        |		|		    └── ......  
        |		|		    └── @APD_PART@FORMAT_META.obarc // 归档文件的格式
        |		|		    └── @APD_PART@SEAL_META.obarc   // 归档文件的元信息      
        │   └── schema_meta                         // 记录数据字典的元信息，仅 1 号日志流上会生成此文件
        │       └── 1677588501408765915.obarc                           
        └── logstream_1001                          // 1001 号日志流
            ├── file_info.obarc                      // 1001 号日志流的文件列表
            └── log
                └── 1.obarc                          // 1001 号日志流的归档文件