From 64c0218ce2f0273a87ff0502fdc54be8aa837735 Mon Sep 17 00:00:00 2001
From: Mohammad Ammar <theammarngp@gmail.com>
Date: Sat, 4 Jul 2026 22:36:02 +0530
Subject: [PATCH] Create 04_PARTITION_BY.md

---
 07_Window_Functions/04_PARTITION_BY.md | 112 +++++++++++++++++++++++++
 1 file changed, 112 insertions(+)
 create mode 100644 07_Window_Functions/04_PARTITION_BY.md

diff --git a/07_Window_Functions/04_PARTITION_BY.md b/07_Window_Functions/04_PARTITION_BY.md
new file mode 100644
index 0000000..784a5e7
--- /dev/null
+++ b/07_Window_Functions/04_PARTITION_BY.md
@@ -0,0 +1,112 @@
+# PARTITION BY
+
+## Overview
+
+`PARTITION BY` splits the result set into independent groups (partitions)
+**before** a window function is applied. The window function then resets
+and recalculates separately within each partition -- similar in spirit to
+`GROUP BY`, but without collapsing rows.
+
+## Learning Objectives
+
+- Combine `PARTITION BY` with `ROW_NUMBER()`, `RANK()`, `DENSE_RANK()`,
+  and aggregate window functions.
+- Compute per-group metrics (counts, top-N per group) without losing
+  row-level detail.
+- Understand that `PARTITION BY` resets the window function at every
+  partition boundary.
+
+## Prerequisites
+
+- `01_ROW_NUMBER`, `02_RANK`, `03_DENSE_RANK`
+- `03_Joins` (this module joins `employes` to `departments`)
+
+## Syntax
+
+```sql
+SELECT
+    column_a,
+    grouping_column,
+    WINDOW_FUNCTION() OVER (
+        PARTITION BY grouping_column
+        ORDER BY sort_column
+    ) AS result_column
+FROM table_name;
+```
+
+## Dataset Used
+
+`employes` joined to `departments` on `dept_id`
+
+## Examples
+
+See [`04_partition_by.sql`](./04_partition_by.sql).
+
+## Real World Applications
+
+- Top-N products per category.
+- First transaction per customer.
+- Department-wise employee leaderboards.
+
+## Business Use Cases
+
+| Domain | Scenario |
+|---|---|
+| HR | Rank employees within their own department |
+| Retail | Rank products within their own category |
+| Banking | Rank transactions within their own account |
+
+## Common Mistakes
+
+- Forgetting `PARTITION BY` and accidentally computing a global rank
+  instead of a per-group rank.
+- Assuming `PARTITION BY` filters rows -- it does not; it only changes
+  how the window function's calculation is scoped.
+- Joining tables incorrectly and silently duplicating rows before the
+  partition is applied, which corrupts every downstream ranking.
+
+## Best Practices
+
+- Always validate the join first (`SELECT * ...` sanity check) before
+  layering window functions on top -- a bad join silently poisons every
+  rank, count, and running total built afterward.
+- Name partition-scoped aliases clearly (`dept_seq`, not `seq`) so
+  readers instantly know the calculation is per-department.
+
+## Engineering Notes
+
+`PARTITION BY` does not require a separate index from `ORDER BY`, but
+query planners benefit significantly from a composite index on
+`(partition_column, order_column)` for large tables, since it avoids a
+full sort per partition.
+
+## Practice Questions
+
+1. Assign row numbers within each department.
+2. Assign ranks within each department.
+3. Count employees in each department using a window function.
+4. Show the first employee from every department.
+5. Build a full department leaderboard combining `ROW_NUMBER()`,
+   `RANK()`, and `DENSE_RANK()`.
+
+## Difficulty
+
+Intermediate
+
+## Estimated Time
+
+25–30 minutes
+
+## Learning Outcomes
+
+- Confidently combine `JOIN` + `PARTITION BY` + `ORDER BY` in one query.
+- Explain, in an interview, how `PARTITION BY` differs from `GROUP BY`.
+
+## Related Topics
+
+- `02_RANK`, `03_DENSE_RANK`
+- `05_LAG_LEAD`
+
+## Next Topic
+
+[`05_LAG_LEAD`](../05_LAG_LEAD/README.md)