How do I choose the right composite index column order in PostgreSQL?
Question
I have an `orders` table with millions of rows, and my most frequent query is `WHERE user_id = X AND status = 'completed' ORDER BY created_at DESC`. It's painfully slow right now; the table has separate single-column indexes on `user_id`, `status`, and `created_at`, and when the DB tries to combine them with a Bitmap Index Scan the cost blows up. What's the most efficient composite index column order? And how does each column's selectivity (cardinality) affect that order?
Answer
Short answer: build one composite index for this query — (user_id, status, created_at DESC). Equality columns first, the ORDER BY column last; everything else falls out of that.
The slowness isn’t a missing index, it’s the wrong index shape: with three separate single-column indexes the DB has to merge them via a Bitmap Index Scan and then run a separate Sort step — both expensive.
- Equality columns first, sort column last. The rule is clean: columns you filter on with equality (
=) go at the front of the index — hereuser_idandstatus. The column in your ORDER BY goes last:(user_id, status, created_at DESC). After applying the equality filter, the B-tree already hands rows back increated_at DESCorder, so there’s no separate Sort step. - Put
DESCinto the index. If your sort is one-directional (created_at DESC), bake that into the index definition. On a single column PostgreSQL can scan backwards, but pinning the direction in a composite guarantees the planner’s job and makes the sort free. - Cardinality is secondary when both are equalities. Cardinality decides which equality column should lead, but here both are equality predicates, so the real win is moving the sort into the index. Still, putting the higher-selectivity column (usually
user_id) first narrows the initial scan. - Confirm with
EXPLAIN (ANALYZE, BUFFERS). The plan you want is a single Index Scan — notBitmap Index Scan+Sort. If you still see a Sort, your column order orDESCdirection is wrong. - Consider a partial index if
completeddominates. If most of your queries arestatus = 'completed', a partial index withWHERE status = 'completed'shrinks the index, keeps more of it in RAM, and lowers write cost.
Bottom line: I’d build the (user_id, status, created_at DESC) composite index, confirm with EXPLAIN (ANALYZE, BUFFERS) that it drops to an Index Scan, and then drop the single-column user_id/status indexes this one already covers — redundant indexes only slow writes down. If your traffic piles onto one status, tighten it further with a partial index. For a deeper take on where indexing meets native SQL, see the sade.dev piece.
Related Reading
Comments
Sign in with your GitHub account to join the discussion. Comments are stored in GitHub Discussions.