--- title: "oceanbase.DBA_OB_TENANTS - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: oceanbase.DBA_OB_TENANTS 说明 该视图从 V4.0.0 版本开始引入。 功能描述 展示租户的基本信息。 通过系统租户查询此视图时，可以展示所有租户的信息，包括系统租户、用户创建的租户（用户租户），以及 Meta 租户。用户可以根据 TENANT_TYPE 列来区分租户类型。 通过普通租户查询此… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # oceanbase.DBA_OB_TENANTS 更新时间：2026-07-13 22:33:20 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/23100.o-dba_ob_tenants-of-sys-tenant.md) #### 说明 该视图从 V4.0.0 版本开始引入。 ## 功能描述 展示租户的基本信息。 - 通过系统租户查询此视图时，可以展示所有租户的信息，包括系统租户、用户创建的租户（用户租户），以及 Meta 租户。用户可以根据 `TENANT_TYPE` 列来区分租户类型。 - 通过普通租户查询此视图时，只展示本租户的信息。 ## 字段说明 | **字段** | **类型** | **是否可以为 NULL** | **描述** | | --- | --- | --- | --- | | TENANT_ID | bigint(20) | NO | 租户 ID： - 1：系统租户 ID - 其他值：用户租户或者 Meta 租户 ID | | TENANT_NAME | varchar(128) | NO | 租户名 | | TENANT_TYPE | varchar(4) | NO | - `SYS`：系统租户 - `USER`：用户租户 - `META`：Meta租户 | | CREATE_TIME | timestamp(6) | YES | 租户创建时间 | | MODIFY_TIME | timestamp(6) | YES | 信息更新时间 | | PRIMARY_ZONE | varchar(128) | YES | 租户 Primary Zone | | LOCALITY | varchar(4096) | NO | 租户副本分布信息 | | PREVIOUS_LOCALITY | varchar(4096) | NO | 变更前的 Locality 信息： - 如果该值有效，则说明 Locality 变更没有完成 - NULL 表示没有进行 Locality 变更 | | COMPATIBILITY_MODE | varchar(6) | NO | - `MYSQL`：MySQL 兼容模式 - `ORACLE`：Oracle 兼容模式 | | STATUS | varchar(64) | NO | 当前租户状态： - `NORMAL`：正常状态租户 - `RESTORE`：物理恢复中的租户 - `CREATING`：正在创建的租户 - `DROPPING`：正在删除的租户 | | IN_RECYCLEBIN | varchar(3) | NO | 是否在回收站中： - `YES`：在回收站中 - `NO`：不在回收站中 | | LOCKED | varchar(3) | NO | 是否是锁定状态： - `YES`：锁定状态 - `NO`：非锁定状态 通过 `ALTER TENANT xxx LOCK|UNLOCK` 命令来影响字段值 | | TENANT_ROLE | varchar(100) | NO | 集群角色： - `PRIMARY`：主租户 - `STANDBY`：备租户 - `RESTORE`：租户处于恢复中 #### 说明 该字段从 V4.1.0 版本开始引入。 | | SWITCHOVER_STATUS | varchar(100) | NO | SWITCHOVER 状态： - `NORMAL`：正常状态，未处于切换中 - `PREPARE SWITCHING TO PRIMARY`：准备备切主状态 - `SWITCHING TO PRIMARY`：备切主状态 - `PREPARE FLASHBACK`：准备 Flashback 状态 - `FLASHBACK`：Flashback 状态 - `PREPARE SWITCHING TO STANDBY`：准备主切备状态 - `SWITCHING TO STANDBY`：主切备状态 #### 说明 该字段从 V4.1.0 版本开始引入。 | | SWITCHOVER_EPOCH | bigint(20) | NO | SWITCHOVER/FAILOVER 唯一标识 #### 说明 该字段从 V4.1.0 版本开始引入。 | | SYNC_SCN | bigint(20) unsigned | NO | 当前租户已同步的快照版本，对于系统租户和 Meta 租户无意义，显示为 NULL #### 说明 该字段从 V4.1.0 版本开始引入。 | | REPLAYABLE_SCN | bigint(20) unsigned | NO | 当前租户可回放快照版本，对于系统租户和 Meta 租户无意义，显示为 NULL #### 说明 该字段从 V4.1.0 版本开始引入。 | | READABLE_SCN | bigint(20) unsigned | NO | 当前租户可读快照版本，对于系统租户和 Meta 租户无意义，显示为 NULL #### 说明 该字段从 V4.1.0 版本开始引入。 | | RECOVERY_UNTIL_SCN | bigint(20) unsigned | NO | 当前租户最大恢复位点，对于系统租户和 Meta 租户无意义，显示为 NULL #### 说明 该字段从 V4.1.0 版本开始引入。 | | LOG_MODE | varchar(100) | NO | 归档模式： - `ARCHIVELOG`：归档模式开启中 - `NOARCHIVELOG`：未开启归档模式 #### 说明 该字段从 V4.1.0 版本开始引入。 | | ARBITRATION_SERVICE_STATUS | varchar(64) | NO | 租户的仲裁服务状态，取值如下： - `ENABLING`：开启中 - `ENABLED`：开启完成 - `DISABLING`：关闭中 - `DISABLED`：关闭完成 #### 说明 该字段从 V4.1.0 版本开始引入。 | | UNIT_NUM | bigint(20) | NO | 租户各 Zone 的 `UNIT_NUM` 的最小值 #### 说明 - 该字段从 V4.2.0 版本开始引入。 - 对于 V4.6.x 版本，该字段从 V4.6.0 版本开始，字段含义从 “租户各 Zone 的 `UNIT_NUM` 值” 变更为 “租户各 Zone 的 `UNIT_NUM` 的最小值”。 - 对于 V4.4.x 版本，该字段从 V4.4.2 版本开始，字段含义从 “租户各 Zone 的 `UNIT_NUM` 值” 变更为 “租户各 Zone 的 `UNIT_NUM` 的最小值”。 - 在 V4.2.5 版本中，V4.2.5 BP5 （不含）之前版本，该字段表示租户各 Zone 的 `UNIT_NUM` 值；V4.2.5 BP5 及之后版本，该字段表示租户各 Zone 的 `UNIT_NUM` 的最小值。 | | ZONE_UNIT_NUM_LIST | varchar(65536) | NO | 展示租户下每个 Zone 内 Unit 的数量 #### 说明 - 对于 V4.6.x 版本，该字段从 V4.6.0 版本开始引入。 - 对于 V4.4.x 版本，该字段从 V4.4.2 版本开始引入。 - 对于 V4.2.5 版本，该字段从 V4.2.5 BP5 版本开始引入。 | | COMPATIBLE | varchar(65536) | NO | 兼容性版本 #### 说明 该字段从 V4.2.0 版本开始引入。 | | MAX_LS_ID | bigint(20) | NO | 租户曾经存在过的最大的日志流 ID。其中，系统租户和 Meta 租户为 1，用户租户为实际的大小。 #### 说明 该字段从 V4.2.0 版本开始引入。 | | RESTORE_DATA_MODE | varchar(128) | NO | 租户恢复数据的模式。取值如下： - `NORMAL`：表示租户是正常创建或通过全量数据恢复出来的 - `REMOTE` 表示租户是快速恢复出来的，数据处于远端引用状态 #### 说明 该字段从 V4.3.2 版本开始引入。 | | FLASHBACK_LOG_SCN | bigint(20) | NO | 租户最近一次执行日志裁剪的位点。在 Failover 后，支持通过备租户日志裁剪到指定位点的运维命令，将原主租户的备租户接入新主租户。 #### 说明 该字段从 V4.4.1 版本开始引入。 | | COMMENT | varchar(4096) | NO | 注释信息 | | PROTECTION_MODE | varchar(128) | NO | 当前租户的保护模式，当前仅支持 `MAXIMUM PERFORMANCE`（最大性能）保护模式。 #### 说明 该字段从 V4.6.0 版本开始引入。 | | PROTECTION_LEVEL | varchar(128) | NO | 当前租户的保护级别，当前仅支持 `MAXIMUM PERFORMANCE`（最大性能）保护级别。 #### 说明 该字段从 V4.6.0 版本开始引入。 | ## 查询示例 系统租户查看所有租户的基本信息。 ```shell obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_TENANTS\G ``` 查询结果如下： ```shell *************************** 1. row *************************** TENANT_ID: 1 TENANT_NAME: sys TENANT_TYPE: SYS CREATE_TIME: 2026-03-16 16:30:17.393164 MODIFY_TIME: 2026-03-16 16:30:17.393164 PRIMARY_ZONE: RANDOM LOCALITY: FULL{1}@zone1 PREVIOUS_LOCALITY: NULL COMPATIBILITY_MODE: MYSQL STATUS: NORMAL IN_RECYCLEBIN: NO LOCKED: NO TENANT_ROLE: PRIMARY SWITCHOVER_STATUS: NORMAL SWITCHOVER_EPOCH: 0 SYNC_SCN: NULL REPLAYABLE_SCN: NULL READABLE_SCN: NULL RECOVERY_UNTIL_SCN: NULL LOG_MODE: NOARCHIVELOG ARBITRATION_SERVICE_STATUS: DISABLED UNIT_NUM: 1 ZONE_UNIT_NUM_LIST: zone1:1 COMPATIBLE: 4.6.0.0 MAX_LS_ID: 1 RESTORE_DATA_MODE: NORMAL FLASHBACK_LOG_SCN: NULL COMMENT: system tenant PROTECTION_MODE: NULL PROTECTION_LEVEL: NULL *************************** 2. row *************************** TENANT_ID: 1001 TENANT_NAME: META$1002 TENANT_TYPE: META CREATE_TIME: 2026-03-16 16:31:59.900666 MODIFY_TIME: 2026-03-16 16:32:05.858000 PRIMARY_ZONE: zone1 LOCALITY: FULL{1}@zone1 PREVIOUS_LOCALITY: NULL COMPATIBILITY_MODE: MYSQL STATUS: NORMAL IN_RECYCLEBIN: NO LOCKED: NO TENANT_ROLE: PRIMARY SWITCHOVER_STATUS: NORMAL SWITCHOVER_EPOCH: 0 SYNC_SCN: NULL REPLAYABLE_SCN: NULL READABLE_SCN: NULL RECOVERY_UNTIL_SCN: NULL LOG_MODE: NOARCHIVELOG ARBITRATION_SERVICE_STATUS: DISABLED UNIT_NUM: 1 ZONE_UNIT_NUM_LIST: zone1:1 COMPATIBLE: 4.6.0.0 MAX_LS_ID: 1 RESTORE_DATA_MODE: NORMAL FLASHBACK_LOG_SCN: NULL COMMENT: PROTECTION_MODE: NULL PROTECTION_LEVEL: NULL *************************** 3. row *************************** TENANT_ID: 1002 TENANT_NAME: mysql001 TENANT_TYPE: USER CREATE_TIME: 2026-03-16 16:31:59.903787 MODIFY_TIME: 2026-03-16 16:32:05.881113 PRIMARY_ZONE: zone1 LOCALITY: FULL{1}@zone1 PREVIOUS_LOCALITY: NULL COMPATIBILITY_MODE: MYSQL STATUS: NORMAL IN_RECYCLEBIN: NO LOCKED: NO TENANT_ROLE: PRIMARY SWITCHOVER_STATUS: NORMAL SWITCHOVER_EPOCH: 0 SYNC_SCN: 1774942077352120000 REPLAYABLE_SCN: 1774942077352120000 READABLE_SCN: 1774942077252078000 RECOVERY_UNTIL_SCN: 4611686018427387903 LOG_MODE: NOARCHIVELOG ARBITRATION_SERVICE_STATUS: DISABLED UNIT_NUM: 1 ZONE_UNIT_NUM_LIST: zone1:1 COMPATIBLE: 4.6.0.0 MAX_LS_ID: 1001 RESTORE_DATA_MODE: NORMAL FLASHBACK_LOG_SCN: NULL COMMENT: PROTECTION_MODE: MAXIMUM PERFORMANCE PROTECTION_LEVEL: MAXIMUM PERFORMANCE *************************** 4. row *************************** TENANT_ID: 1003 TENANT_NAME: META$1004 TENANT_TYPE: META CREATE_TIME: 2026-03-16 16:32:16.239476 MODIFY_TIME: 2026-03-16 16:32:22.212696 PRIMARY_ZONE: zone1 LOCALITY: FULL{1}@zone1 PREVIOUS_LOCALITY: NULL COMPATIBILITY_MODE: MYSQL STATUS: NORMAL IN_RECYCLEBIN: NO LOCKED: NO TENANT_ROLE: PRIMARY SWITCHOVER_STATUS: NORMAL SWITCHOVER_EPOCH: 0 SYNC_SCN: NULL REPLAYABLE_SCN: NULL READABLE_SCN: NULL RECOVERY_UNTIL_SCN: NULL LOG_MODE: NOARCHIVELOG ARBITRATION_SERVICE_STATUS: DISABLED UNIT_NUM: 1 ZONE_UNIT_NUM_LIST: zone1:1 COMPATIBLE: 4.6.0.0 MAX_LS_ID: 1 RESTORE_DATA_MODE: NORMAL FLASHBACK_LOG_SCN: NULL COMMENT: PROTECTION_MODE: NULL PROTECTION_LEVEL: NULL *************************** 5. row *************************** TENANT_ID: 1004 TENANT_NAME: oracle001 TENANT_TYPE: USER CREATE_TIME: 2026-03-16 16:32:16.239476 MODIFY_TIME: 2026-03-16 16:32:22.233799 PRIMARY_ZONE: zone1 LOCALITY: FULL{1}@zone1 PREVIOUS_LOCALITY: NULL COMPATIBILITY_MODE: ORACLE STATUS: NORMAL IN_RECYCLEBIN: NO LOCKED: NO TENANT_ROLE: PRIMARY SWITCHOVER_STATUS: NORMAL SWITCHOVER_EPOCH: 0 SYNC_SCN: 1774942077252078000 REPLAYABLE_SCN: 1774942077252078000 READABLE_SCN: 1774942077252078000 RECOVERY_UNTIL_SCN: 4611686018427387903 LOG_MODE: NOARCHIVELOG ARBITRATION_SERVICE_STATUS: DISABLED UNIT_NUM: 1 ZONE_UNIT_NUM_LIST: zone1:1 COMPATIBLE: 4.6.0.0 MAX_LS_ID: 1001 RESTORE_DATA_MODE: NORMAL FLASHBACK_LOG_SCN: NULL COMMENT: PROTECTION_MODE: MAXIMUM PERFORMANCE PROTECTION_LEVEL: MAXIMUM PERFORMANCE 5 rows in set ``` ## 相关视图或文档 [租户类型](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682006) 上一篇 下一篇 ![有帮助](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) 咨询热线