Question: How do you split a partition in PostgreSQL?


Splitting a partition in PostgreSQL involves creating new partitions from an existing one while ensuring data integrity and minimization of downtime. This process can be necessary when the size of a partition grows too large, or for better management and performance optimization. Below, we explain the typical steps involved in splitting a partition:

Step 1: Create a New Partition

First, you need to create one or more new partitions. These partitions will hold the subset of data that you intend to split from the original partition. The creation of new partitions depends on your table's partitioning strategy (range, list, or hash). For example, if your table is range-partitioned by date, you might create a new partition for a specific month:

CREATE TABLE orders_jan2020 PARTITION OF orders FOR VALUES FROM ('2020-01-01') TO ('2020-02-01');

Step 2: Migrate Data

Next, migrate the relevant data from the existing partition to the new partitions. This operation can be performed with a series of INSERT INTO ... SELECT ... commands coupled with DELETE commands, within a transaction to ensure atomicity:

BEGIN TRANSACTION; -- Insert data into the new partition INSERT INTO orders_jan2020 SELECT * FROM orders WHERE order_date >= '2020-01-01' AND order_date < '2020-02-01'; -- Remove data from the original partition DELETE FROM only orders WHERE order_date >= '2020-01-01' AND order_date < '2020-02-01'; COMMIT;

Step 3: Validate and Optimize

After migrating the data, it's important to validate the operation by checking that the data has been correctly moved and no records are lost. Additionally, this is a good time to run maintenance tasks such as VACUUM and ANALYZE to reclaim space and update statistics:



  • Downtime: Depending on the size of the data being migrated, this operation may take significant time and potentially lead to downtime. Consider performing these operations during low-traffic periods or using techniques like trigger-based replication to minimize impact.
  • Locking: The migration process involves heavy writing and deleting operations, which can lead to locking issues. Be mindful of the potential impact on concurrent access to the database.
  • Backup: Always ensure you have a recent backup before performing any operation that modifies large amounts of data.

By following these steps, you should be able to effectively split a partition in PostgreSQL, helping maintain performance and manageability of your database.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book
Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.