SHOW PARTITIONS
Applies to: Databricks SQL
Databricks Runtime
Lists partitions of a table.
Syntax
SHOW PARTITIONS table_name [ PARTITION clause ]
Parameters
-
Identifies the table. The name must not include a temporal specification.
-
An optional parameter that specifies a partition. If the specification is only a partial all matching partitions are returned. If no partition is specified at all Databricks SQL returns all partitions.
Examples
-- create a partitioned table and insert a few rows.
> USE salesdb;
> CREATE TABLE customer(id INT, name STRING) PARTITIONED BY (state STRING, city STRING);
> INSERT INTO customer PARTITION (state = 'CA', city = 'Fremont') VALUES (100, 'John');
> INSERT INTO customer PARTITION (state = 'CA', city = 'San Jose') VALUES (200, 'Marry');
> INSERT INTO customer PARTITION (state = 'AZ', city = 'Peoria') VALUES (300, 'Daniel');
-- Lists all partitions for table `customer`
> SHOW PARTITIONS customer;
state=AZ/city=Peoria
state=CA/city=Fremont
state=CA/city=San Jose
-- Lists all partitions for the qualified table `customer`
> SHOW PARTITIONS salesdb.customer;
state=AZ/city=Peoria
state=CA/city=Fremont
state=CA/city=San Jose
-- Specify a full partition spec to list specific partition
> SHOW PARTITIONS customer PARTITION (state = 'CA', city = 'Fremont');
|state=CA/city=Fremont|
-- Specify a partial partition spec to list the specific partitions
> SHOW PARTITIONS customer PARTITION (state = 'CA');
state=CA/city=Fremont
state=CA/city=San Jose
-- Specify a partial spec to list specific partition
> SHOW PARTITIONS customer PARTITION (city = 'San Jose');
state=CA/city=San Jose