diff --git a/reference/en/modules/batch.xml b/reference/en/modules/batch.xml
index e9a6a3d8e7..57b437e6d4 100755
--- a/reference/en/modules/batch.xml
+++ b/reference/en/modules/batch.xml
@@ -95,4 +95,98 @@ session.close();]]>
+
+ Bulk update/delete
+
+
+ As already discussed, automatic and transparent object/relational mapping is concerned
+ with the management of object state. This implies that the object state is available
+ in memory, hence updating or deleting (using SQL UPDATE and
+ DELETE) data directly in the database will not affect in-memory
+ state. However, Hibernate provides methods for bulk SQL-style UPDATE
+ and DELETE statement execution which are performed through the
+ Hibernate Query Language (HQL).
+
+
+
+ The psuedo-syntax for UPDATE and DELETE statements
+ is: ( UPDATE | DELETE ) FROM? ClassName (WHERE WHERE_CONDITIONS)?. Some
+ points to note:
+
+
+
+
+
+ In the from-clause, the FROM keyword is optional
+
+
+
+
+ There can only be a single class named in the from-clause, and it cannot
+ have an alias.
+
+
+
+
+ No joins (either implicit or explicit) can be specified in a bulk HQL query. Sub-queries
+ may be used in the where-clause.
+
+
+
+
+ The where-clause is also optional.
+
+
+
+
+
+ As an example, to execute an HQL UPDATE, use the
+ Query.executeUpdate() method:
+
+
+
+
+
+ To execute an HQL DELETE, use the same Query.executeUpdate()
+ method (the method is named for those familiar with JDBC's
+ PreparedStatement.executeUpdate()):
+
+
+
+
+
+ The int value returned by the Query.executeUpdate()
+ method indicate the number of entities effected by the operation. Consider this may or may not
+ correlate to the number of rows effected in the database. An HQL bulk operation might result in
+ multiple actual SQL statements being executed, for joined-subclass, for example. The returned
+ number indicates the number of actual entities affected by the statement. Going back to the
+ example of joined-subclass, a delete against one of the subclasses may actually result
+ in deletes against not just the table to which that subclass is mapped, but also the "root"
+ table and potentially joined-subclass tables further down the inheritence hierarchy.
+
+
+
+ Note that there are currently a few limitations with the bulk HQL operations which
+ will be addressed in future releases; consult the JIRA roadmap for details.
+
+
+
+
diff --git a/reference/en/modules/query_hql.xml b/reference/en/modules/query_hql.xml
index 8754af0bfe..7aa9d5cc93 100644
--- a/reference/en/modules/query_hql.xml
+++ b/reference/en/modules/query_hql.xml
@@ -970,6 +970,15 @@ order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>
+
+ Bulk UPDATE & DELETE Statements
+
+
+ HQL now supports UPDATE and DELETE statements in HQL. See
+ for details.
+
+
+
Tips & Tricks