From de4c6abd162a54833f85c12c7adeaecf99d43076 Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Fri, 10 Sep 2021 13:56:11 +0900
Subject: [PATCH] docs: add session table change for upgrade

---
 .../source/installation/upgrade_420.rst         | 17 ++++++++++++++++-
 .../source/installation/upgrading.rst           |  1 +
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/user_guide_src/source/installation/upgrade_420.rst b/user_guide_src/source/installation/upgrade_420.rst
index a306b4978347..cfbcbdbf1aeb 100644
--- a/user_guide_src/source/installation/upgrade_420.rst
+++ b/user_guide_src/source/installation/upgrade_420.rst
@@ -1,5 +1,5 @@
 #############################
-Upgrading from 4.1.3 to 4.2.0
+Upgrading from 4.1.4 to 4.2.0
 #############################
 
 **Changes for set() method in BaseBuilder and Model class**
@@ -10,3 +10,18 @@ and modified the ``set()`` method, then you need to change its definition from
 ``public function set($key, ?string $value = '', ?bool $escape = null)`` to
 ``public function set($key, $value = '', ?bool $escape = null)``.
 
+**Session DatabaseHandler's database table change**
+
+The types of the following columns in the session table have been changed for optimization.
+
+- MySQL
+    - ``timestamp``
+- PostgreSQL
+    - ``ip_address``
+    - ``timestamp``
+    - ``data``
+
+Update the definition of the session table. See the :doc:`/libraries/sessions` for the new definition.
+
+The change was introduced in v4.1.2. But due to `a bug <https://github.com/codeigniter4/CodeIgniter4/issues/4807>`_,
+the DatabaseHandler Driver did not work properly.
diff --git a/user_guide_src/source/installation/upgrading.rst b/user_guide_src/source/installation/upgrading.rst
index 64696e691dc7..b6ef428e8b47 100644
--- a/user_guide_src/source/installation/upgrading.rst
+++ b/user_guide_src/source/installation/upgrading.rst
@@ -8,6 +8,7 @@ upgrading from.
 .. toctree::
     :titlesonly:
 
+    Upgrading from 4.1.4 to 4.2.0 <upgrade_420>
     Upgrading from 4.1.3 to 4.1.4 <upgrade_414>
     Upgrading from 4.1.2 to 4.1.3 <upgrade_413>
     Upgrading from 4.1.1 to 4.1.2 <upgrade_412>