メインコンテンツまでスキップ
バージョン: 2.5

SHOW PARTITIONS

説明

共通パーティションや一時パーティションを含むパーティション情報を表示します。

構文:

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

注意

  • この構文は StarRocks テーブル ("ENGINE" = "OLAP") のみをサポートします。Elasticsearch や Hive テーブルの場合は、SHOW PROC '/dbs/db_id/table_id/partitions' を使用してください。
  • この操作には、指定されたテーブルに対する SELECT__PRIV 権限が必要です。

戻りフィールドの説明

+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime | VisibleVersionHash | State | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime | LastConsistencyCheckTime | DataSize | IsInMemory | RowCount |
+-------------+---------------+----------------+---------------------+--------------------+--------+--------------+-------+--------------------+---------+----------------+---------------+---------------------+--------------------------+----------+------------+----------+
フィールド説明
PartitionIdパーティションの ID です。
PartitionNameパーティションの名前です。
VisibleVersion最後に成功したロードトランザクションのバージョン番号です。バージョン番号は、ロードトランザクションが成功するたびに 1 ずつ増加します。
VisibleVersionTime最後に成功したロードトランザクションのタイムスタンプです。
VisibleVersionHash最後に成功したロードトランザクションのバージョン番号のハッシュ値です。
Stateパーティションの状態です。固定値: Normal
PartitionKey1 つ以上のパーティション列で構成されるパーティションキーです。
Rangeパーティションの範囲で、右半開区間です。
DistributionKeyハッシュバケッティングのバケットキーです。
Bucketsパーティションのバケット数です。
ReplicationNumパーティション内の各タブレットのレプリカ数です。
StorageMediumパーティション内のデータを保存する記憶媒体です。値 HHD はハードディスクドライブを示し、値 SSD はソリッドステートドライブを示します。
CooldownTimeパーティション内のデータのクールダウン時間です。初期の記憶媒体が SSD の場合、このパラメータで指定された時間の後に記憶媒体が SSD から HDD に切り替わります。形式: "yyyy-MM-dd HH:mm:ss"。
LastConsistencyCheckTime最後の整合性チェックの時間です。NULL は整合性チェックが実行されなかったことを示します。
DataSizeパーティション内のデータサイズです。
IsInMemoryパーティション内のすべてのデータがメモリに保存されているかどうかです。
RowCountパーティションのデータ行数です。

  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
    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;