物理备库 | OceanBase 文档中心

物理备库

更新时间：2026-04-13 16:46:32

本文介绍物理备库功能，该功能为 OceanBase v4.x 新支持的功能，可以为用户的关键应用提供高可用、数据保护、灾难恢复等重要特性。涉及到的资源为 OBTenant 和 OBTenantOperation，分别表示租户资源和租户运维操作。物理备库可以从数据备份中创建，也可以从空租户开始创建，所以此部分与数据恢复相关性较高，互为补充。

配置文件示例

物理备库的配置也内置于 OBTenant 资源当中，具体可参见数据恢复章节的介绍。

apiVersion: oceanbase.oceanbase.com/v1alpha1  
kind: OBTenant  
metadata:  
  name: t1s
  # namespace: oceanbase
spec: 
  obcluster: obcluster
  tenantName: t1s
  unitNum: 1 
  tenantRole: STANDBY
  source:
    restore:
      bakDataSource: 
        # type: "NFS"
        # path: "t1/dataBackup"
        type: "OSS"
        path: "oss://bucket/backup?host=oss-cn-hangzhou.aliyuncs.com"
        ossAccessSecret: "oss-access"
      archiveSource:
        # type: "NFS"
        # path: "t1/logArchive"
        type: "OSS"
        path: "oss://bucket/archive?host=oss-cn-hangzhou.aliyuncs.com"
        ossAccessSecret: "oss-access"
      until: 
        unlimited: true
      replayLogUntil:
        unlimited: true
    tenant: t1
  fields: values

物理备库相关配置项说明：

tenantRole：租户的角色，若租户需要作为备库则设置为 STANDBY，若不设置则为默认值 PRIMARY
source：租户数据来源
- restore：备份数据恢复源
- tenant：指定需要同步的主租户

配置项组合说明

OBTenant.Spec.Source 当中有两个分支 restore 和 tenant 分别指定数据恢复源和主租户，当两个分支的组合条件不同时，Operator 会产生出不同的行为：

同时提供 restore 和 tenant：按照 restore 属性恢复出租户，恢复完成后修改备租户的日志恢复源到主租户处，根据设定的数据恢复截止位点和日志回放截止位点回放日志；
只提供 restore：按照 restore 属性恢复出租户，并且按照 tenantRole 修改租户角色属性；
只提供 tenant：检查指定租户资源的存在性和 LS 日志完整性，如果检查通过，则创建出一个空备租户同步到指定的主租户；
restore 和 tenant 均不提供：无法通过校验提交到集群中。

备租户升主和主备互切

此部分功能请参见租户运维操作。