SHOW STATISTICS

テーブルとそのカラムに関する統計情報を表示します。統計情報は、データ分布、行数、一意な値に関する情報を提供することで、クエリオプティマイザがクエリ実行計画についてより適切な判断を行うのに役立ちます。

TiDB Cloud Lake は、データ挿入時に自動的に統計情報を生成します。このコマンドを使用すると、統計情報を確認し、実際のデータと比較して、クエリ性能に影響する可能性のある不一致を特定できます。

構文

SHOW STATISTICS [ FROM DATABASE <database_name> | FROM TABLE <database_name>.<table_name> ]

パラメータを指定しない場合、このコマンドは現在のデータベース内のすべてのテーブルの統計情報を返します。

出力カラム

このコマンドは、各テーブルの各カラムについて、以下のカラムを返します。

例

現在のデータベースの統計情報を表示する

CREATE DATABASE test_db;
USE test_db;

CREATE TABLE t1 (id INT, name VARCHAR(50));
INSERT INTO t1 VALUES (1, 'Alice'), (2, 'Bob');

SHOW STATISTICS;

出力:

database  table  column_name  stats_row_count  actual_row_count  distinct_count  null_count  avg_size
test_db   t1     id           2                2                 2               0           4
test_db   t1     name         2                2                 2               0           16

特定のテーブルの統計情報を表示する

CREATE TABLE t2 (age INT, city VARCHAR(50));
INSERT INTO t2 VALUES (25, 'New York'), (30, 'London');

SHOW STATISTICS FROM TABLE test_db.t2;

出力:

database  table  column_name  stats_row_count  actual_row_count  distinct_count  null_count  avg_size
test_db   t2     age          2                2                 2               0           4
test_db   t2     city         2                2                 2               0           19

データベース内のすべてのテーブルの統計情報を表示する

SHOW STATISTICS FROM DATABASE test_db;

これにより、test_db データベース内のすべてのテーブル（t1 と t2）の統計情報が表示されます。

関連コマンド

• SHOW TABLE STATUS: テーブルのステータス情報を表示します