基于湖库一体架构，统一管理结构化、半结构化与非结构化等多模态数据，一个系统承载事务处理、实时分析与 AI 工作负载。
文档反馈
oceanbase.DBA_OB_TENANTS
更新时间：2026-01-29 11:28:31
编辑
分享
说明
该视图从 V4.0.0 版本开始引入。
功能描述
展示租户的基本信息。
- 通过系统租户查询此视图时，可以展示所有租户的信息，包括系统租户、用户创建的租户（用户租户），以及 Meta 租户。用户可以根据
TENANT_TYPE列来区分租户类型。 - 通过普通租户查询此视图时，只展示本租户的信息。
字段说明
| 字段 | 类型 | 是否可以为 NULL | 描述 |
|---|---|---|---|
| TENANT_ID | bigint(20) | NO | 租户 ID：
|
| TENANT_NAME | varchar(128) | NO | 租户名 |
| TENANT_TYPE | varchar(4) | NO |
|
| 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 信息：
|
| COMPATIBILITY_MODE | varchar(6) | NO |
|
| STATUS | varchar(64) | NO | 当前租户状态：
|
| IN_RECYCLEBIN | varchar(3) | NO | 是否在回收站中：
|
| LOCKED | varchar(3) | NO | 是否是锁定状态：
ALTER TENANT xxx LOCK|UNLOCK 命令来影响字段值 |
| TENANT_ROLE | varchar(100) | NO | 集群角色：
说明该字段从 V4.1.0 版本开始引入。 |
| SWITCHOVER_STATUS | varchar(100) | NO | SWITCHOVER 状态：
说明该字段从 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 | 归档模式：
说明该字段从 V4.1.0 版本开始引入。 |
| ARBITRATION_SERVICE_STATUS | varchar(64) | NO | 租户的仲裁服务状态，取值如下：
说明该字段从 V4.1.0 版本开始引入。 |
| UNIT_NUM | bigint(20) | NO | Zone 内 Unit 的数量
说明该字段从 V4.2.0 版本开始引入。 |
| 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 | 租户恢复数据的模式。取值如下：
说明该字段从 V4.3.2 版本开始引入。 |
| FLASHBACK_LOG_SCN | bigint(20) | NO | 租户最近一次执行日志裁剪的位点。在 Failover 后，支持通过备租户日志裁剪到指定位点的运维命令，将原主租户的备租户接入新主租户。
说明该字段从 V4.4.1 版本开始引入。 |
| COMMENT | varchar(4096) | NO | 注释信息 |
查询示例
系统租户查看所有租户的基本信息。
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_TENANTS\G
查询结果如下：
*************************** 1. row ***************************
TENANT_ID: 1
TENANT_NAME: sys
TENANT_TYPE: SYS
CREATE_TIME: 2025-08-08 10:27:32.402236
MODIFY_TIME: 2025-08-08 10:27:32.402236
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
COMPATIBLE: 4.3.2.1
MAX_LS_ID: 1
RESTORE_DATA_MODE: NULL
FLASHBACK_LOG_SCN: NULL
COMMENT: system tenant
*************************** 2. row ***************************
TENANT_ID: 1001
TENANT_NAME: META$1002
TENANT_TYPE: META
CREATE_TIME: 2025-08-08 10:28:21.351229
MODIFY_TIME: 2025-08-08 10:28:41.006972
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
COMPATIBLE: 4.3.2.1
MAX_LS_ID: 1
RESTORE_DATA_MODE: NULL
FLASHBACK_LOG_SCN: NULL
COMMENT:
*************************** 3. row ***************************
TENANT_ID: 1002
TENANT_NAME: mysql001
TENANT_TYPE: USER
CREATE_TIME: 2025-08-08 10:28:21.355856
MODIFY_TIME: 2025-08-08 10:28:41.044814
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: 1723170391676016002
REPLAYABLE_SCN: 1723170391676016002
READABLE_SCN: 1723170391676016001
RECOVERY_UNTIL_SCN: 4611686018427387903
LOG_MODE: NOARCHIVELOG
ARBITRATION_SERVICE_STATUS: DISABLED
UNIT_NUM: 1
COMPATIBLE: 4.3.2.1
MAX_LS_ID: 1001
RESTORE_DATA_MODE: NORMAL
FLASHBACK_LOG_SCN: NULL
COMMENT:
*************************** 4. row ***************************
TENANT_ID: 1003
TENANT_NAME: META$1004
TENANT_TYPE: META
CREATE_TIME: 2025-08-08 10:28:52.519229
MODIFY_TIME: 2025-08-08 10:29:14.862212
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
COMPATIBLE: 4.3.2.1
MAX_LS_ID: 1
RESTORE_DATA_MODE: NULL
FLASHBACK_LOG_SCN: NULL
COMMENT:
*************************** 5. row ***************************
TENANT_ID: 1004
TENANT_NAME: oracle001
TENANT_TYPE: USER
CREATE_TIME: 2025-08-08 10:28:52.519229
MODIFY_TIME: 2025-08-08 10:29:14.902080
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: 1723170391676016001
REPLAYABLE_SCN: 1723170391676016001
READABLE_SCN: 1723170391676016001
RECOVERY_UNTIL_SCN: 4611686018427387903
LOG_MODE: NOARCHIVELOG
ARBITRATION_SERVICE_STATUS: DISABLED
UNIT_NUM: 1
COMPATIBLE: 4.3.2.1
MAX_LS_ID: 1001
RESTORE_DATA_MODE: NORMAL
FLASHBACK_LOG_SCN: NULL
COMMENT:
5 rows in set
