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 | パーティション名 |
| 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 |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+