版本: 最新版本-3.5

SHOW PARTITIONS

SHOW PARTITIONS 显示分区信息，包括普通分区和临时分区。

语法

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

注意

该语法仅支持 StarRocks 表 ("ENGINE" = "OLAP")。自 v3.0 起，此操作需要对指定表的 SELECT 权限。对于 v2.5 及更早版本，此操作需要对指定表的 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。
PartitionName	分区的名称。
VisibleVersion	最近一次成功加载事务的版本号。每次成功加载事务后，版本号增加 1。
CompactVersion	最近一次成功 Compaction 的版本号。
VisibleVersionTime	最近一次成功加载事务的时间戳。
VisibleVersionHash	最近一次成功加载事务的版本号的哈希值。
State	分区的状态。固定值：`Normal`。
PartitionKey	分区键，由一个或多个分区列组成。
范围	分区的范围，是一个右半开区间。
DistributionKey	Hash 分桶的 Bucket 键。
Buckets	分区的 Bucket 数量。
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	是否启用了数据缓存。仅适用于 Shared-Data 集群。
AsyncWrite	是否启用异步写入。仅适用于 Shared-Data 集群。
AvgCS	分区的平均 Compaction Score。仅适用于 Shared-Data 集群。
P50CS	分区的 P50 Compaction Score。仅适用于 Shared-Data 集群。
MaxCS	分区的最大 Compaction Score。仅适用于 Shared-Data 集群。
DataVersion	加载事务的版本号。不包括 Compaction 操作。
VersionEpoch	分区的 Epoch。系统在创建分区时分配版本 Epoch，并在交换分区时更改它。
VersionTxnType	生成当前数据版本的事务类型。有效值：`NORMAL` (正常事务) 和 `REPLICATION` (数据复制)。

示例

显示指定数据库 test 下指定表 site_access 中所有常规分区的信息。

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)

显示指定数据库 test 下指定表 site_access 中所有临时分区的信息。
```
SHOW TEMPORARY PARTITIONS FROM test.site_access;
```

显示指定数据库 test 下指定表 site_access 的指定分区 p1 的信息。

-- Regular partition
SHOW PARTITIONS FROM test.site_access WHERE PartitionName = "p1";
-- Temporary partition
SHOW TEMPORARY PARTITIONS FROM test.site_access WHERE PartitionName = "p1";

显示指定数据库 test 下指定表 site_access 的最新分区信息。

-- Regular partition
SHOW PARTITIONS FROM test.site_access ORDER BY PartitionId DESC LIMIT 1;
-- Temporary partition
SHOW TEMPORARY PARTITIONS FROM test.site_access ORDER BY PartitionId DESC LIMIT 1;

语法​

返回值字段说明​

示例​

您觉得这篇文档怎么样？

语法

返回值字段说明

示例