--- title: "oceanbase.CDB_TAB_COLS - OceanBase 数据库 V4.2.5 | OceanBase 文档中心" description: oceanbase.CDB_TAB_COLS 说明 该视图从 V4.0.0 版本开始引入。 功能描述 展示所有租户的表、视图对象的列信息。该视图与 CDB_TAB_COLS_V$ 一致，但没有 NOTES 列， NOTES 列当前未使用。 字段说明 字段名称 类型 是否可以为 NULL 描述 CON_ID bigin… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.5 LTS # oceanbase.CDB_TAB_COLS 更新时间：2026-07-13 22:33:38 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/12700.o-cdb_tab_cols-of-sys-tenant.md) #### 说明 该视图从 V4.0.0 版本开始引入。 ## 功能描述 展示所有租户的表、视图对象的列信息。该视图与 `CDB_TAB_COLS_V$` 一致，但没有 `NOTES` 列，`NOTES` 列当前未使用。 ## 字段说明 | 字段名称 | 类型 | 是否可以为 NULL | 描述 | | --- | --- | --- | --- | | CON_ID | bigint(20) | NO | 租户 ID | | OWNER | varchar(128) | NO | 表、视图或集群的所有者 | | TABLE_NAME | varchar(128) | NO | 表、视图或集群的名称 | | COLUMN_NAME | varchar(128) | NO | 列名 | | DATA_TYPE | varchar(128) | NO | 列的数据类型 | | DATA_TYPE_MOD | varchar(3) | NO | 该字段默认为 NULL | | DATA_TYPE_OWNER | varchar(128) | NO | 该字段默认为 NULL | | DATA_LENGTH | bigint(21) | NO | 列的长度，单位为字节 | | DATA_PRECISION | bigint(20) | NO | `NUMBER` 数据类型的小数精度；`FLOAT` 数据类型的二进制精度；所有其他数据类型为 NULL | | DATA_SCALE | bigint(20) | NO | 数字中小数点右边的数字 | | NULLABLE | varchar(1) | NO | 指示列是否允许 NULL。该值是列 `N` 是否存在 `NOT NULL` 约束或列是否属于 `PRIMARY KEY` | | COLUMN_ID | bigint(20) | NO | 创建的列的序列号 | | DEFAULT_LENGTH | bigint(20) | NO | 列的默认值的长度 | | DATA_DEFAULT | mediumtext | NO | 列的默认值 | | NUM_DISTINCT | bigint(20) | NO | 列中不同值的数量 | | LOW_VALUE | varchar(128) | NO | 列的最小值 | | HIGH_VALUE | varchar(128) | NO | 列的最大值 | | DENSITY | bigint(21) | NO | 列的密度 | | NUM_NULLS | bigint(20) | NO | 列中 `NULL` 值的个数 | | NUM_BUCKETS | bigint(20) | NO | 列直方图中桶的个数 | | LAST_ANALYZED | date | NO | 上次分析此列的时间 | | SAMPLE_SIZE | bigint(20) | NO | 分析此列时的采样大小 | | CHARACTER_SET_NAME | varchar(44) | NO | 字符集名称： - `CHAR_CS` - `NCHAR_CS` | | CHAR_COL_DECL_LENGTH | bigint(0) | NO | 该字段默认为 NULL | | GLOBAL_STATS | varchar(3) | NO | 如果统计信息被收集或增量维护，则是 `YES`，否则是`NO` | | USER_STATS | varchar(3) | NO | 指示统计信息是否由用户直接输入 ( `YES`) 或不是 ( `NO`) | | AVG_COL_LEN | bigint(21) | NO | 列的平均长度，单位为字节 | | CHAR_LENGTH | bigint(20) | NO | 以字符显示列的长度。此值仅适用于以下数据类型： - `CHAR` - `VARCHAR2` - `NCHAR` - `NVARCHAR2` | | CHAR_USED | varchar(1) | NO | 表示该列使用`BYTE`长度语义（`B`）或`CHAR`长度语义（`C`），或者数据类型是否不是以下任何一种（NULL）： - `CHAR` - `VARCHAR2` - `NCHAR` - `NVARCHAR2` | | V80_FMT_IMAGE | varchar(3) | NO | 该字段默认为 NULL | | DATA_UPGRADED | varchar(3) | NO | 该字段默认为 NULL | | HIDDEN_COLUMN | varchar(3) | NO | 指示该列是否为隐藏列 ( `YES`) 或不是 ( `NO`) | | VIRTUAL_COLUMN | varchar(3) | NO | 指示列是否为虚拟列 ( `YES`) 或不是 ( `NO`) | | SEGMENT_COLUMN_ID | bigint(0) | NO | 该字段默认为 NULL | | INTERNAL_COLUMN_ID | bigint(0) | NO | 该字段默认为 NULL | | HISTOGRAM | varchar(15) | NO | 指示直方图的类型： - `NONE` - `FREQUENCY` - `TOP-FREQUENCY` - `HEIGHT BALANCED` - `HYBRID` | | QUALIFIED_COL_NAME | text | NO | 限定列名 | | USER_GENERATED | varchar(3) | NO | 指示该列是用户生成的列 ( `YES`) 还是系统生成的列 ( `NO`) | | DEFAULT_ON_NULL | varchar(3) | NO | 该字段默认为 NULL | | IDENTITY_COLUMN | varchar(3) | NO | 该字段默认为 NULL | | EVALUATION_EDITION | varchar(128) | NO | 该字段默认为 NULL | | UNUSABLE_BEFORE | varchar(128) | NO | 该字段默认为 NULL | | UNUSABLE_BEGINNING | varchar(128) | NO | 该字段默认为 NULL | | COLLATION | varchar(100) | NO | 该字段默认为 NULL | | COLLATED_COLUMN_ID | bigint(0) | NO | 该字段默认为 NULL | ## 查询示例 系统租户查询租户 ID 为 1002 的租户下的表 `t1` 的列信息。 ```shell obclient [oceanbase]> SELECT * FROM oceanbase.CDB_TAB_COLS WHERE CON_ID=1002 AND TABLE_NAME='t1'\G ``` 查询结果如下： ```shell *************************** 1. row *************************** CON_ID: 1002 OWNER: infotest TABLE_NAME: t1 COLUMN_NAME: id DATA_TYPE: NUMBER DATA_TYPE_MOD: NULL DATA_TYPE_OWNER: NULL DATA_LENGTH: 0 DATA_PRECISION: 20 DATA_SCALE: 0 NULLABLE: N COLUMN_ID: 16 DEFAULT_LENGTH: NULL DATA_DEFAULT: NULL NUM_DISTINCT: 3 LOW_VALUE: 1 HIGH_VALUE: 3 DENSITY: 0 NUM_NULLS: 0 NUM_BUCKETS: 0 LAST_ANALYZED: 2025-02-20 SAMPLE_SIZE: 3 CHARACTER_SET_NAME: CHAR_COL_DECL_LENGTH: NULL GLOBAL_STATS: NO USER_STATS: NO AVG_COL_LEN: 20 CHAR_LENGTH: 0 CHAR_USED: NULL V80_FMT_IMAGE: NULL DATA_UPGRADED: NULL HIDDEN_COLUMN: NO VIRTUAL_COLUMN: NO SEGMENT_COLUMN_ID: NULL INTERNAL_COLUMN_ID: NULL HISTOGRAM: NULL QUALIFIED_COL_NAME: id USER_GENERATED: YES DEFAULT_ON_NULL: NULL IDENTITY_COLUMN: NULL EVALUATION_EDITION: NULL UNUSABLE_BEFORE: NULL UNUSABLE_BEGINNING: NULL COLLATION: NULL COLLATED_COLUMN_ID: NULL *************************** 2. row *************************** CON_ID: 1002 OWNER: infotest TABLE_NAME: t1 COLUMN_NAME: name DATA_TYPE: VARCHAR2 DATA_TYPE_MOD: NULL DATA_TYPE_OWNER: NULL DATA_LENGTH: 50 DATA_PRECISION: NULL DATA_SCALE: NULL NULLABLE: Y COLUMN_ID: 17 DEFAULT_LENGTH: NULL DATA_DEFAULT: NULL NUM_DISTINCT: 3 LOW_VALUE: 'A' HIGH_VALUE: 'C' DENSITY: 0 NUM_NULLS: 0 NUM_BUCKETS: 0 LAST_ANALYZED: 2025-02-20 SAMPLE_SIZE: 3 CHARACTER_SET_NAME: CHAR_CS CHAR_COL_DECL_LENGTH: NULL GLOBAL_STATS: NO USER_STATS: NO AVG_COL_LEN: 13 CHAR_LENGTH: 50 CHAR_USED: B V80_FMT_IMAGE: NULL DATA_UPGRADED: NULL HIDDEN_COLUMN: NO VIRTUAL_COLUMN: NO SEGMENT_COLUMN_ID: NULL INTERNAL_COLUMN_ID: NULL HISTOGRAM: NULL QUALIFIED_COL_NAME: name USER_GENERATED: YES DEFAULT_ON_NULL: NULL IDENTITY_COLUMN: NULL EVALUATION_EDITION: NULL UNUSABLE_BEFORE: NULL UNUSABLE_BEGINNING: NULL COLLATION: NULL COLLATED_COLUMN_ID: NULL *************************** 3. row *************************** CON_ID: 1002 OWNER: infotest TABLE_NAME: t1 COLUMN_NAME: gmt_create DATA_TYPE: TIMESTAMP DATA_TYPE_MOD: NULL DATA_TYPE_OWNER: NULL DATA_LENGTH: 0 DATA_PRECISION: NULL DATA_SCALE: 0 NULLABLE: N COLUMN_ID: 18 DEFAULT_LENGTH: 17 DATA_DEFAULT: CURRENT_TIMESTAMP NUM_DISTINCT: 1 LOW_VALUE: '2025-02-20 14:37:07' HIGH_VALUE: '2025-02-20 14:37:07' DENSITY: 0 NUM_NULLS: 0 NUM_BUCKETS: 0 LAST_ANALYZED: 2025-02-20 SAMPLE_SIZE: 3 CHARACTER_SET_NAME: CHAR_COL_DECL_LENGTH: NULL GLOBAL_STATS: NO USER_STATS: NO AVG_COL_LEN: 20 CHAR_LENGTH: 0 CHAR_USED: NULL V80_FMT_IMAGE: NULL DATA_UPGRADED: NULL HIDDEN_COLUMN: NO VIRTUAL_COLUMN: NO SEGMENT_COLUMN_ID: NULL INTERNAL_COLUMN_ID: NULL HISTOGRAM: NULL QUALIFIED_COL_NAME: gmt_create USER_GENERATED: YES DEFAULT_ON_NULL: NULL IDENTITY_COLUMN: NULL EVALUATION_EDITION: NULL UNUSABLE_BEFORE: NULL UNUSABLE_BEGINNING: NULL COLLATION: NULL COLLATED_COLUMN_ID: NULL 3 rows in set ``` 上一篇 下一篇 ![有帮助](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) 咨询热线