---
title: "USER_TAB_HISTOGRAMS - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: USER_TAB_HISTOGRAMS 说明 该视图从 V3.2.1 版本开始引入。 功能描述 展示当前用户拥有的表的表级直方图相关信息。 功能适用性 该视图仅适用于 OceanBase 数据库 Oracle 模式。 字段说明 字段名称 类型 是否可以为 NULL 描述 TABLE_NAME VARCHAR2(128…
---
切换语言

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

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

# USER_TAB_HISTOGRAMS

更新时间：2026-04-01 14:27:05

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/700.system-views/500.system-view-of-oracle-mode/200.dictionary-view-of-oracle-mode/30700.user_tab_histograms-of-oracle-mode.md)

#### 说明

该视图从 V3.2.1 版本开始引入。

## 功能描述

展示当前用户拥有的表的表级直方图相关信息。

#### 功能适用性

该视图仅适用于 OceanBase 数据库 Oracle 模式。

## 字段说明

| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
| --- | --- | --- | --- |
| TABLE_NAME | VARCHAR2(128) | NO | 直方图所属表名 |
| COLUMN_NAME | VARCHAR2(128) | NO | 直方图所属列名 |
| ENDPOINT_NUMBER | NUMBER | NO | Bucket 累积的频次 |
| ENDPOINT_VALUE | NUMBER | NO | Bucket 端点归一化值 |
| ENDPOINT_ACTUAL_VALUE | VARCHAR2(4000) | NO | Bucket 端点值 |
| ENDPOINT_ACTUAL_VALUE_RAW | VARCHAR2(4000) | NO | Bucket 端点二进制值 |
| ENDPOINT_REPEAT_COUNT | NUMBER | NO | Bucket 端点值的频次 |
| SCOPE | VARCHAR2(7) | YES | 直方图所属范围 |

## 查询示例

查看当前用户拥有的所有表中，表 `T_SUBPART` 的表级直方图相关信息。

```shell
obclient [SYS]> SELECT * FROM SYS.USER_TAB_HISTOGRAMS WHERE TABLE_NAME='T_SUBPART';

```

查询结果如下：

```shell
+------------+-------------+-----------------+----------------+-----------------------+---------------------------+-----------------------+-------+
| TABLE_NAME | COLUMN_NAME | ENDPOINT_NUMBER | ENDPOINT_VALUE | ENDPOINT_ACTUAL_VALUE | ENDPOINT_ACTUAL_VALUE_RAW | ENDPOINT_REPEAT_COUNT | SCOPE |
+------------+-------------+-----------------+----------------+-----------------------+---------------------------+-----------------------+-------+
| T_SUBPART  | C1          |               1 |           NULL | 0                     | 0F053F0080000000          |                     1 | NULL  |
| T_SUBPART  | C1          |            2501 |           NULL | 2500                  | 0F053F00C0000001C4090000  |                     1 | NULL  |
| T_SUBPART  | C1          |            5001 |           NULL | 5000                  | 0F053F00C000000188130000  |                     1 | NULL  |
| T_SUBPART  | C1          |            7501 |           NULL | 7500                  | 0F053F00C00000014C1D0000  |                     1 | NULL  |
| T_SUBPART  | C1          |           10000 |           NULL | 9999                  | 0F053F00C00000010F270000  |                     1 | NULL  |
| T_SUBPART  | C2          |              10 |           NULL | 0                     | 0F053F0080000000          |                    10 | NULL  |
| T_SUBPART  | C2          |            2510 |           NULL | 250                   | 0F053F00C0000001FA000000  |                    10 | NULL  |
| T_SUBPART  | C2          |            5010 |           NULL | 500                   | 0F053F00C0000001F4010000  |                    10 | NULL  |
| T_SUBPART  | C2          |            7510 |           NULL | 750                   | 0F053F00C0000001EE020000  |                    10 | NULL  |
| T_SUBPART  | C2          |           10000 |           NULL | 999                   | 0F053F00C0000001E7030000  |                    10 | NULL  |
| T_SUBPART  | C3          |               5 |           NULL | 0                     | 0F053F0080000000          |                     5 | NULL  |
| T_SUBPART  | C3          |            2505 |           NULL | 500                   | 0F053F00C0000001F4010000  |                     5 | NULL  |
| T_SUBPART  | C3          |            5005 |           NULL | 1000                  | 0F053F00C0000001E8030000  |                     5 | NULL  |
| T_SUBPART  | C3          |            7505 |           NULL | 1500                  | 0F053F00C0000001DC050000  |                     5 | NULL  |
| T_SUBPART  | C3          |           10000 |           NULL | 1999                  | 0F053F00C0000001CF070000  |                     5 | NULL  |
+------------+-------------+-----------------+----------------+-----------------------+---------------------------+-----------------------+-------+
15 rows in set

```

## 相关视图或文档

- 查看当前用户可访问的所有表的表级直方图统计信息：[ALL_TAB_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477407)
 - 查看当前租户的所有表的表级直方图统计信息：[DBA_TAB_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477200)
 - Partition 级的直方图统计信息，查询以下视图：

     - [ALL_PART_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477319)
     - [DBA_PART_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477374)
     - [USER_PART_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477130)
 - Subpartition 级的直方图统计信息，查询以下视图：

     - [ALL_SUBPART_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477146)
     - [DBA_SUBPART_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477359)
     - [USER_SUBPART_HISTOGRAMS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477255)
 - 表级的列统计信息，查询以下视图：

     - [ALL_TAB_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477418)
     - [DBA_TAB_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477397)
     - [USER_TAB_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477325)
 - Global 级的列统计信息，查询以下视图：

     - [ALL_TAB_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477281)
     - [DBA_TAB_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477143)
     - [USER_TAB_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477308)
 - Partition 级的列统计信息，查询以下视图：

     - [ALL_PART_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477115)
     - [DBA_PART_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477419)
     - [USER_PART_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477195)
 - Subpartition 级的列统计信息，查询以下视图：

     - [ALL_SUBPART_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477172)
     - [DBA_SUBPART_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477290)
     - [USER_SUBPART_COL_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477423)
 - 索引统计信息，查询以下视图：

     - [ALL_IND_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477357)
     - [DBA_IND_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477229)
     - [USER_IND_STATISTICS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477370)
 - 有关如何收集统计信息，参见以下文档：

     - [手动收集统计信息](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004481059)
     - [自动收集统计信息](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004481061)

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