23.3 Partition Management

There are a number of ways using SQL statements to modify partitioned tables; it is possible to add, drop, redefine, merge, or split existing partitions using the partitioning extensions to the ALTER TABLE statement. There are also ways to obtain information about partitioned tables and partitions. We discuss these topics in the sections that follow.

To change a table's partitioning scheme, it is necessary only to use the ALTER TABLE statement with a partition_options option, which has the same syntax as that as used with CREATE TABLE for creating a partitioned table; this option (also) always begins with the keywords PARTITION BY. Suppose that the following CREATE TABLE statement was used to create a table that is partitioned by range:

To repartition this table so that it is partitioned by key into two partitions using the id column value as the basis for the key, you can use this statement:

This has the same effect on the structure of the table as dropping the table and re-creating it using CREATE TABLE trb3 PARTITION BY KEY(id) PARTITIONS 2;.

ALTER TABLE ... ENGINE = ... changes only the storage engine used by the table, and leaves the table's partitioning scheme intact. The statement succeeds only if the target storage engine provides partitioning support. You can use ALTER TABLE ... REMOVE PARTITIONING to remove a table's partitioning; see Section 13.1.9, “ALTER TABLE Syntax”.

You can delete all rows from one or more selected partitions using ALTER TABLE ... TRUNCATE PARTITION.