Note
This view is available starting with V4.0.0.
Purpose
This view displays the optimizer statistics for all tables in the current tenant.
Columns
| Column | Type | Nullable | Description |
|---|---|---|---|
| OWNER | varchar(128) | NO | The user to whom the entity belongs. |
| TABLE_NAME | varchar(128) | NO | The name of the table. |
| PARTITION_NAME | varchar(128) | NO | The name of the partition. |
| PARTITION_POSITION | decimal(10,0) | NO | The position of the partition in the table. |
| SUBPARTITION_NAME | varchar(128) | NO | The name of the subpartition. |
| SUBPARTITION_POSITION | decimal(10,0) | NO | The position of the subpartition in the partition. |
| OBJECT_TYPE | varchar(12) | NO | The type of the entity. |
| NUM_ROWS | decimal(10,0) | NO | The number of rows in the entity. |
| BLOCKS | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| EMPTY_BLOCKS | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| AVG_SPACE | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| CHAIN_CNT | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| AVG_ROW_LEN | decimal(10,0) | NO | The average row length of the entity. |
| AVG_SPACE_FREELIST_BLOCKS | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| NUM_FREELIST_BLOCKS | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| AVG_CACHED_BLOCKS | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| AVG_CACHE_HIT_RATIO | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| IM_IMCU_COUNT | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| IM_BLOCK_COUNT | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| IM_STAT_UPDATE_TIME | datetime | NO | This column is not supported. The value of this column is NULL by default. |
| SCAN_RATE | decimal(10,0) | NO | This column is not supported. The value of this column is NULL by default. |
| SAMPLE_SIZE | decimal(10,0) | YES | The sampling size when statistics were collected. |
| LAST_ANALYZED | datetime(6) | NO | The time when the last analysis was performed. |
| GLOBAL_STATS | varchar(3) | NO |
|
| USER_STATS | varchar(3) | NO | Indicates whether the partition statistics were set by the user. |
| STATTYPE_LOCKED | varchar(5) | NO | The type of statistics lock. |
| STALE_STATS | varchar(3) | NO | Indicates whether the statistics are stale. |
| SCOPE | varchar(7) | NO | The scope of the statistics. |
Sample query
Query the optimizer statistics of the t_subpart table in the current tenant.
obclient [oceanbase]> SELECT OWNER, TABLE_NAME, OBJECT_TYPE, NUM_ROWS, AVG_ROW_LEN FROM oceanbase.DBA_TAB_STATISTICS WHERE TABLE_NAME='t_subpart';
The query result is as follows:
+-------+------------+--------------+----------+-------------+
| OWNER | TABLE_NAME | OBJECT_TYPE | NUM_ROWS | AVG_ROW_LEN |
+-------+------------+--------------+----------+-------------+
| test | t_subpart | TABLE | 10000 | 60 |
| test | t_subpart | PARTITION | 3334 | 60 |
| test | t_subpart | PARTITION | 3333 | 60 |
| test | t_subpart | PARTITION | 3333 | 60 |
| test | t_subpart | SUBPARTITION | 1336 | 60 |
| test | t_subpart | SUBPARTITION | 999 | 60 |
| test | t_subpart | SUBPARTITION | 999 | 60 |
| test | t_subpart | SUBPARTITION | 1002 | 60 |
| test | t_subpart | SUBPARTITION | 1332 | 60 |
| test | t_subpart | SUBPARTITION | 999 | 60 |
| test | t_subpart | SUBPARTITION | 1002 | 60 |
| test | t_subpart | SUBPARTITION | 999 | 60 |
| test | t_subpart | SUBPARTITION | 1332 | 60 |
+-------+------------+--------------+----------+-------------+
13 rows in set
References
Query the column statistics at the Global level: DBA_TAB_COL_STATISTICS.
Query the column statistics at the Partition level: DBA_PART_COL_STATISTICS.
Query the column statistics at the Subpartition level: DBA_SUBPART_COL_STATISTICS.
Query the histogram statistics at the table level: DBA_TAB_HISTOGRAMS.
Query the histogram statistics at the Partition level: DBA_PART_HISTOGRAMS.
Query the histogram statistics at the Subpartition level: DBA_SUBPART_HISTOGRAMS.
Query the index statistics: DBA_IND_STATISTICS.
For more information about how to collect statistics, see the following topics: