Document update_without_returning and add rc.41 changelog entry

Author: tyt2y3

changelog/2.0.0-rc.41.md

@@ -52,6 +52,15 @@ of both `sea-orm` and `sea-orm-sync`, so default builds are unaffected.
 `default-features = false` builds that do not enable `stream` drop the
 `ouroboros` dependency and hide the streaming APIs.
 
+**Update without returning** (#2965)
+
+New `ActiveModelTrait::update_without_returning`, plus
+`UpdateOne::exec_without_returning` and `ValidatedUpdateOne::exec_without_returning`,
+run an UPDATE without a RETURNING clause and yield an `UpdateResult` instead of
+the updated model — useful on backends without RETURNING or when the updated
+model is not needed. Unlike `update`, it runs `before_save` but skips
+`after_save`, and returns `DbErr::RecordNotUpdated` when no row matches.
+
 ### Bug Fixes
 
 **Schema-sync indexes for non-default PostgreSQL schemas** (#3085, #3084)

sea-orm-sync/src/entity/active_model.rs

@@ -338,8 +338,14 @@ pub trait ActiveModelTrait: Clone + Debug {
         Self::after_save(model, db, false)
     }
 
-    /// Similar to [`update`], but without returning
-    /// It also won't execute [`ActiveModelTrait::after_save`]
+    /// Update an ActiveModel without a RETURNING clause, yielding an
+    /// [`UpdateResult`] instead of the updated model. Useful on backends without
+    /// RETURNING support, or when the updated model is not needed.
+    ///
+    /// Unlike [`ActiveModelTrait::update`], this runs
+    /// [`ActiveModelBehavior::before_save`] but does **not** run
+    /// [`ActiveModelBehavior::after_save`] (there is no returned model to pass to
+    /// it). Returns [`DbErr::RecordNotUpdated`] if no row matches.
     fn update_without_returning<'a, C>(self, db: &'a C) -> Result<UpdateResult, DbErr>
     where
         Self: ActiveModelBehavior,

sea-orm-sync/src/executor/update.rs

@@ -23,7 +23,9 @@ impl<A> ValidatedUpdateOne<A>
 where
     A: ActiveModelTrait,
 {
-    /// Execute an UPDATE operation on an ActiveModel without returning the updated model
+    /// Execute an UPDATE operation without a RETURNING clause, yielding an
+    /// [`UpdateResult`] instead of the updated model. Returns
+    /// [`DbErr::RecordNotUpdated`] if no row matches.
     pub fn exec_without_returning<C>(self, db: &C) -> Result<UpdateResult, DbErr>
     where
         C: ConnectionTrait,
@@ -48,7 +50,9 @@ impl<A> UpdateOne<A>
 where
     A: ActiveModelTrait,
 {
-    /// Execute an UPDATE operation on an ActiveModel without returning the updated model
+    /// Execute an UPDATE operation without a RETURNING clause, yielding an
+    /// [`UpdateResult`] instead of the updated model. Returns
+    /// [`DbErr::RecordNotUpdated`] if no row matches.
     pub fn exec_without_returning<C>(self, db: &C) -> Result<UpdateResult, DbErr>
     where
         C: ConnectionTrait,

src/entity/active_model.rs

@@ -345,8 +345,14 @@ pub trait ActiveModelTrait: Clone + Debug {
         Self::after_save(model, db, false).await
     }
 
-    /// Similar to [`update`], but without returning
-    /// It also won't execute [`ActiveModelTrait::after_save`]
+    /// Update an ActiveModel without a RETURNING clause, yielding an
+    /// [`UpdateResult`] instead of the updated model. Useful on backends without
+    /// RETURNING support, or when the updated model is not needed.
+    ///
+    /// Unlike [`ActiveModelTrait::update`], this runs
+    /// [`ActiveModelBehavior::before_save`] but does **not** run
+    /// [`ActiveModelBehavior::after_save`] (there is no returned model to pass to
+    /// it). Returns [`DbErr::RecordNotUpdated`] if no row matches.
     async fn update_without_returning<'a, C>(self, db: &'a C) -> Result<UpdateResult, DbErr>
     where
         Self: ActiveModelBehavior,

src/executor/update.rs

@@ -23,7 +23,9 @@ impl<A> ValidatedUpdateOne<A>
 where
     A: ActiveModelTrait,
 {
-    /// Execute an UPDATE operation on an ActiveModel without returning the updated model
+    /// Execute an UPDATE operation without a RETURNING clause, yielding an
+    /// [`UpdateResult`] instead of the updated model. Returns
+    /// [`DbErr::RecordNotUpdated`] if no row matches.
     pub async fn exec_without_returning<C>(self, db: &C) -> Result<UpdateResult, DbErr>
     where
         C: ConnectionTrait,
@@ -51,7 +53,9 @@ impl<A> UpdateOne<A>
 where
     A: ActiveModelTrait,
 {
-    /// Execute an UPDATE operation on an ActiveModel without returning the updated model
+    /// Execute an UPDATE operation without a RETURNING clause, yielding an
+    /// [`UpdateResult`] instead of the updated model. Returns
+    /// [`DbErr::RecordNotUpdated`] if no row matches.
     pub async fn exec_without_returning<C>(self, db: &C) -> Result<UpdateResult, DbErr>
     where
         C: ConnectionTrait,