SHOW PARTITIONS

Описание

Эта инструкция используется для отображения информации о партициях. Поддерживаются Internal catalog и Hive Catalog.

Для Hive Catalog:

Поддерживается получение всех партиций, включая многоуровневые.

Синтаксис

SHOW [ TEMPORARY ] PARTITIONS
    FROM [ <db_name>. ] <table_name>
    [ <where_clause> ]
    [ ORDER BY <order_by_key> ]
    [ LIMIT <limit_rows> ];

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

1. <table_name>

Необходимо указать имя таблицы, для которой требуется просмотреть информацию о партициях.

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

1. TEMPORARY

Определяет, нужно ли запрашивать информацию о временных партициях.

2. <db_name>

Необходимо указать имя базы данных, для которой требуется просмотреть информацию о партициях.

3. <where_clause>

Условия фильтрации. Поддерживается фильтрация по таким столбцам, как PartitionId, PartitionName, State, Buckets, ReplicationNum, LastConsistencyCheckTime и др.

Обратите внимание:

1. В настоящее время условие WHERE поддерживает только операторы =, !=, like для строковых столбцов PartitionName и State. Для остальных столбцов поддерживаются только такие операторы, как =, !=, >, <, >=, <=.
2. При использовании указанных операторов в условии WHERE имя столбца должно находиться слева.
3. Условие WHERE может содержать AND.

4. <order_by_key>

Условия сортировки. Поддерживается сортировка по таким столбцам, как PartitionId, PartitionName, State, Buckets, ReplicationNum, LastConsistencyCheckTime и др.

5. <limit_rows>

Максимальное количество возвращаемых строк.

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

Столбец	Тип данных	Описание
PartitionId	bigint	Идентификатор партиции
PartitionName	varchar	Имя партиции
VisibleVersion	int	Максимальное значение VisibleVersion для tablets в этой партиции.
VisibleVersionTime	datetime	Время последней VisibleVersion в этой партиции.
State	varchar	Состояние партиции
PartitionKey	datetime	Ключ партиционирования этой партиции
Range	datetime	Диапазон партиции
DistributionKey	varchar	Ключ распределения этой партиции
Buckets	int	Количество бакетов в партиции
ReplicationNum	int	Количество реплик партиции
StorageMedium	varchar	Носитель хранения партиции
CooldownTime	datetime	Время переноса партиции в холодное хранилище. Если разделение на горячие и холодные данные не используется, значение этого поля равно [9999-12-31 23:59:59], что означает, что данные всегда остаются горячими.
RemoteStoragePolicy	varchar	Политика удалённого хранения для этой партиции.
LastConsistencyCheckTime	datetime	Время последней проверки согласованности этой партиции.
DataSize	int	Размер данных в партиции.
IsInMemory	boolean	Хранится ли партиция в памяти. Значение по умолчанию: false.
ReplicaAllocation	varchar	Стратегия распределения реплик этой партиции.
IsMutable	boolean	Допускает ли партиция изменения. Значение по умолчанию: true.
SyncWithBaseTables	boolean	Синхронизирована ли партиция с данными базовой таблицы.
UnsyncTables	varchar	Принадлежит ли партиция несинхронизированной таблице.

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

Для просмотра требуется право SHOW на соответствующую таблицу.

Примеры

1. Показать информацию обо всех невременных партициях указанной таблицы в указанной базе данных.

SHOW PARTITIONS FROM t_agg;

+-------------+---------------+----------------+---------------------+--------+--------------+-------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | State  | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime        | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize  | IsInMemory | ReplicaAllocation       | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+-------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| 170307      | t_agg         | 4              | 2024-11-05 16:13:40 | NORMAL |              |       | k1              | 1       | 1              | HDD           | 9999-12-31 23:59:59 |                     | NULL                     | 806.000 B | false      | tag.location.default: 1 | true      | true               | NULL         |
+-------------+---------------+----------------+---------------------+--------+--------------+-------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+

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

SHOW TEMPORARY PARTITIONS FROM t_temp;

+-------------+---------------+----------------+---------------------+--------+--------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | State  | PartitionKey | Range                                                                                                    | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime        | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation       | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| 828863      | tp2020        | 1              | 2025-01-22 16:19:50 | NORMAL | create_time  | [types: [DATETIMEV2]; keys: [2020-01-01 00:00:00]; ..types: [DATETIMEV2]; keys: [2021-01-01 00:00:00]; ) | reference_no    | 1       | 1              | SSD           | 9999-12-31 23:59:59 |                     | NULL                     | 0.000    | false      | tag.location.default: 1 | true      | true               | NULL         |
+-------------+---------------+----------------+---------------------+--------+--------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+

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

SHOW PARTITIONS FROM t_agg WHERE PartitionName = "p2024";

+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | State  | PartitionKey    | Range                                                                                                    | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime        | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize  | IsInMemory | ReplicaAllocation       | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| 169851      | p2024         | 2              | 2024-11-05 14:14:29 | NORMAL | idp_create_time | [types: [DATETIMEV2]; keys: [2024-01-01 00:00:00]; ..types: [DATETIMEV2]; keys: [2025-01-01 00:00:00]; ) | idp_es_id       | 3       | 1              | HDD           | 9999-12-31 23:59:59 |                     | NULL                     | 27.396 KB | false      | tag.location.default: 1 | true      | true               | NULL         |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+

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

SHOW PARTITIONS FROM t_agg ORDER BY PartitionId DESC LIMIT 1;

+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | State  | PartitionKey    | Range                                                                                                    | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime        | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation       | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| 169866      | p2025         | 1              | 2024-11-05 14:13:56 | NORMAL | idp_create_time | [types: [DATETIMEV2]; keys: [2025-01-01 00:00:00]; ..types: [DATETIMEV2]; keys: [2026-01-01 00:00:00]; ) | idp_es_id       | 3       | 1              | HDD           | 9999-12-31 23:59:59 |                     | NULL                     | 0.000    | false      | tag.location.default: 1 | true      | true               | NULL         |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+