---
title: "物理备库 | OceanBase 文档中心"
description: 物理备库 本文介绍物理备库功能，该功能为 OceanBase v4.x 新支持的功能，可以为用户的关键应用提供高可用、数据保护、灾难恢复等重要特性。涉及到的资源为 OBTenant 和 OBTenantOperation，分别表示租户资源和租户运维操作。物理备库可以从数据备份中创建，也可以从空租户开始创建，所以此部分…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*_Ef7QIYUi3gAAAAAAAAAAAAADiGDAQ/original) ob-operatorV 2.2.0 社区版

# 物理备库

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

[编辑](https://github.com/oceanbase/ob-operator-doc/edit/V2.2.0/zh-CN/500.ob-operator-user-guide/300.high-availability/600.standby-tenant-of-ob-operator.md)  

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

## 配置文件示例

物理备库的配置也内置于 OBTenant 资源当中，具体可参见[数据恢复](https://www.oceanbase.com/docs/community-ob-operator-doc-1000000000659355)章节的介绍。

```yaml
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 均不提供：无法通过校验提交到集群中。

## 备租户升主和主备互切

此部分功能请参见[租户运维操作](https://www.oceanbase.com/docs/community-ob-operator-doc-1000000000659344)。

 上一篇 下一篇 ![有帮助](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) 咨询热线