Question: How can I limit the number of rows updated in a PostgreSQL query?


PostgreSQL, unlike some other SQL databases, does not directly support the LIMIT clause in an UPDATE statement for limiting the number of rows updated. However, you can achieve a similar effect by using a subquery with the WHERE clause or by leveraging common table expressions (CTEs) with the RETURNING clause.

Option 1: Using Subquery with WHERE Clause

You can use a subquery within the WHERE clause to specify which rows to update, effectively limiting the number of rows that get updated. This approach works well when you can identify rows by some unique criteria.

UPDATE your_table SET column_to_update = 'new_value' WHERE id IN ( SELECT id FROM your_table WHERE condition = true -- Your specific condition here ORDER BY some_column LIMIT 10 );

In the example above, replace your_table, column_to_update, condition, and some_column with your actual table name, column you wish to update, the condition that identifies the rows, and the column you want to use for sorting before applying the limit, respectively.

Option 2: Using Common Table Expressions (CTEs)

Common Table Expressions can be used to perform more complex operations and neatly structure your queries. They are especially useful when the operation involves multiple steps or when you want to update rows based on their relationship with another table.

WITH cte AS ( SELECT id FROM your_table WHERE condition = true -- Your specific condition here ORDER BY some_column LIMIT 10 ) UPDATE your_table SET column_to_update = 'new_value' FROM cte WHERE =;

Here, we first select the rows that should be updated using a CTE and then perform the update based on the result of this CTE. This method provides a clean and readable way to update a limited number of rows based on complex conditions or relationships.

Note on Performance

When applying these methods, especially in databases with large datasets, it's important to ensure that your subquery or CTE is optimized for performance. Making use of indexes on columns involved in filtering (WHERE clause) and ordering (ORDER BY clause) can significantly impact the execution time of your queries.

Remember, while PostgreSQL doesn't support the LIMIT clause directly in UPDATE statements, these workarounds provide flexible and powerful ways to update a controlled number of rows in your database.

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.