Doc updates.

Author: anthony-tuininga

doc/src/user_guide/aq.rst

@@ -43,9 +43,13 @@ types which are detailed below.
       - Supported for single and array message enqueuing and dequeuing when using Oracle Client 19c (or later) and connected to Oracle Database 19c (or later).
     * - JSON
       - Supported when using Oracle Database 21c (or later). In python-oracle Thick mode, Oracle Client libraries 21c (or later) are also needed.
+
+        Buffered messaging using the :data:`~oracledb.MSG_BUFFERED` delivery mode is not supported for JSON payloads.
       - Supported for single message enqueuing and dequeuing when using Oracle Client libraries 21c (or later) and Oracle Database 21c (or later).
 
         Array enqueuing and dequeuing is not supported for JSON payloads.
+
+        Buffered messaging using the :data:`~oracledb.MSG_BUFFERED` delivery mode is not supported for JSON payloads.
     * - JMS
       - Supported
       - Supported for single and array message enqueuing and dequeuing when using Oracle Client 19 (or later) and Oracle Database version 23 (or later).

src/oracledb/__init__.py

@@ -734,7 +734,7 @@
 needs to be created prior to enqueuing buffered messages.
 
 This mode is not supported for bulk array operations in python-oracledb Thick
-mode.
+mode, and for JSON payloads.
 """
 
 MSG_PERSISTENT: int = constants.MSG_PERSISTENT

src/oracledb/aq.py

@@ -326,6 +326,9 @@ def deliverymode(self) -> int:
         :data:`~oracledb.MSG_PERSISTENT` (default),
         :data:`~oracledb.MSG_BUFFERED`, or
         :data:`~oracledb.MSG_PERSISTENT_OR_BUFFERED`.
+
+        Note that :data:`~oracledb.MSG_BUFFERED` is not supported for JSON
+        payloads.
         """
         raise AttributeError("deliverymode can only be written")
 
@@ -435,6 +438,9 @@ def deliverymode(self) -> int:
         enqueued. It should be one of the values
         :data:`~oracledb.MSG_PERSISTENT` (default) or
         :data:`~oracledb.MSG_BUFFERED`.
+
+        Note that :data:`~oracledb.MSG_BUFFERED` is not supported for JSON
+        payloads.
         """
         raise AttributeError("deliverymode can only be written")