SHOW COLUMN STATS

Описание

Этот оператор используется для просмотра статистики столбцов таблицы.

Синтаксис

SHOW COLUMN [CACHED] STATS <table_name> [ (<column_name> [, ...]) ];

Обязательные параметры

1. <table_name>

Имя таблицы, для которой необходимо отобразить статистику столбцов.

Необязательные параметры

1. CACHED

Вывести статистику столбцов из кеша FE. Если параметр не указан, по умолчанию отображается информация, сохранённая в таблице статистики.

2. <column_name>

Укажите имена столбцов, статистику которых нужно отобразить. Столбцы должны существовать в таблице; несколько имён разделяются запятыми. Если параметр не указан, по умолчанию отображается информация обо всех столбцах.

Возвращаемое значение

Столбец	Примечание
column_name	имя столбца
index_name	имя индекса
count	количество строк в столбце
ndv	количество уникальных значений столбца
num_null	количество значений NULL в столбце
data_size	общий размер данных столбца
avg_size_byte	средний размер значения столбца
min	минимальное значение
max	максимальное значение
method	метод сбора
type	тип сбора
trigger	способ запуска задания
query_times	количество запросов
updated_time	время обновления
update_rows	количество обновлённых строк при последнем анализе
last_analyze_row_count	количество строк в таблице при последнем анализе
last_analyze_version	версия таблицы при последнем анализе

Требования к правам доступа

Пользователь, выполняющий этот SQL, должен иметь как минимум следующие права:

Привилегия	Объект	Примечания
SELECT_PRIV	Таблица	Для выполнения SHOW требуется привилегия SELECT_PRIV на запрашиваемую таблицу.

Примеры

1. Вывести статистику всех столбцов таблицы test1.

SHOW COLUMN STATS test1;

+-------------+------------+----------+---------+----------+-----------+---------------+--------+--------+--------+--------------+---------+-------------+---------------------+-------------+------------------------+----------------------+
| column_name | index_name | count    | ndv     | num_null | data_size | avg_size_byte | min    | max    | method | type         | trigger | query_times | updated_time        | update_rows | last_analyze_row_count | last_analyze_version |
+-------------+------------+----------+---------+----------+-----------+---------------+--------+--------+--------+--------------+---------+-------------+---------------------+-------------+------------------------+----------------------+
| name        | test1      | 87775.0  | 48824.0 | 0.0      | 351100.0  | 4.0           | '0001' | 'ffff' | FULL   | FUNDAMENTALS | MANUAL  | 0           | 2025-02-05 12:17:08 | 0           | 100000                 | 3                    |
| id          | test1      | 100000.0 | 8965.0  | 0.0      | 351400.0  | 3.514         | 1000   | 9999   | SAMPLE | FUNDAMENTALS | MANUAL  | 0           | 2025-02-05 12:17:41 | 0           | 100000                 | 3                    |
+-------------+------------+----------+---------+----------+-----------+---------------+--------+--------+--------+--------------+---------+-------------+---------------------+-------------+------------------------+----------------------+

2. Вывести статистику всех столбцов таблицы test1 из текущего кеша FE.

SHOW COLUMN CACHED STATS test1;

+-------------+------------+----------+---------+----------+-----------+---------------+--------+--------+--------+--------------+---------+-------------+---------------------+-------------+------------------------+----------------------+
| column_name | index_name | count    | ndv     | num_null | data_size | avg_size_byte | min    | max    | method | type         | trigger | query_times | updated_time        | update_rows | last_analyze_row_count | last_analyze_version |
+-------------+------------+----------+---------+----------+-----------+---------------+--------+--------+--------+--------------+---------+-------------+---------------------+-------------+------------------------+----------------------+
| name        | test1      | 87775.0  | 48824.0 | 0.0      | 351100.0  | 4.0           | '0001' | 'ffff' | FULL   | FUNDAMENTALS | MANUAL  | 0           | 2025-02-05 12:17:08 | 0           | 100000                 | 3                    |
| id          | test1      | 100000.0 | 8965.0  | 0.0      | 351400.0  | 3.514         | 1000   | 9999   | SAMPLE | FUNDAMENTALS | MANUAL  | 0           | 2025-02-05 12:17:41 | 0           | 100000                 | 3                    |
+-------------+------------+----------+---------+----------+-----------+---------------+--------+--------+--------+--------------+---------+-------------+---------------------+-------------+------------------------+----------------------+