9000 ~ 9499

此范围表示备份恢复错误码及 STORAGE 3.0 错误码。

ERROR 9001 (HY000) : URI error

• OceanBase 错误码：9001

• 错误原因：可能是由于备份恢复设置的目的端链接有误。

• 解决方式：检查备份恢复的相关配置，并进行修改。

ERROR 9002 (HY000) : OSS file MD5 error

• OceanBase 错误码：9002

• 错误原因：OSS 文件的数据校验有误，可能是 OSS 上面数据出现异常错误。

• 解决方式：联系 OSS 技术支持人员，排查具体原因。

ERROR 9003 (HY000) : OSS error

• OceanBase错误码：9003

• 错误原因：OSS 遇到未知错误。

• 解决方式：联系 OSS 技术支持人员，排查具体原因。

相关问题案例：

• 设置备份路径失败，错误信息 OSS error
• 备份恢复失败，租户一直处于恢复中

ERROR 9004 (HY000) : Init MD5 fail

• OceanBase 错误码：9004

• 错误原因：OpenSSL 初始化 MD5 错误。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9005 (HY000) : Out of element

• OceanBase 错误码：9005

• 错误原因：超过分片的限制。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9006 (HY000) : Update MD5 fail

• OceanBase 错误码：9006

• 错误原因：更新 MD5 失败。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9007 (HY000) : Invalid OSS file length

• OceanBase 错误码：9007

• 错误原因：无效的 OSS 文件长度，可能是错误的 OSS 文件。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9010 (HY000) : OSS file MD5 not match

• OceanBase 错误码：9010

• 错误原因：OSS 文件校验和不匹配，可能是 OSS 的数据异常或者备份恢复的程序 Bug。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9011 (HY000) : cannot find backup file

• OceanBase 错误码：9011

• 错误原因：无法找到备份文件，可能是指定的备份恢复的配置有误。

• 解决方式：检查备份恢复的相关配置，并进行修改。

相关问题案例：

• 备份异地恢复报错备份对象无法恢复至时间点

ERROR 9012 (HY000) : Can not get data version from timestamp

• OceanBase 错误码：9012

• 错误原因：逻辑恢复的参数中没有传递 data version。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9013 (HY000) : Write OSS file error

• OceanBase 错误码：9013

• 错误原因：写 OSS 文件出现异常错误，可能是 OSS 出现了未知问题。

• 解决方式：联系 OSS 技术支持人员，排查具体原因。

ERROR 9014 (HY000) : Another restore is in progress

• OceanBase 错误码：9014

• 错误原因：恢复的租户有同名的租户名存在。

• 解决方式：检查恢复租户的用户名是否有重复，如果有，改用不重复的租户名。

ERROR 9016 (HY000) : ob cluster name not equal

• OceanBase错误码：9016

• 错误原因：逻辑备份的集群名和 URL 不一致。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9017 (HY000) : rs list invalid

• OceanBase 错误码：9017

• 错误原因：RS 列表无效，可能是指定的 RS 列表有误。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9018 (HY000) : agent has failed task

• OceanBase 错误码：9018

• 错误原因：逻辑备份存在失败的任务。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9019 (HY000) : restore partition is complete

• OceanBase错误码：9019

• 错误原因：已经恢复的 Partition 被重复调度恢复任务。

• 解决方式：无需处理。

ERROR 9020 (HY000 ) : restore partition twice

• OceanBase 错误码：9020

• 错误原因：已经恢复的 Partition 被重复调度恢复任务。

• 解决方式：无需处理。

ERROR 9022 (HY000) : physical backup switch is on

• OceanBase 错误码：9022

• 错误原因：物理备份的时候，延迟删除表。

• 解决方式：无需处理，等物理备份完成后会自动删除。

ERROR 9023 (HY000) : cannot start log archive backup

• OceanBase 错误码：9023

• 错误原因：日志归档期间无法重复开启日志归档。

• 解决方式：避免重复调度开启日志归档的命令。

ERROR 9024 (HY000) : log archive backup is already disabled

• OceanBase 错误码：9024

• 错误原因：Stop 阶段的日志归档不能重复关闭。

• 解决方式：避免重复关闭已经关闭的日志归档。

ERROR 9025 (HY000) : log archive backup info not exists

• OceanBase 错误码：9025

• 错误原因：日志归档信息的文件不存在。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9026 (HY000) : %s is not a valid uri

• OceanBase 错误码：9026

• 错误原因：备份的目的端是无效的。

• 解决方式：检查备份的 backup_dest 是否合理，提供可用的 backup_dest 路径。

相关问题案例：

• 设置备份路径失败 backup destination is not valid

ERROR 9027 (HY000) : ob log archive interrupted

• OceanBase 错误码：9027

• 错误原因：日志归档断流。

• 解决方式：检查是否有大量写入导致日志归档来不及，如果没有，请联系 OceanBase 技术户支持人员协助排查。

ERROR 9028 (HY000) : ob log archive stat not match

• OceanBase 错误码：9028

• 错误原因：日志归档的状态对不上。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9029 (HY000) : log archive is not running

• OceanBase 错误码：9029

• 错误原因：日志归档没有 Running，一般是执行停止备份的时候 OBServer 节点打印的错误。

• 解决方式：不需要人工介入，只是正常退出日志归档的报错日志。

ERROR 9030 (HY000) : log archive invalid round

• OceanBase 错误码：9030

• 错误原因：日志归档的 Round 信息不对。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9031 (HY000) : Cannot backup ob replica

• OceanBase 错误码：9031

• 错误原因：该 Replica 正在迁移复制或者是日志副本，无法提供数据备份的能力。

• 解决方式：OceanBase 数据库会内部重试，不需要人工介入。

ERROR 9032 (HY000) : backup info not exists

• OceanBase 错误码：9032

• 错误原因：备份信息不存在。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

相关问题案例：

• 备份进程长时间运行且日志报 9032

ERROR 9033 (HY000) : Backup meta info stored in system dictionary does not match with current system status

• OceanBase 错误码：9033

• 错误原因：备份的状态不一致。

• 解决方式：

  • 如果是 OBServer 节点的日志归档报错，一般是启停日志归档的时候发生的，不需要人工介入。

  • 如果是 Root Service 的日志，联系 OceanBase 技术支持人员，排查具体原因。

ERROR 9035 (HY000) : restore index failed

• OceanBase 错误码：9035

• 错误原因：恢复完成后，重建索引失败。

• 解决方式：需要检查下恢复租户内部表锁索引状态为 error 的索引，然后重新创建该索引。

ERROR 9036 (HY000) : Backup is in progress

• OceanBase 错误码：9036

• 错误原因：一般是执行了和备份互斥的操作。

• 解决方式：停止数据备份和日志归档以后再执行该命令。

ERROR 9037 (HY000) : log archive status is not valid

• OceanBase 错误码：9037

• 错误原因：日志归档的状态非法。

• 解决方式：请联系 OceanBase 技术支持人员协助排查。

ERROR 9038 (HY000) : Cannot add replica during set member list in restore

• OceanBase 错误码：9038

• 错误原因：set member list 阶段不支持复制。

• 解决方式：恢复的 set member list 步骤无法支持副本的复制，如果此时还有多数派副本，那么恢复能够继续下去；如果已经不存在多数派副本了，需要取消恢复然后重新调度恢复任务。

ERROR 9039 (HY000) : pg log archive leader changed

• OceanBase 错误码：9039

• 错误原因：日志归档的 Leader 已经切换了。

• 解决方式：内部错误码。检测到 Leader 切换以后会打断当前 PG 的日志归档流程。新的 Leader 会自动继续制定备份工作，不需要运维介入。

ERROR 9040 (HY000) : backup can not start

• OceanBase 错误码：9040

• 错误原因：日志归档不是 DOING 状态，不能开启数据备份。

• 解决方式：等待日志归档进入 DOING 状态，如果长期处于 BEGINNING 状态，需要联系 OceanBase 技术支持人员，排查具体原因。

ERROR 9041 (HY000) : cancel backup do not allow

• OceanBase 错误码：9041

• 错误原因：不允许重复取消备份任务。

• 解决方式：避免重复取消正在取消中的任务。

ERROR 9042 (HY000) : backup data version gap over limit

• OceanBase 错误码：9042

• 错误原因：数据备份在超过 16 次数的 Major Merge 期间没有完成，会主动失败。

• 解决方式：排查数据备份慢的原因或者确认 Major Merge 是否过于频繁。

ERROR 9044 (HY000) : delete backup data is in progress

• OceanBase 错误码：9044

• 错误原因：不允许重复调度清理备份的任务。

• 解决方式：避免重复调度清理备份的任务。

ERROR 9045 (HY000) : delete backup set do not allow

• OceanBase 错误码：9045

• 错误原因：不允许删除备份集。

• 解决方式：检查是否输入了错误的删除命令。

ERROR 9046 (HY000) : backup set id is not valid

• OceanBase 错误码：9046

• 错误原因：备份集 ID 无效，可能指定了无效的 backup_set_id。

• 解决方式：检查输入的 backup_set_id 是否正确，并进行重试。

ERROR 9047 (HY000) : invalid password for backup

• OceanBase 错误码：9047

• 错误原因：无效的密码。

• 解决方式：检查密码是否正确，并进行重试。

ERROR 9048 (HY000) : backup set is isolated by two log archive round

• OceanBase 错误码：9048

• 错误原因：数据备份和日志归档不连续。

• 解决方式：检查日志归档是否已经断流了。

ERROR 9049 (HY000) : backup status is stopped, can not cancel

• OceanBase 错误码：9049

• 错误原因：备份已经停止了，不能够被再次取消。

• 解决方式：不需要额外处理，备份已经停止了。

ERROR 9050 (HY000) : no backup data to be backuped up

• OceanBase 错误码：9050

• 错误原因：调度的备份任务没有需要备份的数据。

• 解决方法：一般出现在备份的场景，不需要处理。

ERROR 9051 (HY000) : backup mount file is not valid

• OceanBase 错误码：9051

• 错误原因：OBServer 节点存在没有挂载 NFS 的节点。

• 解决方法：需要保证所有节点都挂载 NFS。

ERROR 9052 (HY000) : backup clean info not match

• OceanBase 错误码：9052

• 错误原因：备份清理的元信息不一致。

• 解决方法：联系 OceanBase 的技术支持人员协助排查。

ERROR 9053 (HY000) : cancel delete backup do not allow

• OceanBase 错误码：9053

• 错误原因：没有清理任务的时候发起了 Cancel。

• 解决方法：避免在没有清理任务的时候发起 Cancel。

ERROR 9054 (HY000) : backup clean info not exists

• OceanBase 错误码：9054

• 错误原因：清理的元信息不存在。

• 解决方法：联系 OceanBase 的技术支持人员协助排查。

ERROR 9057 (HY000) : can not set backup region, because %s

• OceanBase 错误码：9057

• 错误原因：不能修改备份的 Region。

• 解决方法：记录错误提示信息，然后联系 OceanBase 技术支持人员协助排查。

ERROR 9058 (HY000) : can not set backup zone, because %s

• OceanBase 错误码：9058

• 错误原因：不能修改备份的 Zone。

• 解决方法：记录错误提示信息，然后联系 OceanBase 技术支持人员协助排查。

ERROR 9059 (HY000) : backup backup has reached max backup times

• OceanBase 错误码：9059

• 错误原因：内部错误码。主要用在内部调度备份进行备份的时候，发现 Backup Set 或者 Backup Piece 都满足最大 Backup Times 要求的场景。

• 解决方法：无需处理。

ERROR 9060 (HY000) : COS error

• OceanBase 错误码：9060

• 错误原因：负责腾讯云 COS 适配的模块报错。

• 解决方法：一般是 OceanBase 数据库适配 COS 的逻辑错误，需要联系 OceanBase 技术支持人员。

ERROR 9061 (HY000) : IO limit

• OceanBase 错误码：9061

• 错误原因：这个是 IO 受限制导致的。目前只有腾讯云的 COS 模块的 List 操作会返回该错误码。

• 解决方法：需要联系 COS 的客户支持人员调大或者去掉 List 的限流。

ERROR 9062 (HY000) : reach backup backup copy limit

• OceanBase 错误码：9062

• 错误原因：调度指定 Backup Times 的备份进行备份的时候，发现所有的 backup_set 和 backup_piece 都已经满足 Backup Times 的要求，找不到需要备份的备份的 backup_set 或者 backup_piece。

• 解决方法：无需处理。

ERROR 9063 (HY000) : backup io is prohibited

• OceanBase 错误码：9063

• 错误原因：在 COS 环境下的备份恢复执行 List 操作被限流。

• 解决方法：

  • 如果偶尔出现这个问题，无需处理。

  • 如果经常出现这个问题，需要联系备份的 COS 客户支持人员，调大或者去掉 List 操作的频率限制。

ERROR 9064 (HY000) : the archive log and backup data are not continuous

• OceanBase 错误码：9064

• 错误原因：日志归档的数据和原备份数据不连续。

• 解决方法：

  • V2.2.X 版本：需要重新进行一次合并，然后重新发起一次数据备份。

  • V3.1.X 版本及以后版本：重新发起一次数据备份。

ERROR 9065 (HY000) : agent has suspended

• OceanBase 错误码：9065

• 错误原因：逻辑备份恢复暂停备份功能的时候正在做的任务会返回这个错误码。

• 解决方法：这个错误码对功能不影响，逻辑备份会被暂停，后续可以重新开启。

ERROR 9066 (HY000) : %.*s is conflict with %.*s

• OceanBase 错误码：9066

• 错误原因：存在冲突的值。

• 解决方式：请检查冲突的值，并确保其与其他值不冲突。

ERROR 9069 (HY000) : deleting backup piece is not allowed

• OceanBase 错误码：9069

• 错误原因：不允许删除备份日志分片。

• 解决方式：检查是否输入了错误的删除命令。

ERROR 9070 (HY000) : can not connect to backup destination

• OceanBase 错误码：9070

• 错误原因：存在 OBServer 节点与备份介质不联通，如：NFS 未 mount，对象存储无访问权限。

• 解决方式：正确的 mount NFS，或为对象存储设置正确的授权信息或放开必要的操作权限。

ERROR 9071 (HY000) : no I/O operation permission at the backup destination

• OceanBase 错误码：9071

• 错误原因：OBServer 节点对备份介质无操作权限。

• 解决方式：为没有权限的操作放开权限。

ERROR 9072 (HY000) : obesi process session conflicts

• OceanBase 错误码：9072

• 错误原因：备份 I/O 独立子进程的 Session 冲突。

• 解决方式：无需处理。

ERROR 9073 (HY000) : external storage OBS error

• OceanBase 错误码：9073

• 错误原因：备份介质是华为云 OBS 时，可能发生了存储介质层面的错误。

• 解决方式：需要用户检查华为云 OBS 是否连接正常、写入正常等情况。

ERROR 9074 (HY000) : backup validation task skipped

• OceanBase 错误码：9074

• 错误原因：删除租户后，该租户的备份校验被跳过。

• 解决方式：无需处理。

ERROR 9075 (HY000) : obesi process io error

• OceanBase 错误码：9075

• 错误原因：由于 obesi 进程状态异常导致的备份恢复 I/O 失败。

• 解决方式：无需处理。

ERROR 9076 (HY000) : backup meta index does not exist

• OceanBase 错误码：9076

• 错误原因：备份数据的元信息索引不存在。

• 解决方式：请联系技术支持人员协助排查。

ERROR 9077 (HY000) : log discontinuous between two archive rounds

• OceanBase 错误码：9077

• 错误原因：连续读取归档日志时，两个连续的 round 日志不连续，无法连续读取日志。

• 解决方式：请联系技术支持人员协助排查。

ERROR 9078 (HY000) : archive log is to end

• OceanBase 错误码：9078

• 错误原因：连续读取归档日志已经到最后。

• 解决方式：无需处理。

ERROR 9079 (HY000) : archive log had been recycled

• OceanBase 错误码：9079

• 错误原因：连续读取归档日志时，发现日志已经被回收。

• 解决方式：请联系技术支持人员协助排查。

ERROR 9080 (HY000) : the format file does not exist under the destination

• OceanBase 错误码：9080

• 错误原因：备份目的端的 Format 文件不存在。原因如下：

  • 目的端在参与备份任务前，Format 文件被移除。
  • 设置的目的端非空，且目的端下没有 Format 文件。

• 解决方式：检查备份目的端的 Format 文件是否存在，如果不存在，则此目的端已失效。设置新的目的端时，需要将目的端的文件都清空后，再加入备份。

ERROR 9081 (HY000) : the content of the format file at the destination does not match

• OceanBase 错误码：9081

• 错误原因：备份目的端的 Format 文件信息不匹配。原因如下：

  • 设置目的端时，使用了其他集群/租户/备份类型的目的端。
  • 目的端的 Format 文件被破坏。

• 解决方式：确定目的端的备份信息所属的集群/租户/备份类型等是否与正要参与备份的集群/租户/备份类型匹配，如果不匹配，需要更换正确的目的端。

ERROR 9082 (HY000) : backup device out of space

• OceanBase 错误码：9082

• 错误原因：备份磁盘存储空间不足。

• 解决方式：给备份存储空间扩容。

ERROR 9083 (HY000) : the pwrite offset of the object storage is inconsistent

• OceanBase 错误码：9083

• 错误原因：备份恢复追加写文件的偏移量与文件长度不符。

• 解决方式：无需处理。

ERROR 9084 (HY000) : the contents of pwrite are inconsistent

• OceanBase 错误码：9084

• 错误原因：备份恢复追加写文件的内容与文件已有内容不符。

• 解决方式：无需处理。

ERROR 9085 (HY000) : backup major SSTable range not cover minor SSTable

• OceanBase 错误码：9085

• 错误原因：备份 major SSTable 的范围没有覆盖 minor SSTable。

• 解决方式：无需处理，备份内部会重试。

ERROR 9086 (HY000) : backup advance checkpoint by flush timeout

• OceanBase 错误码：9086

• 错误原因：备份推日志流位点超时。

• 解决方式：请联系技术支持人员协助排查。

ERROR 9087(HY000) : observer clog is recycled before archive

• OceanBase 错误码：9087
• 错误原因：消费归档时归档文件已经被回收了。

ERROR 9088 (HY000) : log restore source tenant state not match, switchover to primary not allowed

• OceanBase 错误码：9088
• 错误原因：日志恢复源租户/日志流状态不匹配，不允许当前租户切换为主租户。
• 解决方法：
  1. 检查备份恢复的源租户状态与目标租户状态是否匹配。
  2. 检查主从复制配置是否正确。
  3. 检查源租户的备份是否完整，以及目标租户的恢复是否正确。

ERROR 9089 (HY000) : log restore source ls state not match, switchover to primary not allowed

• OceanBase 错误码：9089
• 错误原因：日志恢复源租户/日志流状态不匹配，不允许当前租户切换为主租户。
• 解决方法：
  1. 检查备份恢复的源日志状态与目标日志状态是否匹配。
  2. 检查主从复制配置是否正确。
  3. 检查源日志的备份是否完整，以及目标日志的恢复是否正确。

ERROR 9090 (HY000) : obesi process session not exist

• OceanBase 错误码：9090

• 错误原因：obesi 进程会话不存在。

• 解决方式：obesi 进程会自动重启，不需要人工处理。

ERROR 9091 (HY000) : Already in ARCHIVELOG mode

• OceanBase 错误码：9091

• 错误原因：已经处于 ARCHIVELOG 模式。

• 解决方式：当前状态提示，无需处理。

ERROR 9092 (HY000) : Already in NOARCHIVELOG mode

• OceanBase 错误码：9092

• 错误原因：已经处于 NOARCHIVELOG 模式。

• 解决方式：当前状态提示，无需处理。

ERROR 9096 (HY000) : standby binary version is lower than primary data version, standby need upgrade

• OceanBase 错误码：9096
• 错误原因：备库版本落后于主库版本。
• 解决方式：检查备库版本和主库版本，需要等待备库升级完成。

ERROR 9097 (HY000) : primary tenant has been dropped

• OceanBase 错误码：9097
• 错误原因：主备同步过程中，主租户被删除。
• 解决方式：检查主库的租户信息，确认是否存在主租户。

ERROR 9098 (HY000) : normal object in object_storage(oss,cos,etc.) can't be appended content

• OceanBase 错误码：9098
• 错误原因：在尝试向对象存储（如 OSS、COS 等）中的普通对象追加内容时出错。
• 解决方式：检查对象存储类型，确保正在使用的对象存储类型支持向普通对象追加内容。

ERROR 9099 (HY000) : %s restore failed, %s

• OceanBase 错误码：9099

• 错误原因：恢复操作失败。

• 解决方法：检查恢复的配置和参数设置，确保它们与恢复目标的要求和期望一致。

ERROR 9100 (HY000) : no such file or directory

• OceanBase 错误码：9100

• 错误原因：存储层找不到对应的目录或者文件，可能是配置的存储目录有问题。

• 解决方式：请联系技术支持人员协助排查。

ERROR 9101 (HY000) : file or directory already exist

• OceanBase 错误码：9101

• 错误原因：对应的文件或者目录已经存在。

• 解决方式：内部错误码，请联系技术支持人员协助排查。

ERROR 9200 (HY000) : Extend ssblock file to smaller is not allowed

• OceanBase 错误码：9200

• 错误原因：SSBlock 文件不支持调小。

• 解决方式：请排查 ALTER SYSTEM SET datafile_size 指定的大小是否大于当前 SSBlock 文件，或者联系技术支持人员协助排查。

ERROR 9201 (HY000) : Mark blocks timeout(5s) in auto extend process when alloc block fail

• OceanBase 错误码：9201

• 错误原因：SSBlock 文件自动扩容后，宏块标记失败。

• 解决方式：请联系技术支持人员协助排查。

ERROR 9202 (HY000) : Auto extend param is not ready to start extending file

• OceanBase 错误码：9202

• 错误原因：可能由于配置等问题，未启动自动扩容，或 datafile 预设磁盘占用资源达到了上限。

• 解决方式：检查 __all_virtual_disk_stat 表中 free_size 字段是否为 0。如果是，说明磁盘空间已经用尽，需要增大 datafile 阈值或进行磁盘扩容。