查看租户和资源信息

本文介绍如何通过视图查看租户以及资源的相关信息。

租户的资源

数据库中的资源分为逻辑资源和物理资源两大类。逻辑资源指的是逻辑概念对应的实体，包括数据结构、线程、锁、会话等。物理资源指的是硬件资源，包括 CPU、磁盘、内存等。租户能够创建的逻辑资源量受物理资源的限制，一个逻辑资源可能受一个或者多个物理资源的限制。

逻辑资源

OceanBase 数据库中的逻辑资源及相关说明如下表所示。

资源名称	描述
LS	日志流，事务基础提交单位，租户在该节点上能够创建的日志流个数由隐藏配置项（`_max_ls_cnt_per_server`）、租户内存（`MAX(8, (MEMORY_SIZE - 4G) / 200MB + 8)`）、日志盘大小共同决定。其中：租户级隐藏配置项 `_max_ls_cnt_per_server` 用于配置租户单个节点上最大支持的日志流实体个数，取值范围为 [0, 1024]，默认值为 0，表示不配置，由系统自动按照一定的规则计算出可以支持的日志流数。该配置项修改后立即生效，不需要重启 OBServer 节点。 `MEMORY_SIZE` 为该租户的资源池中 Unit 的内存规格，表示租户可使用的内存。每个日志流实体需要占用的日志盘大小为 512 MB。
TABLET	数据分片，数据迁移的基本单位，租户在该节点上能够创建 Tablet 个数的上限由配置项和租户内存共同决定，其计算公式为 `(MEMORY_SIZE/1GB) * _max_tablet_cnt_per_gb` 和 `(MEMORY_SIZE * _storage_meta_memory_limit_percentage) / 200MB * 20000`。其中：租户级隐藏配置项 `_max_tablet_cnt_per_gb` 用于配置租户 Unit 中每 1 GB 内存支持的最大 Tablet 数，取值范围为 [1000, 50000)，默认值为 20000。该配置项修改后立即生效，不需要重启 OBServer 节点。租户级隐藏配置项 `_storage_meta_memory_limit_percentage` 用于配置元数据内存占租户内存的百分比，取值范围为 [0, 50)，默认值为 20，0 表示不设置上限。该配置项修改后立即生效，不需要重启 OBServer 节点。
SESSION	会话，租户在该节点上能够创建的连接数的上限由隐藏配置项 `_resource_limit_max_session_num` 或租户内存（`(MEMORY_SIZE * 5%) / 100KB`）来决定。其中，租户级隐藏配置项 `_resource_limit_max_session_num` 用于控制用户租户内普通用户的最大并发连接数，取值范围为 [0,1000000]，默认值为 0，表示不配置，系统内部按照 `(MEMORY_SIZE * 5%) / 100KB` 来计算最大连接数；当 `_resource_limit_max_session_num` 的值大于 0 时，以隐藏配置项设置的值为准。该配置项修改后立即生效，不需要重启 OBServer 节点。
THREAD	线程，该节点上的线程数的上限由隐藏配置项 `_ob_max_thread_num` 决定。集群级隐藏配置项 `_ob_max_thread_num` 用于配置该节点的线程数上限，取值范围为 [0,10000)，默认值为 0，表示不设置上限。该配置项仅 sys 租户可以修改，修改后立即生效，不需要重启 OBServer 节点。
TX_PARTICIPANT	事务参与者，事务修改某个日志流的数据时，该日志流就会作为事务的一个参与者，并产生一个参与者数据结构。活跃事务的参与者称为活跃参与者，一个节点上，活跃参与者数量上限为 70W 。

物理资源

OceanBase 数据库中的物理资源及相关说明如下表所示。

资源名称	描述
DATA_DISK	数据盘，用于存储用户业务数据的磁盘，当前所有租户共用数据盘。
CLOG_DISK	日志盘，用于存储租户 clog 的磁盘。
CPU	CPU，租户能够使用的计算资源。
MEMORY	内存，租户能够使用的总内存。
MEMSTORE	业务数据内存，租户能够使用的业务数据内存。

查看所有资源规格信息

通过 DBA_OB_UNIT_CONFIGS 视图，可以查看所有资源规格信息。示例如下：

以查询结果第二行数据为例，资源规格名称（NAME）是 test_unit，资源规格 ID（UNIT_CONFIG_ID）是 1001，创建时间（CREATE_TIME）是 2025-03-26 10:31:13，CPU 规格上限（MAX_CPU）是 5C，内存规格（MEMORY_SIZE）是 10G，日志盘空间（LOG_DISK_SIZE）是 30G。

obclient [oceanbase]> SELECT * FROM DBA_OB_UNIT_CONFIGS;
+----------------+-----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+---------------------+---------------------+-------------+
| UNIT_CONFIG_ID | NAME            | CREATE_TIME                | MODIFY_TIME                | MAX_CPU | MIN_CPU | MEMORY_SIZE | LOG_DISK_SIZE | MAX_IOPS            | MIN_IOPS            | IOPS_WEIGHT |
+----------------+-----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+---------------------+---------------------+-------------+
|              1 | sys_unit_config | 2025-03-26 10:30:50.392825 | 2025-03-26 10:30:50.392825 |       3 |       3 |  1073741824 |    3221225472 | 9223372036854775807 | 9223372036854775807 |           3 |
|           1001 | test_unit       | 2025-03-26 10:31:13.245779 | 2025-03-26 10:31:13.245779 |       5 |       5 | 10737418240 |   32212254720 | 9223372036854775807 | 9223372036854775807 |           5 |
|           1002 | S1_unit_config  | 2025-03-26 19:29:00.868042 | 2025-03-26 19:29:00.868042 |       1 |       1 |  5368709120 |    6442450944 |               10000 |               10000 |           1 |
+----------------+-----------------+----------------------------+----------------------------+---------+---------+-------------+---------------+---------------------+---------------------+-------------+
3 rows in set

DBA_OB_UNIT_CONFIGS 视图参数详细说明，参见 DBA_OB_UNIT_CONFIGS。

查看所有的资源池信息

通过 DBA_OB_RESOURCE_POOLS 视图，可以查看所有资源池信息。示例如下：

以查询结果第二行数据为例，资源池名称（NAME）是 test_pool，资源池的 ID（RESOURCE_POOL_ID）是 1001、归属于的租户 ID（TENANT_ID）是 1002、使用的资源规格 ID（UNIT_CONFIG_ID）是 1001，资源池的 Unit 个数（UNIT_COUNT）是 1，使用的 Zone 列表（ZONE_LIST）是 zone1。

obclient [oceanbase]> SELECT * FROM DBA_OB_RESOURCE_POOLS;
+------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
| RESOURCE_POOL_ID | NAME       | TENANT_ID | CREATE_TIME                | MODIFY_TIME                | UNIT_COUNT | UNIT_CONFIG_ID | ZONE_LIST | REPLICA_TYPE |
+------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
|                1 | sys_pool   |         1 | 2025-03-26 10:30:50.396889 | 2025-03-26 10:30:50.403749 |          1 |              1 | zone1     | FULL         |
|             1001 | test_pool  |      1002 | 2025-03-26 10:31:13.286355 | 2025-03-26 10:31:13.376357 |          1 |           1001 | zone1     | FULL         |
|             1002 | mq_pool_01 |      1004 | 2025-03-26 19:29:18.983378 | 2025-03-26 19:29:43.485913 |          1 |           1002 | zone1     | FULL         |
+------------------+------------+-----------+----------------------------+----------------------------+------------+----------------+-----------+--------------+
3 rows in set

DBA_OB_RESOURCE_POOLS 视图参数详细说明，参见 DBA_OB_RESOURCE_POOLS。

查看所有租户信息

通过 DBA_OB_TENANTS 视图，可以查看所有的租户信息，示例如下：

以查询结果的第三行数据为例，租户名称（TENANT_NAME）是 test，租户 ID（TENANT_ID）是 1002，租户类型（TENANT_TYPE）是用户租户，租户创建时间是（CREATE_TIME）是 2025-03-26 10:31:13，租户的 PRIMARY_ZONE（PRIMARY_ZONE）是 zone1，租户副本分布（LOCALITY）在 zone1，兼容模式（COMPATIBILITY_MODE）是 MySQL。

obclient [oceanbase]> SELECT * FROM DBA_OB_TENANTS;
+-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+----------+------------+-----------+
| TENANT_ID | TENANT_NAME | TENANT_TYPE | CREATE_TIME                | MODIFY_TIME                | PRIMARY_ZONE | LOCALITY      | PREVIOUS_LOCALITY | COMPATIBILITY_MODE | STATUS | IN_RECYCLEBIN | LOCKED | TENANT_ROLE | SWITCHOVER_STATUS | SWITCHOVER_EPOCH | SYNC_SCN            | REPLAYABLE_SCN      | READABLE_SCN        | RECOVERY_UNTIL_SCN  | LOG_MODE     | ARBITRATION_SERVICE_STATUS | UNIT_NUM | COMPATIBLE | MAX_LS_ID |
+-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+----------+------------+-----------+
|         1 | sys         | SYS         | 2025-03-26 10:30:50.425010 | 2025-03-26 10:30:50.425010 | RANDOM       | FULL{1}@zone1 | NULL              | MYSQL              | NORMAL | NO            | NO     | PRIMARY     | NORMAL            |                0 |                NULL |                NULL |                NULL |                NULL | NOARCHIVELOG | DISABLED                   |        1 | 4.2.5.3    |         1 |
|      1001 | META$1002   | META        | 2025-03-26 10:31:13.369658 | 2025-03-26 10:31:31.840910 | zone1        | FULL{1}@zone1 | NULL              | MYSQL              | NORMAL | NO            | NO     | PRIMARY     | NORMAL            |                0 |                NULL |                NULL |                NULL |                NULL | NOARCHIVELOG | DISABLED                   |        1 | 4.2.5.3    |         1 |
|      1002 | test        | USER        | 2025-03-26 10:31:13.373213 | 2025-03-26 10:31:31.899859 | zone1        | FULL{1}@zone1 | NULL              | MYSQL              | NORMAL | NO            | NO     | PRIMARY     | NORMAL            |                0 | 1742988782236608000 | 1742988782236608000 | 1742988782236608000 | 4611686018427387903 | NOARCHIVELOG | DISABLED                   |        1 | 4.2.5.3    |      1001 |
|      1003 | META$1004   | META        | 2025-03-26 19:29:43.477073 | 2025-03-26 19:30:01.320309 | zone1        | FULL{1}@zone1 | NULL              | MYSQL              | NORMAL | NO            | NO     | PRIMARY     | NORMAL            |                0 |                NULL |                NULL |                NULL |                NULL | NOARCHIVELOG | DISABLED                   |        1 | 4.2.5.3    |         1 |
|      1004 | mq_t1       | USER        | 2025-03-26 19:29:43.482748 | 2025-03-26 19:30:01.369757 | zone1        | FULL{1}@zone1 | NULL              | MYSQL              | NORMAL | NO            | NO     | PRIMARY     | NORMAL            |                0 | 1742988782236608000 | 1742988782236608000 | 1742988782136589000 | 4611686018427387903 | NOARCHIVELOG | DISABLED                   |        1 | 4.2.5.3    |      1001 |
+-----------+-------------+-------------+----------------------------+----------------------------+--------------+---------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+----------+------------+-----------+
5 rows in set

DBA_OB_TENANTS 视图参数详细说明，参见 DBA_OB_TENANTS。

查看租户资源配置

通过如下语句，在多个视图中查找租户资源配置信息。

以查询结果中 mq_t1 租户为例，pool:conf 列可以看到该租户的三个资源池名称和所用的资源规格名称，unit_info 列可以看到资源池的 Unit 个数为 1 和相应的 CPU 配置为 1、内存配置都是 5G。

obclient [oceanbase]> SELECT c.TENANT_ID, e.TENANT_NAME, concat(c.NAME, ': ', d.NAME) `pool:conf`,concat(c.UNIT_COUNT, ' unit: ', d.min_cpu, 'C/', ROUND(d.MEMORY_SIZE/1024/1024/1024,0), "G") unit_info
                FROM DBA_OB_RESOURCE_POOLS c, DBA_OB_UNIT_CONFIGS d, DBA_OB_TENANTS e
                WHERE c.UNIT_CONFIG_ID=d.UNIT_CONFIG_ID AND c.TENANT_ID=e.TENANT_ID AND c.TENANT_ID>1000
                ORDER BY c.TENANT_ID;
+-----------+-------------+----------------------------+----------------+
| TENANT_ID | TENANT_NAME | pool:conf                  | unit_info      |
+-----------+-------------+----------------------------+----------------+
|      1002 | test        | test_pool: test_unit       | 1 unit: 5C/10G |
|      1004 | mq_t1       | mq_pool_01: S1_unit_config | 1 unit: 1C/5G  |
+-----------+-------------+----------------------------+----------------+
2 rows in set

查看租户的资源单元部署位置

通过以下语句，查看当前已创建租户资源单元所在设备 IP 信息。

在查询结果中可以看到每个租户对应的 ID 和资源所在节点的 IP。

obclient [oceanbase]> SELECT a.TENANT_NAME,a.TENANT_ID,b.SVR_IP FROM DBA_OB_TENANTS a,GV$OB_UNITS b WHERE a.TENANT_ID=b.TENANT_ID;
+-------------+-----------+-----------------+
| TENANT_NAME | TENANT_ID | SVR_IP          |
+-------------+-----------+-----------------+
| sys         |         1 | xxx.xxx.xxx.193 |
| META$1002   |      1001 | xxx.xxx.xxx.193 |
| test        |      1002 | xxx.xxx.xxx.193 |
| META$1004   |      1003 | xxx.xxx.xxx.193 |
| mq_t1       |      1004 | xxx.xxx.xxx.193 |
+-------------+-----------+-----------------+
5 rows in set

查看节点的 Unit 信息

通过 GV$OB_UNITS 视图，可以查看所有节点的 Unit 信息，示例如下：

以查询结果第三行为例，节点 IP（SVR_IP）是 xxx.xx.xxx.193，服务器端口号（SVR_PORT）是 2882，unit ID（UNIT_ID）是 1001，租户 ID（TENANT_ID）是 1002，对应的 Zone 名称（ZONE）是 zone1，CPU 规格上限（MAX_CPU）是 5C，内存大小（MEMORY_SIZE）是 10G，日志盘大小（LOG_DISK_SIZE）是 30G，日志盘已使用（LOG_DISK_IN_USE）0.237G，数据盘使用（DATA_DISK_IN_USE）0，unit 状态（STATUS）正常。
结合 SVR_IP 都为 xxx.xx.xxx.193 的五行一起看，表示该节点有 5 个 unit，分别属于 TENANT_ID 为 1、1001、1002、1003、1004 的租户。

obclient [oceanbase]> SELECT * FROM GV$OB_UNITS;
+----------------+----------+---------+-----------+-------+-----------+---------------+---------+---------+-------------+---------------------+---------------------+-------------+---------------+-----------------+------------------+--------+----------------------------+
| SVR_IP         | SVR_PORT | UNIT_ID | TENANT_ID | ZONE  | ZONE_TYPE | REGION        | MAX_CPU | MIN_CPU | MEMORY_SIZE | MAX_IOPS            | MIN_IOPS            | IOPS_WEIGHT | LOG_DISK_SIZE | LOG_DISK_IN_USE | DATA_DISK_IN_USE | STATUS | CREATE_TIME                |
+----------------+----------+---------+-----------+-------+-----------+---------------+---------+---------+-------------+---------------------+---------------------+-------------+---------------+-----------------+------------------+--------+----------------------------+
| xxx.xx.xxx.193 |     2882 |       1 |         1 | zone1 | ReadWrite | deault_region |       3 |       3 |  1073741824 | 9223372036854775807 | 9223372036854775807 |           3 |    3221225472 |       252331131 |                0 | NORMAL | 2025-03-26 10:29:57.108227 |
| xxx.xx.xxx.193 |     2882 |    1001 |      1001 | zone1 | ReadWrite | deault_region |    NULL |    NULL |  1073741824 |                NULL |                NULL |        NULL |    3221225472 |       385046104 |         91910144 | NORMAL | 2025-03-26 10:31:13.377817 |
| xxx.xx.xxx.193 |     2882 |    1001 |      1002 | zone1 | ReadWrite | deault_region |       5 |       5 |  9663676416 | 9223372036854775807 | 9223372036854775807 |           5 |   28991029248 |       254438925 |                0 | NORMAL | 2025-03-26 10:31:13.377817 |
| xxx.xx.xxx.193 |     2882 |    1002 |      1003 | zone1 | ReadWrite | deault_region |    NULL |    NULL |  1073741824 |                NULL |                NULL |        NULL |     644245094 |        87957951 |                0 | NORMAL | 2025-03-26 19:29:43.486573 |
| xxx.xx.xxx.193 |     2882 |    1002 |      1004 | zone1 | ReadWrite | deault_region |       1 |       1 |  4294967296 |               10000 |               10000 |           1 |    5798205850 |       146773862 |                0 | NORMAL | 2025-03-26 19:29:43.486573 |
+----------------+----------+---------+-----------+-------+-----------+---------------+---------+---------+-------------+---------------------+---------------------+-------------+---------------+-----------------+------------------+--------+----------------------------+
5 rows in set

GV$OB_UNITS 视图参数详细说明，参见 GV$OB_UNITS。

查看节点的资源分配信息

通过 GV$OB_SERVERS 视图，可以查看 OBServer 的信息，示例如下：

以查询结果的第一行数据为例，节点 IP（SVR_IP）是 xxx.xx.xxx.193，服务器端口号（SVR_PORT）是 2882，对应的 zone 名称（zone）是 zone1，SQL 端口（SQL_PORT）是 2881，observer 进程可用的 CPU 数量（CPU_CAPACITY）是 16C，observer 进程可用的内存（MEM_CAPACITY）是 24G，已分配的内存（MEM_ASSIGNED）是 16G，日志盘总空间（LOG_DISK_CAPACITY）为 78G，已分配日志盘空间（LOG_DISK_ASSIGNED）是 39G，日志盘已使用（LOG_DISK_IN_USE） 1.3125G，数据盘空间（DATA_DISK_CAPACITY） 70G，数据盘已使用（DATA_DISK_IN_USE） 0.15625G。

obclient [oceanbase]> SELECT * FROM GV$OB_SERVERS;
+----------------+----------+-------+----------+--------------+------------------+--------------+------------------+--------------+--------------+-------------------+-------------------+-----------------+--------------------+------------------+-------------------------+--------------+---------------------+-------------------------+-----------------------+
| SVR_IP         | SVR_PORT | ZONE  | SQL_PORT | CPU_CAPACITY | CPU_CAPACITY_MAX | CPU_ASSIGNED | CPU_ASSIGNED_MAX | MEM_CAPACITY | MEM_ASSIGNED | LOG_DISK_CAPACITY | LOG_DISK_ASSIGNED | LOG_DISK_IN_USE | DATA_DISK_CAPACITY | DATA_DISK_IN_USE | DATA_DISK_HEALTH_STATUS | MEMORY_LIMIT | DATA_DISK_ALLOCATED | DATA_DISK_ABNORMAL_TIME | SSL_CERT_EXPIRED_TIME |
+----------------+----------+-------+----------+--------------+------------------+--------------+------------------+--------------+--------------+-------------------+-------------------+-----------------+--------------------+------------------+-------------------------+--------------+---------------------+-------------------------+-----------------------+
| xxx.xx.xxx.193 |     2882 | zone1 |     2881 |           16 |               16 |            9 |                9 |  25769803776 |  17179869184 |       83751862272 |       41875931136 |      1409286144 |        75161927680 |        167772160 | NORMAL                  |  32212254720 |          2147483648 | NULL                    | NULL                  |
+----------------+----------+-------+----------+--------------+------------------+--------------+------------------+--------------+--------------+-------------------+-------------------+-----------------+--------------------+------------------+-------------------------+--------------+---------------------+-------------------------+-----------------------+
1 row in set

GV$OB_SERVERS 视图参数详细说明，参见 GV$OB_SERVERS。

查看租户的逻辑资源使用情况及限制

sys 租户通过 GV$OB_TENANT_RESOURCE_LIMIT 视图，可以查看租户在每个 Unit 上逻辑资源的使用情况，示例如下：

obclient [oceanbase]> SELECT * FROM oceanbase.GV$OB_TENANT_RESOURCE_LIMIT WHERE TENANT_ID=1004;

查询结果如下：

+----------------+----------+-----------+-------+---------------+---------------------+-----------------+----------------+-------------+----------------------+
| SVR_IP         | SVR_PORT | TENANT_ID | ZONE  | RESOURCE_NAME | CURRENT_UTILIZATION | MAX_UTILIZATION | RESERVED_VALUE | LIMIT_VALUE | EFFECTIVE_LIMIT_TYPE |
+----------------+----------+-----------+-------+---------------+---------------------+-----------------+----------------+-------------+----------------------+
| xxx.xx.xxx.193 |     2882 |      1004 | zone1 | ls            |                   2 |               2 |              0 |           8 | memory               |
| xxx.xx.xxx.193 |     2882 |      1004 | zone1 | tablet        |                 678 |             678 |              0 |       80000 | configuration        |
+----------------+----------+-----------+-------+---------------+---------------------+-----------------+----------------+-------------+----------------------+
2 rows in set

从第一行结果可知，租户 1004 在 172.xx.xxx.xxx:2882 节点上，当前有 2 个日志流（CURRENT_UTILIZATION），曾经同时存在过最多 2 个日志流（MAX_UTILIZATION），最大可以创建 8 个日志流（LIMIT_VALUE），并且这 8 个日志流的上限值由租户内存（memory）计算得来。

从第二行结果可知，租户 1004 在 172.xx.xxx.xxx:2882 节点上，当前有 678 个 TABLET（CURRENT_UTILIZATION），曾经同时存在过最多 678 个 TABLET（MAX_UTILIZATION），最大可以创建 80000 个 TABLET（LIMIT_VALUE），并且这 80000 个 TABLET 的上限值是根据租户内存（configuration）计算得来。

由于租户在该节点上能创建的逻辑资源会受到各种物理资源或配置项值的限制，可以通过视图 GV$OB_TENANT_RESOURCE_LIMIT_DETAIL 进一步查看租户逻辑资源具体所受的限制及各种限制的上限值。

obclient [oceanbase]> SELECT * FROM oceanbase.GV$OB_TENANT_RESOURCE_LIMIT_DETAIL WHERE TENANT_ID=1004;