Updates for cx_Oracle 7 and Oracle Client 18.3 as well as some miscellaneous

tweaks.

Author: anthony-tuininga

samples/tutorial/Python-and-Oracle-Database-12c-Scripting-for-the-Future.html renamed to samples/tutorial/Python-and-Oracle-Database-Scripting-for-the-Future.html

@@ -43,6 +43,8 @@
 cur.execute("insert into testgeometry values (1, :obj)", obj = obj)
 print("Row added!")
 
+# (Change below here)
+
 # Query the row
 print("Querying row just inserted...")
 cur.execute("select id, geometry from testgeometry");

samples/tutorial/bind_sdo.py

@@ -1,5 +1,5 @@
 #------------------------------------------------------------------------------
-# connect.py (Section 1.1 and 1.2)
+# connect.py (Section 1.2 and 1.3)
 #------------------------------------------------------------------------------
 
 #------------------------------------------------------------------------------

samples/tutorial/connect.py

@@ -1,5 +1,5 @@
 -------------------------------------------------------------------------------
--- drcp_query.sql (Section 2.5)
+-- drcp_query.sql (Section 2.4 and 2.5)
 -------------------------------------------------------------------------------
 
 /*-----------------------------------------------------------------------------

samples/tutorial/drcp_query.sql

@@ -1,5 +1,5 @@
 #------------------------------------------------------------------------------
-# query.py (Section 1.3)
+# query.py (Section 1.4 and 1.5)
 #------------------------------------------------------------------------------
 
 #------------------------------------------------------------------------------

samples/tutorial/query.py

@@ -50,6 +50,8 @@
 cur.execute("insert into testgeometry values (1, :objbv)", objbv = obj)
 print("Row added!")
 
+# (Change below here)
+
 # Define a function to dump the contents of an Oracle object
 def dumpobject(obj, prefix = "  "):
     if obj.type.iscollection:

samples/tutorial/solutions/bind_sdo.py

@@ -14,7 +14,8 @@
 import db_config
 
 pool = cx_Oracle.SessionPool(db_config.user, db_config.pw, db_config.dsn + ":pooled",
-                             min = 2, max = 5, increment = 1, threaded = True)
+                             min = 2, max = 5, increment = 1, threaded = True,
+                             getmode = cx_Oracle.SPOOL_ATTRVAL_WAIT)
 
 def Query():
     con = pool.acquire(cclass="PYTHONHOL", purity=cx_Oracle.ATTR_PURITY_SELF)

samples/tutorial/solutions/connect_pool2.py

@@ -1,5 +1,5 @@
 #------------------------------------------------------------------------------
-# query.py (Section 1.4)
+# query.py (Section 1.5)
 #------------------------------------------------------------------------------
 
 #------------------------------------------------------------------------------

samples/tutorial/solutions/query-2.py

@@ -1,5 +1,5 @@
 #------------------------------------------------------------------------------
-# query.py (Section 1.3)
+# query.py (Section 1.4 and 1.5)
 #------------------------------------------------------------------------------
 
 #------------------------------------------------------------------------------

samples/tutorial/solutions/query.py

@@ -0,0 +1,29 @@
+#------------------------------------------------------------------------------
+# query_scroll.py (Section 3.4)
+#------------------------------------------------------------------------------
+
+#------------------------------------------------------------------------------
+# Copyright 2017, 2018, Oracle and/or its affiliates. All rights reserved.
+#------------------------------------------------------------------------------
+
+from __future__ import print_function
+
+import cx_Oracle
+import db_config
+
+con = cx_Oracle.connect(db_config.user, db_config.pw, db_config.dsn)
+cur = con.cursor(scrollable = True)
+
+cur.execute("select * from dept order by deptno")
+
+cur.scroll(2, mode = "absolute")  # go to second row
+print(cur.fetchone())
+
+cur.scroll(-1)                    # go back one row
+print(cur.fetchone())
+
+cur.scroll(1)  # go to next row
+print(cur.fetchone())
+
+cur.scroll(mode = "first")  # go to first row
+print(cur.fetchone())