Scaling Indexes with Partitioning
Learn how indexes interact with partitioned tables and strategies for creating effective local and global indexes.
Scaling Indexes with Partitioning is a free Advanced PostgreSQL: Indexing, Partitioning, Replication lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Advanced PostgreSQL: Indexing, Partitioning, Replication learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Indexes & Partitioning Synergy
When dealing with truly massive datasets in PostgreSQL, combining indexing and partitioning isn't just an option—it's often a necessity for maintaining performance.
This lesson explores how indexes interact with partitioned tables, and the strategies for creating indexes that scale effectively alongside your data divisions.
Understanding Local Indexes
A local index is an index that is created on an individual partition of a partitioned table. When you create an index on the parent partitioned table, PostgreSQL automatically creates a separate index for each of its partitions.
- Each local index only covers the data within its specific partition.
- They are implicitly managed as you add or remove partitions.
- This is the most common and often most efficient type of index for partitioned tables.
Creating Local Indexes
Creating a local index is straightforward. You simply create the index on the parent partitioned table. PostgreSQL handles the creation of individual indexes for each child partition automatically.
Try running this example:
CREATE TABLE sensor_data (
id SERIAL,
log_time TIMESTAMPTZ NOT NULL,
value NUMERIC
) PARTITION BY RANGE (log_time);
CREATE TABLE sensor_data_y2023 PARTITION OF sensor_data
FOR VALUES FROM ('2023-01-01 00:00:00') TO ('2024-01-01 00:00:00');
-- This creates local indexes on all current and future partitions
CREATE INDEX idx_sensor_logtime ON sensor_data (log_time);Local Index Advantages
Local indexes shine when queries involve the partition key. Here's why:
- Partition Pruning: PostgreSQL's query planner can quickly identify and scan only the relevant partitions based on your query's `WHERE` clause.
- Smaller Indexes: Each local index is smaller, containing only a subset of the data, leading to faster lookups within a partition.
- Reduced I/O: Less data needs to be read from disk, improving query speed.
Understanding Global Indexes
A global index, unlike a local index, spans across all partitions of a partitioned table. It's a single, monolithic index that acts much like an index on a regular, non-partitioned table.
- It's not tied to any specific partition.
- Updates to any partition affect the single global index.
- They are less common for general query optimization on partitioned tables.
Creating Global Indexes
To create a global index, you typically use the ONLY keyword when specifying the parent table. This tells PostgreSQL to create the index directly on the parent, not implicitly on each child.
Global indexes are often used for enforcing unique constraints across the entire partitioned table on columns that are not the partition key.
Try running this example:
-- Assuming sensor_data is already partitioned
-- Create a unique global index across all partitions
CREATE UNIQUE INDEX idx_sensor_id_global ON ONLY sensor_data (id);Global Index Considerations
While global indexes have their uses, they come with trade-offs:
- Maintenance Overhead: Inserts, updates, or deletes to any partition require updates to the single global index, which can be slower.
- No Partition Pruning Benefit: Queries using a global index don't benefit from partition pruning on the index itself, as it spans all data.
- Use Cases: Best for unique constraints on non-partition key columns, or queries that frequently access non-partition key columns across the entire dataset.
Local vs. Global: When?
Choosing between local and global indexes depends on your workload:
- Local Indexes: Ideal when queries frequently filter data using the partition key (e.g., date ranges, specific categories). They leverage partition pruning for speed.
- Global Indexes: Consider for enforcing unique constraints on columns that are not the partition key, or for queries that frequently access non-partition key columns across the entire table.
Most often, local indexes are the preferred choice for performance on partitioned tables.
Practical Example Scenario
Imagine an orders table partitioned by order_date.
- A local index on
order_datewould be highly efficient for queries likeWHERE order_date BETWEEN X AND Ybecause of partition pruning. - A global index on
customer_idwould be efficient forWHERE customer_id = Zacross all orders, especially if you need to find all orders for a customer regardless of date.
The key is aligning your index strategy with your most common query patterns.
Indexing Partitioned Tables
Consider a large sales table partitioned by sale_date. Which index type is generally more efficient for queries like SELECT * FROM sales WHERE sale_date BETWEEN '2023-01-01' AND '2023-01-31' AND product_id = 123;?
Scaling Indexes Summary
In this lesson, we explored how indexes interact with partitioned tables. You learned about:
- Local indexes: Created per partition, ideal for queries using the partition key, benefiting from partition pruning.
- Global indexes: Span all partitions, useful for unique constraints or queries on non-partition key columns across the whole table, but with more maintenance overhead.
Mastering the interplay between partitioning and indexing is key to unlocking high performance in large-scale PostgreSQL databases.
Frequently asked questions
Is the “Scaling Indexes with Partitioning” lesson free?
Yes — the full text of “Scaling Indexes with Partitioning” is free to read here on the web, and the Advanced PostgreSQL: Indexing, Partitioning, Replication course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Advanced PostgreSQL: Indexing, Partitioning, Replication course, upgrade to CoddyKit PRO.
What will I learn in “Scaling Indexes with Partitioning”?
Learn how indexes interact with partitioned tables and strategies for creating effective local and global indexes. You practise Advanced PostgreSQL: Indexing, Partitioning, Replication with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Advanced PostgreSQL: Indexing, Partitioning, Replication?
No prior experience is required. Advanced PostgreSQL: Indexing, Partitioning, Replication on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Scaling Indexes with Partitioning” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Advanced PostgreSQL: Indexing, Partitioning, Replication lesson?
Yes. Every Advanced PostgreSQL: Indexing, Partitioning, Replication lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Scaling Indexes with Partitioning
- Choosing Index/Partition Strategies
- Real-world Case Studies
- BRIN Indexes for Large Partitioned Tables