WITH clause syntax in PostgreSQL

Introduction

The WITH clause helps you organize complex queries by breaking them into smaller parts. It makes your query easier to read and reuse.

When you want to use the result of a query multiple times in one main query.

When you need to simplify a big query by dividing it into smaller, named steps.

When you want to improve query readability for yourself or others.

When you want to avoid repeating the same subquery in different places.

When you want to prepare data first before using it in the main query.

Syntax

PostgreSQL

WITH cte_name AS (
    subquery
)
SELECT * FROM cte_name;

CTE stands for Common Table Expression, which is a temporary named result set.

You can define multiple CTEs by separating them with commas inside the WITH clause.

Examples

This example creates a CTE named recent_orders that holds orders after January 1, 2024, then selects all from it.

PostgreSQL

WITH recent_orders AS (
    SELECT * FROM orders WHERE order_date > '2024-01-01'
)
SELECT * FROM recent_orders;

This example uses two CTEs: one to sum sales per product, another to get product names, then joins them.

PostgreSQL

WITH sales AS (
    SELECT product_id, SUM(quantity) AS total_sold FROM order_items GROUP BY product_id
),
products AS (
    SELECT id, name FROM products
)
SELECT p.name, s.total_sold
FROM sales s
JOIN products p ON s.product_id = p.id;

Sample Program

This query finds the top 3 customers who spent the most by using a CTE to calculate total spending first.

PostgreSQL

WITH top_customers AS (
    SELECT customer_id, SUM(amount) AS total_spent
    FROM sales
    GROUP BY customer_id
    ORDER BY total_spent DESC
    LIMIT 3
)
SELECT c.customer_id, c.total_spent
FROM top_customers c;

Important Notes

WITH clause queries run the subqueries first, then use their results in the main query.

CTEs are temporary and only exist during the execution of the main query.

Using WITH can improve readability but may not always improve performance.

Summary

WITH clause creates temporary named query results called CTEs.

It helps break complex queries into simpler parts.

You can use multiple CTEs separated by commas.

CTEs make queries easier to read and maintain.

Practice

1. What is the main purpose of the WITH clause in PostgreSQL?

easy

A. To create indexes on columns

B. To permanently store data in a new table

C. To create temporary named query results called CTEs

D. To delete rows from a table

Solution

1. Step 1: Understand the role of WITH clause

   The WITH clause defines Common Table Expressions (CTEs) which are temporary named result sets used within a query.

2. Step 2: Differentiate from other SQL commands

   It does not create permanent tables, delete data, or create indexes; it only helps organize complex queries.

3. Final Answer:

   To create temporary named query results called CTEs -> Option C

4. Quick Check:

   WITH clause = Temporary named queries [OK]

Hint: WITH clause defines temporary named queries (CTEs) [OK]

Common Mistakes:

• Thinking WITH creates permanent tables
• Confusing WITH with DELETE or CREATE INDEX
• Assuming WITH modifies data directly

2. Which of the following is the correct syntax to start a query using a WITH clause in PostgreSQL?

easy

A. WITH cte_name SELECT * FROM table_name AS cte_name;

B. WITH (SELECT * FROM table_name) AS cte_name SELECT * FROM cte_name;

C. WITH cte_name = SELECT * FROM table_name; SELECT * FROM cte_name;

D. WITH cte_name AS (SELECT * FROM table_name) SELECT * FROM cte_name;

Solution

1. Step 1: Recall correct WITH clause syntax

   The correct syntax is: WITH cte_name AS (subquery) followed by the main SELECT using cte_name.

2. Step 2: Check each option

   WITH cte_name AS (SELECT * FROM table_name) SELECT * FROM cte_name; matches the correct syntax. Options A, B, and D have misplaced keywords or wrong order.

3. Final Answer:

   WITH cte_name AS (SELECT * FROM table_name) SELECT * FROM cte_name; -> Option D

4. Quick Check:

   WITH cte_name AS (query) = correct syntax [OK]

Hint: WITH clause uses AS (subquery) syntax [OK]

Common Mistakes:

• Omitting AS keyword
• Placing SELECT before AS
• Using = instead of AS

3. Given the query:

WITH cte AS (SELECT id, name FROM users WHERE active = true) SELECT * FROM cte WHERE id < 5;

What will this query return?

medium

A. All users with id less than 5 regardless of active status

B. All users with active = true and id less than 5

C. All users with active = false and id less than 5

D. Syntax error due to incorrect WHERE clause

Solution

1. Step 1: Analyze the CTE definition

   The CTE named 'cte' selects users where active = true, so only active users are included.

2. Step 2: Analyze the main query filtering

   The main query selects from 'cte' where id < 5, so it filters active users with id less than 5.

3. Final Answer:

   All users with active = true and id less than 5 -> Option B

4. Quick Check:

   CTE filters active=true, main query filters id<5 [OK]

Hint: CTE filters first, main query filters second [OK]

Common Mistakes:

• Ignoring CTE filter and only applying main WHERE
• Assuming all users regardless of active status
• Thinking syntax error due to WHERE

4. Identify the error in the following query:

WITH cte1 AS (SELECT * FROM orders), cte2 (SELECT * FROM customers) SELECT * FROM cte1 JOIN cte2 ON cte1.customer_id = cte2.id;

medium

A. Missing AS keyword before the second CTE's subquery

B. Incorrect JOIN syntax between cte1 and cte2

C. CTEs cannot be used together in one WITH clause

D. SELECT statement missing after WITH clause

Solution

1. Step 1: Check syntax of multiple CTEs

   Multiple CTEs must be separated by commas, each with the syntax: name AS (subquery).

2. Step 2: Identify error in second CTE

   The second CTE 'cte2' is missing the AS keyword before its subquery.

3. Final Answer:

   Missing AS keyword before the second CTE's subquery -> Option A

4. Quick Check:

   Each CTE needs AS (subquery) [OK]

Hint: Each CTE must have AS before its query [OK]

Common Mistakes:

• Omitting AS keyword in CTE definition
• Misplacing commas between CTEs
• Incorrect JOIN syntax confusion

5. You want to write a query that uses two CTEs: one to get all active users, and another to get their orders. Which of the following is the correct way to write this using the WITH clause?

hard

A. WITH active_users AS (SELECT * FROM users WHERE active = true), user_orders AS (SELECT * FROM orders WHERE user_id IN (SELECT id FROM active_users)) SELECT active_users.name, user_orders.order_date FROM active_users JOIN user_orders ON active_users.id = user_orders.user_id;

B. WITH active_users (SELECT * FROM users WHERE active = true), user_orders AS (SELECT * FROM orders WHERE user_id IN (SELECT id FROM active_users)) SELECT * FROM active_users JOIN user_orders ON active_users.id = user_orders.user_id;

C. WITH active_users AS SELECT * FROM users WHERE active = true, user_orders AS (SELECT * FROM orders) SELECT * FROM active_users JOIN user_orders ON active_users.id = user_orders.user_id;

D. WITH active_users AS (SELECT * FROM users WHERE active = true) user_orders AS (SELECT * FROM orders) SELECT * FROM active_users JOIN user_orders ON active_users.id = user_orders.user_id;

Solution

1. Step 1: Verify correct syntax for multiple CTEs

   Multiple CTEs must be separated by commas, each defined as name AS (subquery).

2. Step 2: Check each option's syntax and logic

   WITH active_users AS (SELECT * FROM users WHERE active = true), user_orders AS (SELECT * FROM orders WHERE user_id IN (SELECT id FROM active_users)) SELECT active_users.name, user_orders.order_date FROM active_users JOIN user_orders ON active_users.id = user_orders.user_id; correctly uses AS and commas, and references active_users in user_orders. Options B, C, and D have syntax errors or missing commas.

3. Final Answer:

   WITH active_users AS (SELECT * FROM users WHERE active = true), user_orders AS (SELECT * FROM orders WHERE user_id IN (SELECT id FROM active_users)) SELECT active_users.name, user_orders.order_date FROM active_users JOIN user_orders ON active_users.id = user_orders.user_id; -> Option A

4. Quick Check:

   Multiple CTEs separated by commas with AS (query) [OK]

Hint: Separate multiple CTEs with commas and use AS (query) [OK]

Common Mistakes:

• Missing commas between CTEs
• Omitting AS keyword
• Not referencing CTEs properly in later queries