--- title: add restore source 不支持快照恢复-OceanBase数据库使用指南 description: 了解OceanBase数据库在实际应用中关于 add restore source 不支持快照恢复相关的常见问题和使用技巧，帮助您快速解决 add restore source 不支持快照恢复的难题。 --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 划线反馈 # add restore source 不支持快照恢复 更新时间：2026-05-13 01:51 适用版本： V3.2.x 内容类型：Troubleshoot ## 问题现象 物理恢复通过 add restore source 的方式将 backup_dest 加载进去，并且 backup_dest 对应的数据有个特点，其中没有日志归档的数据，只有数据备份的 backup_set，恢复的时间点选择恢复到 backup_set 对应的位点，恢复报错 -4002，恢复失败。 ## 关键诊断信息 ### 触发条件 - 物理恢复通过 add restore source 的方式将 backup_dest 加载进去，并且 backup_dest 对应的数据有个特点，其中没有日志归档的数据，只有数据备份的 backup_set 。 - 恢复的位点选择恢复到数据 backup_set 对应的位点。 - 恢复会报错 -4002，关键信息如下。 ```shell [2024-03-12 21:09:35.615038] WDIAG [SHARE] ob_multi_backup_dest_util.cpp:300 [75417][0][xxxxx-xxxxx-xxxxx-xxxxx] [lt=7] [dc=0][errcode=-4002] backup set list or backup piece list is emtpy(ret=-4002, ret="OB_INVALID_ARGUMENT", piece_info_list=[], set_info_list=[{tenant_id:1001, backup_set_id:1, incarnation:1, copy_id:0, snapshot_version:1710248653077149, prev_full_backup_set_id:0, prev_inc_backup_set_id:0, prev_backup_data_version:0, pg_count:165, macro_block_count:63, finish_pg_count:165, finish_macro_block_count:63, input_bytes:132272049, output_bytes:3186533, start_time:1710248653077149, end_time:1710248672196429, compatible:4, cluster_version:12885033992, backup_type:{type:1}, status:1, result:0, cluster_id:1, backup_dest:"file:///data/nfs1/muwei_test/muwei_backup", backup_data_version:2, backup_schema_version:1710248573293288, partition_count:167, finish_partition_count:167, encryption_mode:0, passwd:"", file_status:0, start_replay_log_ts:1710248559913802, date:20240312, backup_level:0}, {tenant_id:1001, backup_set_id:2, incarnation:1, copy_id:0, snapshot_version:1710248747470445, prev_full_backup_set_id:1, prev_inc_backup_set_id:1, prev_backup_data_version:2, pg_count:165, macro_block_count:15, finish_pg_count:165, finish_macro_block_count:65, input_bytes:31608819, output_bytes:2765195, start_time:1710248747470445, end_time:1710248765286317, compatible:4, cluster_version:12885033992, backup_type:{type:2}, status:1, result:0, cluster_id:1, backup_dest:"file:///data/nfs1/muwei_test/muwei_backup", backup_data_version:3, backup_schema_version:1710248573293288, partition_count:167, finish_partition_count:167, encryption_mode:0, passwd:"", file_status:0, start_replay_log_ts:1710248559913802, date:20240312, backup_level:0}, {tenant_id:1001, backup_set_id:3, incarnation:1, copy_id:0, snapshot_version:1710248836664046, prev_full_backup_set_id:1, prev_inc_backup_set_id:2, prev_backup_data_version:3, pg_count:165, macro_block_count:16, finish_pg_count:165, finish_macro_block_count:66, input_bytes:33706069, output_bytes:2802417, start_time:1710248836664046, end_time:1710248862425892, compatible:4, cluster_version:12885033992, backup_type:{type:2}, status:1, result:0, cluster_id:1, backup_dest:"file:///data/nfs1/muwei_test/muwei_backup", backup_data_version:4, backup_schema_version:1710248573293288, partition_count:167, finish_partition_count:167, encryption_mode:0, passwd:"", file_status:0, start_replay_log_ts:1710248559913802, date:20240312, backup_level:0}]) ``` ### 事前巡检 无 。 ### 事后诊断 恢复报错 -4002，rootservice.log 中对应的日志关键字如下。 ```shell backup set list or backup piece list is emtpy ``` ## 问题原因 在 OceanBase 数据库 V3.x 版本中 add restore source 没有检查恢复位点是否可以不要 backup piece，要求所有的恢复必须要有 backup piece 。 ## 问题的风险及影响 备份数据不能通过 add restore source 恢复。 ## 影响租户 影响 OceanBase 数据库中的 SYS 租户和 Oracle 租户以及 MySQL 租户。 ## 影响版本 OceanBase 数据库企业版 V3.2.3 GA（oceanbase-3.2.3.0-20220418212020）及之后版本、V3.2.4 GA（oceanbase-3.2.4.0-100000072022102819）及之后版本。 ## 解决方法及规避方式 - 解决方法： 升级至问题已修复版本。目前已修复的版本包括 OceanBase 数据库 V3.2.4 BP8（oceanbase-3.2.4.8-108000142024041520）及之后版本、V3.2.3 BP11（oceanbase-3.2.3.3-111000032024070822）及之后版本。 - 规避方式： 恢复的时候使用 add restore source 需要添加 piece 相关的信息。 - 添加数据备份文件：`alter system add restore source 'file:///{backupSetFullPath}'` 。 - backupSetFullPath：具体某个备份集的绝对路径，格式如下：`{xxx}/{clusterName}/{clusterId}/incarnation_1/{tenantId}/data/{backupSet}` 命令如下。 ```shell alter system add restore source 'file:///obbackup/xxx/50000002/incarnation_1/1013/data/backup_set_25_full_20230619'; ``` - 添加日志备份文件：`alter system add restore source 'file:///{logPieceFullPath}'` 。 - logPieceFullPath：备份集所依赖的日志切片的绝对路径，格式如下：`{xxx}/{clusterName}/{clusterId}/incarnation_1/{tenantId}/clog/{logPiece}` 命令如下。 ```shell alter system add restore source 'file:///obbackup/xxx/50000002/incarnation_1/1013/clog/2_34_20230618'; ``` #### 注意 当备份文件位于 OSS 时，需要将 ak、sk 以及 endpoint 信息追加在 url 末端。 示例命令如下。 ```shell alter system add restore source 'oss://{backupSetFullPath}?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx'; ``` ```shell alter system add restore source 'oss://{logPieceFullPath}?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx'; ``` #### 注意 若添加备份集信息时填写错误，需要通过如下命令清空已输入的信息。 示例命令如下。 ```shell alter system clear restore source; ``` 上一篇 [OceanBase 数据库 V4.2 版本恢复 V4.1 版本备份的租户无法正常解析](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000340641) 下一篇 [物理恢复耗时过久的问题](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000297643) ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线