SHOW PARTITIONS

SHOW PARTITIONS отображает информацию о разделах, включая обычные разделы и временные разделы.

Синтаксис

SHOW [TEMPORARY] PARTITIONS FROM [db_name.]table_name [WHERE] [ORDER BY] [LIMIT]

ПРИМЕЧАНИЕ

Этот синтаксис поддерживает только таблицы Selena ("ENGINE" = "OLAP"). Начиная с версии 1.5.0, эта операция требует привилегию SELECT для указанной таблицы. Для версий 2.5 и более ранних эта операция требует привилегию SELECT__PRIV для указанной таблицы.

Описание возвращаемых полей

-- В кластере shared-nothing
+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | VisibleVersionHash | State  | PartitionKey | Range | DistributionKey    | Buckets | ReplicationNum | StorageMedium | CooldownTime        | LastConsistencyCheckTime | DataSize | IsInMemory | RowCount |
+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
-- В кластере shared-data
+-------------+---------------+----------------+----------------+-------------+--------+--------------+------------------------------------------------------------------------------------------------------+-----------------+---------+----------+-------------+----------+-----------------+------------+-------+-------+-------+-------------+--------------------+----------------+
| PartitionId | PartitionName | CompactVersion | VisibleVersion | NextVersion | State  | PartitionKey | Range | DistributionKey | Buckets | DataSize | StorageSize | RowCount | EnableDataCache | AsyncWrite | AvgCS | P50CS | MaxCS | DataVersion | VersionEpoch       | VersionTxnType |
+-------------+---------------+----------------+----------------+-------------+--------+--------------+------------------------------------------------------------------------------------------------------+-----------------+---------+----------+-------------+----------+-----------------+------------+-------+-------+-------+-------------+--------------------+----------------+

Поле	Описание
PartitionId	Идентификатор раздела.
PartitionName	Имя раздела.
VisibleVersion	Номер версии последней успешной транзакции загрузки. Номер версии увеличивается на 1 с каждой успешной транзакцией загрузки.
CompactVersion	Номер версии последнего успешного уплотнения.
VisibleVersionTime	Временная метка последней успешной транзакции загрузки.
VisibleVersionHash	Хеш-значение для номера версии последней успешной транзакции загрузки.
State	Статус раздела. Фиксированное значение: Normal.
PartitionKey	Ключ раздела, состоящий из одного или нескольких столбцов раздела.
Range	Диапазон раздела, который является правым полуоткрытым интервалом.
DistributionKey	Ключ корзины для хеш-группировки.
Buckets	Количество корзин для раздела.
ReplicationNum	Количество реплик на tablet в разделе.
StorageMedium	Носитель данных для хранения данных в разделе. Значение HHD указывает на жесткие диски, а значение SSD указывает на твердотельные накопители.
CooldownTime	Время охлаждения для данных в разделе. Если начальным носителем является SSD, носитель переключается с SSD на HDD после времени, указанного этим параметром. Формат: "yyyy-MM-dd HH:mm:ss".
LastConsistencyCheckTime	Время последней проверки согласованности. NULL указывает, что проверка согласованности не выполнялась.
DataSize	Размер данных в разделе.
IsInMemory	Хранятся ли все данные в разделе в памяти.
StorageSize	Размер хранилища, фактически занимаемого разделом. Только для кластеров shared-data.
RowCount	Количество строк данных раздела. Только для кластеров shared-data.
EnableDataCache	Включен ли Data Cache. Только для кластеров shared-data.
AsyncWrite	Включена ли асинхронная запись. Только для кластеров shared-data.
AvgCS	Средний Compaction Score раздела. Только для кластеров shared-data.
P50CS	P50 Compaction Score раздела. Только для кластеров shared-data.
MaxCS	Максимальный Compaction Score раздела. Только для кластеров shared-data.
DataVersion	Номер версии транзакций загрузки. Операции уплотнения не включены.
VersionEpoch	Эпоха раздела. Система назначает эпоху версии при создании раздела и изменяет её при замене раздела.
VersionTxnType	Тип транзакции, которая генерирует текущую версию данных. Допустимые значения: NORMAL (обычная транзакция) и REPLICATION (репликация данных).

Примеры

1. Отобразить информацию обо всех обычных разделах из указанной таблицы site_access в указанной базе данных test.

   MySQL > show partitions from test.site_access\G
   *************************** 1. row ***************************
               PartitionId: 20990
           PartitionName: p2019 
           VisibleVersion: 1
       VisibleVersionTime: 2023-08-08 15:45:13
       VisibleVersionHash: 0
                   State: NORMAL
               PartitionKey: datekey
                   Range: [types: [DATE]; keys: [2019-01-01]; ..types: [DATE]; keys: [2020-01-01]; )
           DistributionKey: site_id
                   Buckets: 6
           ReplicationNum: 3
           StorageMedium: HDD
               CooldownTime: 9999-12-31 23:59:59
   LastConsistencyCheckTime: NULL
                   DataSize:  4KB   
               IsInMemory: false
                   RowCount: 3 
   1 row in set (0.00 sec)

2. Отобразить информацию обо всех временных разделах из указанной таблицы site_access в указанной базе данных test.

   SHOW TEMPORARY PARTITIONS FROM test.site_access;

3. Отобразить информацию об указанном разделе p1 указанной таблицы site_access в указанной базе данных test.

   -- Обычный раздел
   SHOW PARTITIONS FROM test.site_access WHERE PartitionName = "p1";
   -- Временный раздел
   SHOW TEMPORARY PARTITIONS FROM test.site_access WHERE PartitionName = "p1";

4. Отобразить информацию о последнем разделе указанной таблицы site_access в указанной базе данных test.

   -- Обычный раздел
   SHOW PARTITIONS FROM test.site_access ORDER BY PartitionId DESC LIMIT 1;
   -- Временный раздел
   SHOW TEMPORARY PARTITIONS FROM test.site_access ORDER BY PartitionId DESC LIMIT 1;