Question: How do you use the PARTITION OVER clause in PostgreSQL?


The PARTITION BY clause is a part of the window function feature in SQL, used for dividing rows of a query result set into partitions. In PostgreSQL, window functions allow you to perform calculations across a set of table rows that are somehow related to the current row. This is akin to the role of aggregate functions. However, unlike aggregate functions, window functions do not cause rows to become grouped into a single output row — the rows retain their separate identities.

Basic Usage

The syntax generally looks like this:

SELECT column_name, window_function(column_name) OVER ( PARTITION BY column_name ORDER BY column_name ) FROM table_name;
  • window_function: This is the function you're applying to the partition.
  • PARTITION BY: This divides the result set into partitions to which the window function is applied. If not specified, the function treats all rows of the query result set as a single partition.
  • ORDER BY: This is optional and specifies the order in which the rows in a partition are ordered.


Imagine we have a sales table (sales_data) with columns for date, region, and amount. If you wanted to calculate the running total of sales for each region separately, you might use:

SELECT date, region, amount, SUM(amount) OVER ( PARTITION BY region ORDER BY date ) AS running_total FROM sales_data;

This SQL statement will group the data by region due to the PARTITION BY region clause. Within each region, it orders the rows by date and calculates a running total of the amount field.

Use Cases

Window functions, particularly with the PARTITION BY clause, are incredibly useful for a wide range of analytical tasks, such as:

  • Calculating running totals, averages, or other aggregates within a particular group.
  • Assigning rank or row numbers within groups.
  • Analyzing patterns over time within groups.

Understanding and utilizing PARTITION BY can greatly enhance your data analysis capabilities within PostgreSQL, providing nuanced insights into your data without the complexity of subqueries or numerous aggregate groups.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book
Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.