メインコンテンツまでスキップ

SHOW PARTITIONS

SHOW PARTITIONS

説明

一般的なパーティションと一時的なパーティションを含むパーティション情報を表示します。

構文

SHOW [TEMPORARY] PARTITIONS FROM [データベース名.]テーブル名 [WHERE] [ORDER BY] [LIMIT]

注意

この構文は、StarRocksのテーブル("ENGINE" = "OLAP")のみをサポートしています。 v3.0以降、この操作には指定したテーブルのSELECT権限が必要です。v2.5以前のバージョンでは、この操作には指定したテーブルの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

PartitionKey

1つまたは複数のパーティション列で構成されるパーティションキー。

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;