Question: What does clustering a table in PostgreSQL involve?


Clustering a table in PostgreSQL refers to the process of physically reordering the data in a table based on the index to improve performance for specific types of queries. This is particularly useful when you have a large table and queries that frequently access ordered subsets of the data.

How Does Clustering Work?

When you cluster a table in PostgreSQL, it reorders the table's physical data according to the specified index's order. This ordering can significantly speed up queries that benefit from this sort of order, such as range queries or queries with ORDER BY clauses that match the index. However, it's important to note that clustering is a one-time operation: the database does not maintain the order after DML operations (inserts, updates, deletes).


To cluster a table, you first need to create an index on the columns that you want the table to be clustered by. Then, you use the CLUSTER statement:

-- Create an index CREATE INDEX idx_table_column ON my_table(column_to_cluster); -- Cluster the table using the created index CLUSTER my_table USING idx_table_column;

After executing these commands, PostgreSQL will reorder my_table physically on the disk to match the order of idx_table_column.


  • One-Time Operation: As mentioned, clustering is not maintained during table modifications. If the table is frequently updated, its physical order may become inefficient over time. To reapply clustering, you must execute the CLUSTER command again.
  • Downtime: Clustering a table locks the table for writes, so it should ideally be done during periods of low activity.
  • Maintenance: To automate re-clustering, you can use periodic maintenance jobs or manually recluster the table when necessary.

Use Cases

Clustering is particularly beneficial for databases where read performance is critical and specific queries are run frequently. It is less beneficial when tables are subject to frequent inserts, updates, or deletions, which might undo the benefits of clustering quickly.

In summary, CLUSTER can significantly improve the performance of your PostgreSQL queries by reducing disk I/O and improving index scan speeds for large datasets. However, due to its limitations like lack of automatic maintenance after DML operations, it should be used judiciously based on the query patterns and update frequency of your data.

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.