---
title: "oceanbase.CDB_OB_TABLEGROUPS - OceanBase 数据库 V4.2.2 | OceanBase 文档中心"
description: oceanbase.CDB_OB_TABLEGROUPS 说明 从 V4.0.0 版本开始引入。 功能描述 系统租户下展示所有租户的表组的元信息，主要是展示表组的分区信息。 说明 从 V4.2.0 版本开始，该视图中的分区属性字段将不再有含义，统一展示为 NONE 或 NULL。 字段说明 字段名称 类型 是否可以为…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.2

# oceanbase.CDB_OB_TABLEGROUPS

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

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.2/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/10000.oceanbase-cdb_ob_tablegroups-of-sys-tenant.md)

#### 说明

从 V4.0.0 版本开始引入。

## 功能描述

系统租户下展示所有租户的表组的元信息，主要是展示表组的分区信息。

#### 说明

从 V4.2.0 版本开始，该视图中的分区属性字段将不再有含义，统一展示为 `NONE` 或 NULL。

## 字段说明

| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
| --- | --- | --- | --- |
| TENANT_ID | bigint(20) | NO | 租户 ID |
| TABLEGROUP_NAME | varchar(128) | NO | 表组名 |
| PARTITIONING_TYPE | varchar(13) | NO | 分区的表组一级分区的分区类型： - `NONE`：非分区表组 - `HASH`：HASH 分区（单分区键） - `KEY`：KEY 分区 - `RANGE`：RANGE 分区（单分区键） - `RANGE COLUMNS`：RANGE COLUMNS 分区 - `LIST`：LIST 分区（单分区键） - `LIST COLUMNS`：LIST COLUMNS 分区 - `UNKNOWN`：异常类型     #### 说明      该字段从 V4.2.0 版本开始 值为 `NULL` |
| SUBPARTITIONING_TYPE | varchar(13) | NO | 分区的表组二级分区的分区类型： - `NONE`：非分区表组、一级分区表组 - `HASH`：HASH 分区（单分区键） - `KEY`：KEY 分区 - `RANGE`：RANGE 分区（单分区键） - `RANGE COLUMNS`：RANGE COLUMNS 分区 - `LIST`：LIST 分区（单分区键） - `LIST COLUMNS`：LIST COLUMNS 分区 - `UNKNOWN`：异常类型     #### 说明      该字段从 V4.2.0 版本开始 值为 `NULL` |
| PARTITION_COUNT | bigint(20) | NO | 分区的表组的一级分区数目，对于非分区表组，该值为 `NULL` |
| DEF_SUBPARTITION_COUNT | bigint(0) | NO | 分区的表组的二级分区模版的分区数目，对于未定义二级分区模版的表组，该值为 `NULL` |
| PARTITIONING_KEY_COUNT | bigint(20) | NO | 分区的表组一级分区的分区键数目，对于非分区表组，该值为 `NULL` |
| SUBPARTITIONING_KEY_COUNT | bigint(20) | NO | 分区的表组二级分区的分区键数目，对于非二级分区表组，该值为 `NULL` |
| SHARDING | varchar(10) | NO | 表组的 SHARDING 属性。取值如下：   - `NONE`：对于该属性的表组，表组内的所有表的所有分区均聚集在同一台机器上，并且对加入表组的表没有任何限制。 - `PARTITION`：对于该属性的表组，表组内每一张表的数据按一级分区打散；如果是二级分区表，则一级分区下的所有二级分区聚集在一起。 - `ADAPTIVE`：对于该属性的表组，表组内每一张表的数据根据自适应方式打散。即，如果表组内的表是一级分区表，则按一级分区打散；如果表组内的表是二级分区表，则按每个一级分区下的二级分区打散。    #### 说明    该字段从 V4.2.0 版本开始引入。 |

## 查询示例

1. 创建表组 `tblgroup1`。

   ```shell
   obclient [test]> CREATE TABLEGROUP tblgroup1 SHARDING = 'PARTITION';

   ```
 2. 查看表组 `tblgroup1` 的 SHARDING 属性。

   ```shell
   obclient [test]> SELECT TABLEGROUP_NAME, SHARDING FROM oceanbase.CDB_OB_TABLEGROUPS WHERE tablegroup_name = 'tblgroup1';

   ```

   查询结果如下：

   ```shell
   +-----------------+-----------+
   | TABLEGROUP_NAME | SHARDING  |
   +-----------------+-----------+
   | tblgroup1       | PARTITION |
   +-----------------+-----------+
   1 row in set

   ```

## 相关视图或文档

[关于表组](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000509789)

 上一篇 下一篇 ![有帮助](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) 咨询热线
