PARTITIONS

Описание

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

Синтаксис

PARTITIONS(
    "catalog"="<catalog>",
    "database"="<database>",
    "table"="<table>"
)

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

Поле	Описание
<catalog>	Укажите имя каталога кластера, для которого выполняется запрос.
<database>	Укажите имя базы данных кластера, для которой выполняется запрос.
<table>	Укажите имя таблицы кластера, для которой выполняется запрос.

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

Поле	Описание
PartitionId	ID раздела
PartitionName	Имя раздела
VisibleVersion	Версия раздела
VisibleVersionTime	Время фиксации версии раздела
State	Состояние раздела
PartitionKey	Ключ раздела
Range	Диапазон раздела
DistributionKey	Ключ распределения при разбиении на разделы
Buckets	Количество бакетов в разделе
ReplicationNum	Количество реплик в разделе
StorageMedium	Носитель данных, используемый для раздела
CooldownTime	Время охлаждения раздела
RemoteStoragePolicy	Политика удалённого хранения для раздела
LastConsistencyCheckTime	Время последней проверки согласованности раздела
DataSize	Размер данных в разделе
IsInMemory	Хранится ли раздел в памяти
ReplicaAllocation	Стратегия репликации раздела
IsMutable	Можно ли изменять раздел
SyncWithBaseTables	Синхронизирован ли раздел с базовой таблицей (для асинхронных материализованных представлений)
UnsyncTables	Какая базовая таблица не синхронизирована (для разделов асинхронных материализованных представлений)

Примеры

Просмотр списка разделов таблицы example_table в базе данных test каталога internal

select * from partitions("catalog"="internal","database"="test","table"="example_table");

+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | State  | PartitionKey | Range                                                                          | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime        | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation       | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
|       43209 | p1            |              1 | 2025-01-17 12:35:22 | NORMAL | created_at   | [types: [DATEV2]; keys: [0000-01-01]; ..types: [DATEV2]; keys: [2023-01-01]; ) | id              |      10 |              1 | HDD           | 9999-12-31 23:59:59 |                     | \N                       | 0.000    |          0 | tag.location.default: 1 |         1 |                  1 | \N           |
|       43210 | p2            |              1 | 2025-01-17 12:35:22 | NORMAL | created_at   | [types: [DATEV2]; keys: [2023-01-01]; ..types: [DATEV2]; keys: [2024-01-01]; ) | id              |      10 |              1 | HDD           | 9999-12-31 23:59:59 |                     | \N                       | 0.000    |          0 | tag.location.default: 1 |         1 |                  1 | \N           |
|       43211 | p3            |              1 | 2025-01-17 12:35:22 | NORMAL | created_at   | [types: [DATEV2]; keys: [2024-01-01]; ..types: [DATEV2]; keys: [2025-01-01]; ) | id              |      10 |              1 | HDD           | 9999-12-31 23:59:59 |                     | \N                       | 0.000    |          0 | tag.location.default: 1 |         1 |                  1 | \N           |
|       43212 | p4            |              1 | 2025-01-17 12:35:22 | NORMAL | created_at   | [types: [DATEV2]; keys: [2025-01-01]; ..types: [DATEV2]; keys: [2026-01-01]; ) | id              |      10 |              1 | HDD           | 9999-12-31 23:59:59 |                     | \N                       | 0.000    |          0 | tag.location.default: 1 |         1 |                  1 | \N           |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+

Просмотр информации о разделе с именем p1 в таблице example_table

select * from partitions("catalog"="internal","database"="test","table"="example_table") where PartitionName = "p1";

+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | State  | PartitionKey | Range                                                                          | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime        | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation       | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
|       43209 | p1            |              1 | 2025-01-17 12:35:22 | NORMAL | created_at   | [types: [DATEV2]; keys: [0000-01-01]; ..types: [DATEV2]; keys: [2023-01-01]; ) | id              |      10 |              1 | HDD           | 9999-12-31 23:59:59 |                     | \N                       | 0.000    |          0 | tag.location.default: 1 |         1 |                  1 | \N           |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+

Просмотр ID раздела с именем p1 в таблице example_table

select PartitionId from partitions("catalog"="internal","database"="test","table"="example_table") where PartitionName = "p1";

+-------------+
| PartitionId |
+-------------+
|       43209 |
+-------------+