github-fill

oceanbase.DBA_OB_TENANTS

更新时间：2026-04-10 08:30:09

编辑

说明

该视图从 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 的数量说明该字段从 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	租户恢复数据的模式。取值如下： `NORMAL`：表示租户是正常创建或通过全量数据恢复出来的 `REMOTE` 表示租户是快速恢复出来的，数据处于远端引用状态说明该字段从 V4.3.2 版本开始引入。
FLASHBACK_LOG_SCN	bigint(20)	NO	租户最近一次执行日志裁剪的位点。在 Failover 后，支持通过备租户日志裁剪到指定位点的运维命令，将原主租户的备租户接入新主租户。说明该字段从 V4.4.1 版本开始引入。
COMMENT	varchar(4096)	NO	注释信息

查询示例

系统租户查看所有租户的基本信息。

obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_TENANTS\G

查询结果如下：

*************************** 1. row ***************************
                 TENANT_ID: 1
               TENANT_NAME: sys
               TENANT_TYPE: SYS
               CREATE_TIME: 2025-12-29 15:43:42.930290
               MODIFY_TIME: 2025-12-29 15:43:42.930290
              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.4.1.0
                 MAX_LS_ID: 1
         RESTORE_DATA_MODE: NORMAL
         FLASHBACK_LOG_SCN: NULL
                   COMMENT: system tenant
*************************** 2. row ***************************
                 TENANT_ID: 1001
               TENANT_NAME: META$1002
               TENANT_TYPE: META
               CREATE_TIME: 2025-12-29 15:44:48.700796
               MODIFY_TIME: 2025-12-29 15:44:55.426243
              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.4.1.0
                 MAX_LS_ID: 1
         RESTORE_DATA_MODE: NORMAL
         FLASHBACK_LOG_SCN: NULL
                   COMMENT:
*************************** 3. row ***************************
                 TENANT_ID: 1002
               TENANT_NAME: mysql001
               TENANT_TYPE: USER
               CREATE_TIME: 2025-12-29 15:44:48.704354
               MODIFY_TIME: 2025-12-29 15:44:55.484077
              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: 1767756689874247000
            REPLAYABLE_SCN: 1767756689874247000
              READABLE_SCN: 1767756689874247000
        RECOVERY_UNTIL_SCN: 4611686018427387903
                  LOG_MODE: NOARCHIVELOG
ARBITRATION_SERVICE_STATUS: DISABLED
                  UNIT_NUM: 1
                COMPATIBLE: 4.4.1.0
                 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-12-29 15:50:35.033311
               MODIFY_TIME: 2025-12-29 15:50:42.062582
              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.4.1.0
                 MAX_LS_ID: 1
         RESTORE_DATA_MODE: NORMAL
         FLASHBACK_LOG_SCN: NULL
                   COMMENT:
*************************** 5. row ***************************
                 TENANT_ID: 1004
               TENANT_NAME: oracle001
               TENANT_TYPE: USER
               CREATE_TIME: 2025-12-29 15:50:35.034367
               MODIFY_TIME: 2025-12-29 15:50:42.114313
              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: 1767756689674334000
            REPLAYABLE_SCN: 1767756689674334000
              READABLE_SCN: 1767756689674334000
        RECOVERY_UNTIL_SCN: 4611686018427387903
                  LOG_MODE: NOARCHIVELOG
ARBITRATION_SERVICE_STATUS: DISABLED
                  UNIT_NUM: 1
                COMPATIBLE: 4.4.1.0
                 MAX_LS_ID: 1001
         RESTORE_DATA_MODE: NORMAL
         FLASHBACK_LOG_SCN: NULL
                   COMMENT:
5 rows in set

oceanbase.DBA_OB_TENANTS

说明

功能描述

字段说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

查询示例

相关视图或文档