に最終更新
SHOW PARTITIONS
説明
パーティション情報を表示します。Internal Catalog と Hive Catalog の両方に対応します。
Hive Catalog の場合:
多階層のパーティションを含め、すべてのパーティションを返せます。
構文
SHOW [ TEMPORARY ] PARTITIONS
FROM [ <db_name>. ] <table_name>
[ <where_clause> ]
[ ORDER BY <order_by_key> ]
[ LIMIT <limit_rows> ];
必須パラメータ
1. <table_name>
パーティション情報を表示するテーブル名を指定する必要があります。
任意パラメータ
1. TEMPORARY
一時パーティションの情報を照会するかどうかを指定します。
2. <db_name>
パーティション情報を表示するデータベース名を指定します。
3. <where_clause>
フィルター条件。PartitionId、PartitionName、State、Buckets、ReplicationNum、LastConsistencyCheckTime などの列で絞り込めます。
次の点に注意してください。
- 現在、文字列型の PartitionName と State に対しては、WHERE 句で
=、!=、likeのみを使用できます。その他の列では=、!=、>、<、>=、<=などを使用できます。 - WHERE 句で上記の演算子を使用する場合、列名を左辺に置く必要があります。
- WHERE 句では
ANDを使用できます。
4. <order_by_key>
並べ替え条件。PartitionId、PartitionName、State、Buckets、ReplicationNum、LastConsistencyCheckTime などの列で並べ替えられます。
5. <limit_rows>
返される行数の上限。
戻り値
| 列 | データ型 | 説明 |
|---|---|---|
| PartitionId | bigint | パーティション ID |
| PartitionName | varchar | パーティション名 |
| Visibleバージョン | int | このパーティション内のタブレットの Visibleバージョン の最大値。 |
| VisibleバージョンTime | datetime | このパーティションの最新の Visibleバージョン の時刻。 |
| State | varchar | このパーティションの状態 |
| PartitionKey | datetime | このパーティションのパーティションキー |
| Range | datetime | このパーティションの範囲 |
| 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 | パーティションがベーステーブルのデータと同期しているかどうか。 |
| UnsyncTables | varchar | パーティションが未同期テーブルのパーティションかどうか。 |
必要な権限
表示するテーブルに対する SHOW 権限が必要です。
例
- 指定したデータベースの指定したテーブルについて、すべての通常パーティションの情報を表示します。
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 |
+-------------+---------------+----------------+---------------------+--------+--------------+-------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
- 指定したデータベースの指定したテーブルについて、すべての一時パーティションの情報を表示します。
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 |
+-------------+---------------+----------------+---------------------+--------+--------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
- 指定したデータベースの指定したテーブルについて、特定の通常パーティションの情報を絞り込んで表示します。
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 |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+-----------+------------+-------------------------+-----------+--------------------+--------------+
- 指定したデータベースの指定したテーブルについて、最新の通常パーティションの情報を表示します。
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 |
+-------------+---------------+----------------+---------------------+--------+-----------------+----------------------------------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
