reference
Common Table Expression in SQL
Use common table expression when the query intent matches its syntax, row-grain behavior, and PostgreSQL edge cases. This reference gives a minimal example, realistic example, output, mistakes, and next lessons.
Syntax signature
Common table expression solves a specific SQL task. Use it only when its row behavior matches the output contract.
Syntax signature: SELECT expression FROM table WHERE predicate ORDER BY stable_key
SELECT column_name FROM table_name WHERE condition ORDER BY stable_key;What it does and when to use it
Use common table expression when the query task needs this construct's specific row behavior, not because a keyword looks familiar.
Choose it only after naming the input grain, output grain, and whether filtering, grouping, ordering, or mutation semantics happen before or after the construct.
Plan about 10 minutes to read the syntax, compare the examples, and follow the related lesson link before practicing in the app.
Minimal example
The minimal example shows the smallest useful shape before dataset-specific details are added.
SELECT column_name FROM table_name WHERE condition ORDER BY stable_key;Realistic example and output
This example is small enough to audit by eye and mirrors the style used by the SQL Trail checker.
SELECT product_id, product_name FROM products WHERE status = 'active' ORDER BY product_id;| evidence | meaning |
|---|---|
| grain | one row per requested entity |
| edge case | nulls, ties, or duplicates stay explicit |
Behavior notes
Null behavior: decide whether common table expression keeps, removes, groups, compares, or ignores NULL values before trusting the visible output.
Type behavior: check whether common table expression preserves the expected data type or needs an explicit cast in PostgreSQL.
Ordering behavior: add deterministic ORDER BY or tie-breaker columns whenever common table expression can otherwise produce unstable presentation.
Cardinality behavior: confirm whether common table expression preserves one row per input, multiplies rows, collapses rows, or returns one row per group.
PostgreSQL-specific notes are linked to authoritative PostgreSQL documentation when syntax or semantics are dialect-specific.
Common errors and related resources
Learners often use common table expression correctly on the visible rows but miss null policy, tie handling, or the difference between filtering before and after aggregation.
When a PostgreSQL behavior is dialect-specific, SQL Trail links to the official documentation instead of inventing portability claims.