The DELETE_TABLE_STATS procedure deletes table-level statistics.
Applicability
This topic applies only to OceanBase Database Enterprise Edition. OceanBase Database Community Edition provides only the MySQL mode.
Syntax
DBMS_STATS.DELETE_TABLE_STATS (
ownname VARCHAR2,
tabname VARCHAR2,
partname VARCHAR2 DEFAULT NULL,
cascade_parts BOOLEAN DEFAULT TRUE,
cascade_columns BOOLEAN DEFAULT TRUE);
Parameters
| Parameter | Description |
|---|---|
| ownname | The username. If the username is set to NULL, the current logon username is used by default. |
| tabname | The name of the table to which the column belongs. |
| partname | The name of the partition (subpartition) from which statistics are retrieved. If the table is partitioned and partname is NULL, statistics are retrieved at the global table level. |
| cascade_parts | Specifies whether to delete statistics at the partition level and the sub-partition level. Default value: TRUE. |
| cascade_columns | Specifies whether to delete statistics at the column level. Default value: TRUE. |
Exceptions
| Error code | Description |
|---|---|
| ORA-20000 | The object does not exist, or you do not have the required privileges. |
| ORA-20002 | The user statistics table is damaged and needs to be upgraded. |
| ORA-20005 | Statistics on the object are locked. |
Considerations
To call this procedure, you must be the owner of the table. For objects in the sys tenant, you must be the owner of the table or have the SYSDBA privilege to call this procedure.
Examples
Delete all statistics on the tbl1 table of the testUser01 user.
obclient> CALL DBMS_STATS.DELETE_TABLE_STATS('testUser01', 'tbl1');
Query OK, 0 rows affected