DROP STATS

DROP STATSステートメントは、選択したデータベースから選択したテーブルの統計を削除するために使用されます。

概要

DropStatsStmt ::=
    'DROP' 'STATS' TableName  ("PARTITION" partition | "GLOBAL")? ( ',' TableName )*

TableName ::=
    Identifier ('.' Identifier)?

使用法

次の文は、 TableNameのすべての統計情報を削除します。パーティションテーブルが指定されている場合、この文は動的プルーニングモードで生成されたグローバル統計でなく、このテーブル内のすべてのパーティションの統計情報も削除します。

DROP STATS TableName

Query OK, 0 rows affected (0.00 sec)

次のステートメントは、 PartitionNameList内の指定されたパーティションの統計のみを削除します。

DROP STATS TableName PARTITION PartitionNameList;

Query OK, 0 rows affected (0.00 sec)

次のステートメントは、指定されたテーブルの動的プルーニングモードで生成されたグローバル統計のみを削除します。

DROP STATS TableName GLOBAL;

Query OK, 0 rows affected (0.00 sec)

例

CREATE TABLE t(a INT);

Query OK, 0 rows affected (0.01 sec)

SHOW STATS_META WHERE db_name='test' and table_name='t';

+---------+------------+----------------+---------------------+--------------+-----------+-------------------+
| Db_name | Table_name | Partition_name | Update_time         | Modify_count | Row_count | Last_analyze_time |
+---------+------------+----------------+---------------------+--------------+-----------+-------------------+
| test    | t          |                | 2020-05-25 20:34:33 |            0 |         0 | NULL              |
+---------+------------+----------------+---------------------+--------------+-----------+-------------------+
1 row in set (0.00 sec)

DROP STATS t;

Query OK, 0 rows affected (0.00 sec)

DROP STATS は、テーブルの TopN やヒストグラムバケットなどの統計情報を削除しますが、STATS_META からテーブルのレコードは削除しません。そのため、DROP STATS を実行した後でも、SHOW STATS_META は引き続きテーブルの Modify_count と Row_count の情報を返します。

SHOW STATS_META WHERE db_name='test' and table_name='t';

+---------+------------+----------------+---------------------+--------------+-----------+-------------------+
| Db_name | Table_name | Partition_name | Update_time         | Modify_count | Row_count | Last_analyze_time |
+---------+------------+----------------+---------------------+--------------+-----------+-------------------+
| test    | t          |                | 2020-05-25 20:34:33 |            0 |         0 | NULL              |
+---------+------------+----------------+---------------------+--------------+-----------+-------------------+
1 row in set (0.00 sec)

MySQLとの互換性

このステートメントは、MySQL 構文に対する TiDB 拡張です。

参照

• 統計入門