Interpreting Plan Nodes
Learn to decipher common plan nodes like sequential scans, index scans, join types, and sorts.
Interpreting Plan Nodes is a free PostgreSQL Performance & Query Optimization lesson on CoddyKit — lesson 2 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 PostgreSQL Performance & Query Optimization learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Decoding Query Plans
Welcome back! In the previous lesson, you learned how to use EXPLAIN to view a query's execution plan. Now, let's dive into interpreting the different 'nodes' within these plans.
Each node represents a specific operation PostgreSQL performs. Understanding them is key to identifying performance bottlenecks.
What are Plan Nodes?
Think of a query plan as a tree, where each branch and leaf is a 'node'. These nodes tell you:
- What operation is being done (e.g., scanning, sorting, joining).
- How it's being done (e.g., sequentially, using an index).
- Cost estimates: How much time and resources PostgreSQL *expects* the operation to take.
We'll look at the most common and important node types.
Sequential Scan: The Full Read
A Sequential Scan (often called a 'Seq Scan') means PostgreSQL reads every single row in a table from start to finish to find the data it needs.
- When it happens: For small tables, or when querying a large portion of a table with no suitable index.
- Performance impact: Can be slow for large tables, especially if only a few rows are needed.
It's like looking through every page of a book to find one sentence.
Seq Scan Example
Let's see a sequential scan in action. We'll create a simple table and then query it without an index.
CREATE TABLE products (
product_id SERIAL PRIMARY KEY,
name VARCHAR(100),
price DECIMAL(10, 2)
);
INSERT INTO products (name, price) VALUES
('Laptop', 1200.00),
('Mouse', 25.00),
('Keyboard', 75.00),
('Monitor', 300.00);
EXPLAIN SELECT * FROM products WHERE price > 100;Index Scan: Targeted Search
An Index Scan is much more efficient. PostgreSQL uses an index to quickly locate the specific rows it needs, much like using an index in a book.
- When it happens: When a query uses a
WHEREclause on an indexed column, and the index is selective enough. - Performance impact: Generally much faster than a sequential scan for selective queries on large tables.
It allows PostgreSQL to jump directly to the relevant data pages.
Index Scan Example
Now, let's add an index to our products table and observe the change in the query plan.
CREATE INDEX idx_products_price ON products (price);
EXPLAIN SELECT * FROM products WHERE price > 100;Sort Node: Ordering Data
The Sort node appears when PostgreSQL needs to order data, typically for an ORDER BY or GROUP BY clause, and there isn't an index that can provide the data in the required order.
- When it happens: Explicit
ORDER BY, or implicitly for some operations likeGROUP BYor unique constraints. - Performance impact: Sorting can be CPU and I/O intensive, especially for large datasets.
If the sort happens 'on disk' (meaning it can't fit in memory), it becomes even slower.
Sort Node Example
Here's an example where PostgreSQL has to sort the results because no index exists for the ordering column.
EXPLAIN SELECT name, price FROM products ORDER BY name DESC;Join Nodes: Combining Tables
When you join two or more tables, PostgreSQL uses specific Join Nodes to combine the data. There are three primary types:
- Nested Loop Join: Often good for small inner tables or when an index is available.
- Hash Join: Efficient for larger tables where no useful index is present on the join key.
- Merge Join: Requires both inputs to be sorted on the join key, then merges them.
The choice depends on table sizes, available indexes, and data distribution.
Nested Loop Join Example
Let's create another table and then join it with products to see a Nested Loop Join. This often happens when one side of the join is small.
CREATE TABLE orders (
order_id SERIAL PRIMARY KEY,
product_id INT,
quantity INT
);
INSERT INTO orders (product_id, quantity) VALUES
(1, 1),
(2, 2),
(1, 3);
EXPLAIN SELECT p.name, o.quantity
FROM products p JOIN orders o ON p.product_id = o.product_id
WHERE o.order_id = 2;Identify the Scan Type
Consider the following query and its execution plan snippet. What kind of scan is most likely being performed on the customers table?
EXPLAIN SELECT * FROM customers WHERE age > 30;
Partial Plan Output (assume no index on age):
-> Seq Scan on customers (cost=0.00..10.50 rows=3 width=...)Recap: Decoding Plan Nodes
You've taken a big step in understanding PostgreSQL performance by learning to interpret key plan nodes!
- Sequential Scan: Full table read, can be slow for large tables.
- Index Scan: Uses an index for targeted row access, faster for selective queries.
- Sort: Occurs when data needs ordering and no suitable index exists.
- Join Nodes: (Nested Loop, Hash, Merge) combine data from multiple tables, chosen based on data size and indexes.
In the next lesson, we'll put this knowledge to use to identify actual performance bottlenecks!
Frequently asked questions
Is the “Interpreting Plan Nodes” lesson free?
Yes — the full text of “Interpreting Plan Nodes” is free to read here on the web, and the PostgreSQL Performance & Query Optimization 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 PostgreSQL Performance & Query Optimization course, upgrade to CoddyKit PRO.
What will I learn in “Interpreting Plan Nodes”?
Learn to decipher common plan nodes like sequential scans, index scans, join types, and sorts. You practise PostgreSQL Performance & Query Optimization 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 PostgreSQL Performance & Query Optimization?
No prior experience is required. PostgreSQL Performance & Query Optimization on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Interpreting Plan Nodes” 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 PostgreSQL Performance & Query Optimization lesson?
Yes. Every PostgreSQL Performance & Query Optimization 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.