大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:SHOW PARTITIONS

· 52CE 我爱测

# SHOW PARTITIONS ## 功能 该语句用于展示正常分区或临时分区信息。 ## 语法 > 说明 > > * 支持 PartitionId,PartitionName,State,Buckets,ReplicationNum,LastConsistencyCheckTime 等列的过滤。 > * 该语法只支持 StarRocks 表 (即 )。 > * 自 3.0 版本起,该操作需要对应表的 SELECT 权限。 3.0 版

SHOW PARTITIONS

功能

该语句用于展示正常分区或临时分区信息。

语法

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

说明

  • 支持 PartitionId,PartitionName,State,Buckets,ReplicationNum,LastConsistencyCheckTime 等列的过滤。
  • 该语法只支持 StarRocks 表 (即 "ENGINE" = "OLAP")。
  • 自 3.0 版本起,该操作需要对应表的 SELECT 权限。 3.0 版本之前,该操作需要对应数据库和表的 SELECT_PRIV 权限。

返回结果说明

-- 存算一体集群
+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime  | VisibleVersionHash | State  | PartitionKey | Range | DistributionKey    | Buckets | ReplicationNum | StorageMedium | CooldownTime        | LastConsistencyCheckTime | DataSize | IsInMemory | RowCount |
+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
-- 存算分离集群
+-------------+---------------+----------------+----------------+-------------+--------+--------------+------------------------------------------------------------------------------------------------------+-----------------+---------+----------+-------------+----------+-----------------+------------+-------+-------+-------+-------------+--------------------+----------------+
| 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 分区键,由一个或多个分区列组成。
Range Range 分区的范围,为左闭右开区间。
DistributionKey 分区中数据进行哈希分桶时的分桶键。
Buckets 分区中的分桶数量。对于使用 Range 分布的表,该值为分区中 Base Index 的实际 Tablet 数量,会随 Tablet 的分裂与合并而变化。同一分区中的 Rollup Index 可能拥有不同的 Tablet 数量。
ReplicationNum 分区中每个 Tablet 的副本数量。
StorageMedium 数据存储介质。返回值为 HDD 表示机械硬盘,返回值为 SSD 表示固态硬盘。
CooldownTime 数据降冷时间。如果一开始数据的存储介质为 SSD ,在该时间点之后,数据存储介质会从 SSD 切换为 HDD。 格式:"yyyy-MM-dd HH:mm:ss"。
LastConsistencyCheckTime 最后一次一致性检查的时间。NULL 表示没有进行一致性检查。
DataSize 分区中数据大小。
IsInMemory 该分区数据是否全部存储在内存中。
StorageSize 分区实际占用的存储空间大小。仅适用于存算分离集群。
RowCount 该分区数据行数。
EnableDataCache 是否启用 Data Cache。仅适用于存算分离集群。
AsyncWrite 是否启用异步写入。仅适用于存算分离集群。
AvgCS 分区的平均 Compaction Score。仅适用于存算分离集群。
P50CS 分区的 P50 Compaction Score。仅适用于存算分离集群。
MaxCS 该分区最大 Compaction Score。仅限存算分离集群。
DataVersion 导入事务的版本号。不包括 Compaction 操作。
VersionEpoch 分区的纪元号。系统会在创建分区时赋值纪元,并在每次分区被 SWAP 时更改版本纪元。
VersionTxnType 生成当前数据版本的事务类型。有效值:NORMAL(正常事务)和 REPLICATION(数据复制)。
LastUpdateTime 分区最近一次被用户写入(导入 / INSERT / DELETE / UPDATE)修改的时间。
LastAccessTime 分区最近一次被用户语句读取的时间,包括查询、INSERT ... SELECT、INSERT OVERWRITE、CTAS、主键表的 UPDATE/DELETE、物化视图刷新以及 EXPORT;内部统计信息采集发起的读取不计入。当前仅保存在 FE 内存中(不持久化),查询时跨 FE 聚合结果。

示例

  1. 查询指定数据库(例如 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 
            LastUpdateTime: 2023-08-08 15:45:13
            LastAccessTime: 2023-08-09 10:00:00
    1 row in set (0.00 sec)
    
  2. 查询指定数据库(例如 test)下指定表(例如 site_access)的所有临时分区信息:

    SHOW TEMPORARY PARTITIONS FROM test.site_access;
    
  3. 查询指定数据库(例如 test)下指定表(例如 site_access)的指定分区(例如 p1)的信息。

    -- 正常分区
    SHOW PARTITIONS FROM test.site_access WHERE PartitionName = "p1";
    -- 临时分区
    SHOW TEMPORARY PARTITIONS FROM test.site_access WHERE PartitionName = "p1";
    
  4. 查询指定数据库(例如 test)下指定表(例如 site_access)的最新分区的信息。

    -- 正常分区
    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;
    

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。