SHOW PARTITIONS
Descriptions
この文は、パーティション情報を表示するために使用されます。内部カタログとHive Catalogの両方をサポートしています。
Hive カタログの場合：
マルチレベルパーティションを含む、すべてのパーティションの返却をサポートしています。
Syntax
SHOW [ TEMPORARY ] PARTITIONS
FROM [ <db_name>. ] <table_name>
[ <where_clause> ]
[ ORDER BY <order_by_key> ]
[ LIMIT <limit_rows> ];
必須パラメータ
1. <table_name>
パーティション情報を表示するTableの名前を指定する必要があります。
オプションパラメータ
1. TEMPORARY
一時パーティションの情報を問い合わせるかどうか。
2. <db_name>
パーティション情報を表示するデータベースの名前を指定する必要があります。
3. <where_clause>
フィルタ条件。PartitionId、PartitionName、State、Buckets、ReplicationNum、LastConsistencyCheckTimeなどのカラムでのフィルタリングをサポートします。
以下の点にご注意ください:
- 現在、where句は文字列型のPartitionName、Stateに対してのみ
=、!=、like演算子をサポートします。その他のカラムに対しては=、!=、>、<、>=、<=などの演算子のみサポートします。 - where句で上記の演算子を使用する場合、カラム名は左側に記述する必要があります。
- Where句には
ANDを含めることができます。
4. <order_by_key>
ソート条件。PartitionId、PartitionName、State、Buckets、ReplicationNum、LastConsistencyCheckTimeなどのカラムでのソートをサポートします。
5. <limit_rows>
返される最大行数。
戻り値
| Columns | DataType | Note |
|---|---|---|
| PartitionId | bigint | パーティション ID |
| PartitionName | varchar | パーティション Name |
| VisibleVersion | int | このパーティション内のタブレットの最大VisibleVersion。 |
| VisibleVersionTime | datetime | このパーティションで最も新しいVisibleVersionの時刻。 |
| State | varchar | このパーティションのState |
| PartitionKey | datetime | このパーティションのパーティションキー |
| Range | datetime | このパーティションのRange |
| DistributionKey | varchar | このパーティションのディストリビューションキー |
| Buckets | int | このパーティションのバケット数 |
| ReplicationNum | int | このパーティションのレプリカ数 |
| StorageMedium | varchar | このパーティションのストレージメディア |
| CooldownTime | datetime | このパーティションのクールダウン時刻。ホット・コールド分離がない場合、このフィールドの値は[9999-12-31 23:59:59]となり、常にホットデータであることを意味します。 |
| RemoteStoragePolicy | varchar | このパーティションのリモートストレージポリシー。 |
| LastConsistencyCheckTime | datetime | このパーティションの最後のパーティション整合性チェックの時刻。 |
| DataSize | int | このパーティション配下のデータサイズ。 |
| IsInMemory | boolean | インメモリパーティションかどうか、デフォルトはfalse。 |
| ReplicaAllocation | varchar | このパーティションのレプリカ配布戦略。 |
| IsMutable | boolean | パーティションが可変かどうか、デフォルトはtrue。 |
| SyncWithBaseTables | boolean | パーティションがベースTableのデータと同期しているかどうか。 |
| UnsyncTables | varchar | パーティションが非同期Tableのパーティションかどうか。 |
アクセス制御要件
表示するTableのSHOW権限が必要です。
例
- 指定されたデータベース内の指定されたTableのすべての非一時パーティション情報を表示します。
SHOW PARTITIONS FROM t_agg;
+-------------+---------------+----------------+---------------------+--------+--------------+-------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime | State | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+-------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| 170307 | t_agg | 4 | 2024-11-05 16:13:40 | NORMAL | | | k1 | 1 | 1 | HDD | 9999-12-31 23:59:59 | | NULL | 806.000 B | false | tag.location.default: 1 | true | true | NULL |
+-------------+---------------+----------------+---------------------+--------+--------------+-------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
- 指定されたデータベース内の指定されたTableに対するすべての一時パーティション情報を表示します。
SHOW TEMPORARY PARTITIONS FROM t_temp;
+-------------+---------------+----------------+---------------------+--------+--------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime | State | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| 828863 | tp2020 | 1 | 2025-01-22 16:19:50 | NORMAL | create_time | [types: [DATETIMEV2]; keys: [2020-01-01 00:00:00]; ..types: [DATETIMEV2]; keys: [2021-01-01 00:00:00]; ) | reference_no | 1 | 1 | SSD | 9999-12-31 23:59:59 | | NULL | 0.000 | false | tag.location.default: 1 | true | true | NULL |
+-------------+---------------+----------------+---------------------+--------+--------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
- 指定されたデータベース内の指定されたTableについて、指定された非一時パーティションの情報を表示し、結果をフィルタリングします。
SHOW PARTITIONS FROM t_agg WHERE PartitionName = "p2024";
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime | State | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
| 169851 | p2024 | 2 | 2024-11-05 14:14:29 | NORMAL | idp_create_time | [types: [DATETIMEV2]; keys: [2024-01-01 00:00:00]; ..types: [DATETIMEV2]; keys: [2025-01-01 00:00:00]; ) | idp_es_id | 3 | 1 | HDD | 9999-12-31 23:59:59 | | NULL | 27.396 KB | false | tag.location.default: 1 | true | true | NULL |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
- 指定されたデータベース内の指定されたTableについて、最新の非一時パーティションの情報を表示します。
SHOW PARTITIONS FROM t_agg ORDER BY PartitionId DESC LIMIT 1;
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime | State | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| 169866 | p2025 | 1 | 2024-11-05 14:13:56 | NORMAL | idp_create_time | [types: [DATETIMEV2]; keys: [2025-01-01 00:00:00]; ..types: [DATETIMEV2]; keys: [2026-01-01 00:00:00]; ) | idp_es_id | 3 | 1 | HDD | 9999-12-31 23:59:59 | | NULL | 0.000 | false | tag.location.default: 1 | true | true | NULL |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+