Refine performance requirements on derived delete queries.

Closes spring-projects#3177
quaff · Jan 31, 2025 · 8571056 · 8571056
1 parent f9e04c5
commit 8571056
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/src/main/antora/modules/ROOT/pages/jpa/query-methods.adoc b/src/main/antora/modules/ROOT/pages/jpa/query-methods.adoc
@@ -629,6 +629,9 @@ To make sure lifecycle queries are actually invoked, an invocation of `deleteByR
 
 In fact, a derived delete query is a shortcut for running the query and then calling `CrudRepository.delete(Iterable<User> users)` on the result and keeping behavior in sync with the implementations of other `delete(…)` methods in `CrudRepository`.
 
+NOTE: When deleting a lot of objects you will need to consider the performance implications to ensure sufficient memory availability.
+All resulting objects are loaded into memory before being deleted and are held in the session until flushing or completing the transaction.
+
 [[jpa.query-hints]]
 == Applying Query Hints
 To apply JPA query hints to the queries declared in your repository interface, you can use the `@QueryHints` annotation. It takes an array of JPA `@QueryHint` annotations plus a boolean flag to potentially disable the hints applied to the additional count query triggered when applying pagination, as shown in the following example: