github-fill

oceanbase.DBA_OB_TENANTS

更新时间：2026-04-10 11:58:02

编辑

说明

从 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 版本开始引入。

查询示例

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

obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_TENANTS\G

查询结果如下：

*************************** 1. row ***************************
                 TENANT_ID: 1
               TENANT_NAME: sys
               TENANT_TYPE: SYS
               CREATE_TIME: 2024-08-05 11:42:58.780027
               MODIFY_TIME: 2024-08-05 11:42:58.780027
              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.0.1
                 MAX_LS_ID: 1
*************************** 2. row ***************************
                 TENANT_ID: 1001
               TENANT_NAME: META$1002
               TENANT_TYPE: META
               CREATE_TIME: 2024-08-05 11:44:10.600751
               MODIFY_TIME: 2024-08-05 11:44:29.693855
              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.0.1
                 MAX_LS_ID: 1
*************************** 3. row ***************************
                 TENANT_ID: 1002
               TENANT_NAME: mysql001
               TENANT_TYPE: USER
               CREATE_TIME: 2024-08-05 11:44:10.605796
               MODIFY_TIME: 2024-08-05 11:44:29.735090
              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: 1722938413993944087
            REPLAYABLE_SCN: 1722938413993944087
              READABLE_SCN: 1722938413993944086
        RECOVERY_UNTIL_SCN: 4611686018427387903
                  LOG_MODE: NOARCHIVELOG
ARBITRATION_SERVICE_STATUS: DISABLED
                  UNIT_NUM: 1
                COMPATIBLE: 4.3.0.1
                 MAX_LS_ID: 1001
*************************** 4. row ***************************
                 TENANT_ID: 1003
               TENANT_NAME: META$1004
               TENANT_TYPE: META
               CREATE_TIME: 2024-08-05 11:44:46.028485
               MODIFY_TIME: 2024-08-05 11:45:07.046377
              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.0.1
                 MAX_LS_ID: 1
*************************** 5. row ***************************
                 TENANT_ID: 1004
               TENANT_NAME: oracle001
               TENANT_TYPE: USER
               CREATE_TIME: 2024-08-05 11:44:46.028485
               MODIFY_TIME: 2024-08-05 11:45:07.082187
              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: 1722938414494912905
            REPLAYABLE_SCN: 1722938414494912905
              READABLE_SCN: 1722938414494912904
        RECOVERY_UNTIL_SCN: 4611686018427387903
                  LOG_MODE: NOARCHIVELOG
ARBITRATION_SERVICE_STATUS: DISABLED
                  UNIT_NUM: 1
                COMPATIBLE: 4.3.1.0
                 MAX_LS_ID: 1001
5 rows in set

oceanbase.DBA_OB_TENANTS

说明

功能描述

字段说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

说明

查询示例

相关视图或文档