查看指定表所有分区

功能描述

查看指定表的所有分区。可通过 PARTITION 子句指定分区条件进行筛选，支持部分分区键匹配。

语法格式

SHOW PARTITIONS [ db_name. ] table_name [ PARTITION partition_specs ]

其中 partition_specs 的语法为：

partition_specs = ( partition_col_name = partition_col_value [ , partition_col_name = partition_col_value , ... ] )

参数说明

参数	是否必选	描述
db_name	否	数据库名称。若未指定，则默认使用当前数据库。命名规则：由字母、数字和下划线（_）组成，不能是纯数字，且不能以下划线开头。
table_name	是	表名称。所查看的表必须是分区表，否则会出错。命名规则：由字母、数字和下划线（_）组成，不能是纯数字，且不能以下划线开头。匹配规则为：^(?!_)(?![0-9]+$)[A-Za-z0-9_$]*$。如果包含特殊字符需要使用反引号（``）包围起来。
PARTITION partition_specs	否	分区筛选条件，格式为 key=value 形式。若分区字段为多个字段，可以不包含所有字段，系统会返回匹配上的所有分区信息。

注意事项

所要查看分区的表必须存在且是分区表，否则会出错。
partition_specs 中可以只指定部分分区键，系统将返回所有匹配的分区。例如，对于 (year, month, day) 三级分区表，只指定 year=2024 将返回该年份下的所有分区。

示例1：查看表的所有分区

查看 student 表下的所有分区。

SHOW PARTITIONS student;

返回结果示例：

+-------------------+
|partition          |
+-------------------+
|year=2024/month=01 |
|year=2024/month=02 |
|year=2024/month=03 |
+-------------------+

示例2：查看指定分区

查看 student 表中 year=2024 且 month=01 的分区。

SHOW PARTITIONS student PARTITION(year='2024', month='01');

示例3：部分分区键匹配

查看 student 表中 year=2024 的所有分区（不指定 month，将返回该年份下的所有月份分区）。

SHOW PARTITIONS student PARTITION(year='2024');

返回结果示例：

+-------------------+
|partition          |
+-------------------+
|year=2024/month=01 |
|year=2024/month=02 |
|year=2024/month=03 |
+-------------------+