Add change log and documentation

Author: sclubricants

user_guide_src/source/changelogs/v4.3.0.rst

@@ -109,6 +109,7 @@ Model
 - Added before and after events to ``BaseModel::insertBatch()`` and ``BaseModel::updateBatch()`` methods. See :ref:`model-events-callbacks`.
 - Added ``Model::allowEmptyInserts()`` method to insert empty data. See :ref:`Using CodeIgniter's Model <model-allow-empty-inserts>`
 - Added new :ref:`entities-property-casting` class ``IntBoolCast`` for Entity.
+- Improved the SQL structure for ``Builder::updateBatch()``. See :ref:`update-batch` for the details.
 
 Libraries
 =========

user_guide_src/source/database/query_builder.rst

@@ -939,6 +939,8 @@ Or as an array:
 You may also use the ``$builder->set()`` method described above when
 performing updates.
 
+.. _update-batch:
+
 UpdateBatch
 ===========
 

user_guide_src/source/database/query_builder/092.php

@@ -2,27 +2,28 @@
 
 $data = [
     [
-        'title' => 'My title',
-        'name'  => 'My Name 2',
-        'date'  => 'My date 2',
+        'title' => 'Title 1',
+        'name'  => 'Name 1',
+        'date'  => 'Date 1',
     ],
     [
-        'title' => 'Another title',
-        'name'  => 'Another Name 2',
-        'date'  => 'Another date 2',
+        'title' => 'Title 2',
+        'name'  => 'Name 2',
+        'date'  => 'Date 2',
     ],
 ];
 
 $builder->updateBatch($data, 'title');
 /*
  * Produces:
- * UPDATE `mytable` SET `name` = CASE
- * WHEN `title` = 'My title' THEN 'My Name 2'
- * WHEN `title` = 'Another title' THEN 'Another Name 2'
- * ELSE `name` END,
- * `date` = CASE
- * WHEN `title` = 'My title' THEN 'My date 2'
- * WHEN `title` = 'Another title' THEN 'Another date 2'
- * ELSE `date` END
- * WHERE `title` IN ('My title','Another title')
+ * UPDATE `mytable`
+ * INNER JOIN (
+ * SELECT 'Title 1' `title`, 'Name 1' `name`, 'Date 1' `date` UNION ALL
+ * SELECT 'Title 2' `title`, 'Name 2' `name`, 'Date 2' `date`
+ * ) u
+ * ON `mytable`.`title` = u.`title`
+ * SET
+ * `mytable`.`title` = u.`title`,
+ * `mytable`.`name` = u.`name`,
+ * `mytable`.`date` = u.`date`
  */