SHOW PARTITIONS

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

Синтаксис

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

NOTE

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

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

-- In shared-nothing cluster
+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | VisibleVersionHash | State  | PartitionKey | Range | DistributionKey    | Buckets | ReplicationNum | StorageMedium | CooldownTime        | LastConsistencyCheckTime | DataSize | IsInMemory | RowCount |
+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
-- In shared-data cluster
+-------------+---------------+----------------+----------------+-------------+--------+--------------+------------------------------------------------------------------------------------------------------+-----------------+---------+----------+-------------+----------+-----------------+------------+-------+-------+-------+-------------+--------------------+----------------+
| PartitionId | PartitionName | CompactVersion | VisibleVersion | NextVersion | State  | PartitionKey | Range | DistributionKey | Buckets | DataSize | StorageSize | RowCount | EnableDataCache | AsyncWrite | AvgCS | P50CS | MaxCS | DataVersion | VersionEpoch       | VersionTxnType |
+-------------+---------------+----------------+----------------+-------------+--------+--------------+------------------------------------------------------------------------------------------------------+-----------------+---------+----------+-------------+----------+-----------------+------------+-------+-------+-------+-------------+--------------------+----------------+

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

Примеры

1. Отобразить информацию обо всех обычных partition из указанной таблицы 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. Отобразить информацию обо всех временных partition из указанной таблицы site_access в указанной базе данных test.

   SHOW TEMPORARY PARTITIONS FROM test.site_access;

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

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

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

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