Error "DPY-2068: scroll operation is not supported on a non-scrollable

cursor" is now raised when using the Cursor.scroll() method on a
non-scrollable cursor.

Author: anthony-tuininga

doc/src/release_notes.rst

@@ -34,6 +34,9 @@ Common Changes
 #)  Fixed bug that caused ``ORA-03137: malformed TTC packet from client
     rejected`` exception to be raised when attempting to call
     :meth:`Cursor.parse()` on a scrollable cursor.
+#)  Error ``DPY-2068: scroll operation is not supported on a non-scrollable
+    cursor`` is now raised when using :meth:`Cursor.scroll()` method on a
+    non-scrollable cursor.
 
 
 oracledb `3.4.0 <https://github.com/oracle/python-oracledb/compare/v3.3.0...v3.4.0>`__ (October 2025)

src/oracledb/cursor.py

@@ -1034,6 +1034,8 @@ def scroll(self, value: int = 0, mode: str = "relative") -> None:
         scroll operation would position the cursor outside of the result set.
         """
         self._verify_open()
+        if not self._impl.scrollable:
+            errors._raise_err(errors.ERR_SCROLL_NOT_SUPPORTED)
         self._impl.scroll(self, value, mode)
 
 
@@ -1366,4 +1368,6 @@ async def scroll(self, value: int = 0, mode: str = "relative") -> None:
         scroll operation would position the cursor outside of the result set.
         """
         self._verify_open()
+        if not self._impl.scrollable:
+            errors._raise_err(errors.ERR_SCROLL_NOT_SUPPORTED)
         await self._impl.scroll(self, value, mode)

src/oracledb/errors.py

@@ -291,6 +291,7 @@ def _raise_not_supported(feature: str) -> None:
 ERR_ARROW_SPARSE_VECTOR_NOT_ALLOWED = 2065
 ERR_EMPTY_STATEMENT = 2066
 ERR_WRONG_DIRECT_PATH_DATA_TYPE = 2067
+ERR_SCROLL_NOT_SUPPORTED = 2068
 
 # error numbers that result in NotSupportedError
 ERR_TIME_NOT_SUPPORTED = 3000
@@ -894,6 +895,9 @@ def _raise_not_supported(feature: str) -> None:
     ERR_PYTHON_VALUE_NOT_SUPPORTED: (
         'Python value of type "{type_name}" is not supported'
     ),
+    ERR_SCROLL_NOT_SUPPORTED: (
+        "scroll operation is not supported on a non-scrollable cursor"
+    ),
     ERR_SCROLL_OUT_OF_RESULT_SET: (
         "scroll operation would go out of the result set"
     ),

tests/test_4200_cursor_scrollable.py

@@ -265,3 +265,11 @@ def test_4216(conn):
     cursor.scroll(mode="last")
     (fetched_value,) = cursor.fetchone()
     assert fetched_value == base_value + 3
+
+
+def test_4217(conn, test_env):
+    "4217 - test calling scroll() on a non-scrollable cursor"
+    cursor = conn.cursor()
+    cursor.execute("select NumberCol from TestNumbers order by IntCol")
+    with test_env.assert_raises_full_code("DPY-2068"):
+        cursor.scroll(mode="first")

tests/test_8600_cursor_scrollable_async.py

@@ -268,3 +268,11 @@ async def test_8616(async_conn):
     await cursor.scroll(mode="last")
     (fetched_value,) = await cursor.fetchone()
     assert fetched_value == base_value + 3
+
+
+async def test_8617(async_conn, test_env):
+    "8717 - test calling scroll() on a non-scrollable cursor"
+    cursor = async_conn.cursor()
+    await cursor.execute("select NumberCol from TestNumbers order by IntCol")
+    with test_env.assert_raises_full_code("DPY-2068"):
+        await cursor.scroll(mode="first")