Overview
The JDBC driver for Oracle in the Oracle Snap Pack is upgraded from OJDBC6 JAR (11.2.0.4 version) to OJDBC10 JAR (19.20.0.0 version). As part of this upgrade, the 19.20.0.0 JDBC driver is bundled with the Oracle Snap Pack as the default JDBC driver.
Behavior Changes
This driver upgrade has resulted in specific behavior changes within the Snap Pack. These changes are related to status codes and success and failure messages. This table lists these changes:
Scenario in Oracle Snaps | Error from the Old Oracle Driver | Error after the Oracle Driver and JOOQ upgrade |
Oracle - Insert: For the insert operation, when you enter a string value instead of an integer in a numeric column. | Error Message: SQL operation failed. Reason: Resolution: Please check for valid Snap properties and input data. | Error Message: Reason: Resolution: <Please address the reported issue.> Aravind Koonapureddy (Deactivated) - Can you update the resolution for this msg as follows: |
Oracle - Execute, Oracle - Insert, and Oracle - Merge: When the execute, insert, and merge operations are successful. | Status: " Message: | Status: Message: |
Oracle - Delete, Oracle - Insert, Oracle - Execute, and Oracle - Update: When the delete, insert, update, and execute operations are successful. | Status: " Message: | Status: Message: |
Oracle - Insert: When the insert operation fails.
| ||
Case 1: Insert batch records into non-null column type- one record specified with null value to fail and route to error view. | Case 1: The errors are the same in both drivers, but the reason is repeated twice in older drivers. | |
Oracle - Execute and Oracle - Insert: Batch operation when Auto commit checkbox is Selected.
| Error: In the old version, when an error record occurs during a batch operation, the entire batch fails, and records are redirected to the error view. As a result, no records are inserted into the database. | Error: In the new version, if there is an error record in the batch operation, the records before the problematic one are inserted into the database, while the records after it are routed to the error view. Records are inserted into the table because the Auto-commit checkbox is selected. |
Oracle - Execute and Oracle - Insert: Auto Commit checkbox is Deselected. | Error: In the old version, when an error record occurs during a batch operation, the entire batch fails and records are redirected to the error view. As a result, no records are inserted into the database. | Error: In the new version, if there is an error record in the batch operation, the records before the problematic one are inserted into the database, while the records after it are routed to the error view. Records are not inserted into the table because the Auto-commit checkbox is deselected. |
Displays data type as | New driver displays data type as | |
Oracle - Execute: Insert operation | When you pass a spl character( ' ):
|
|
Delete_Condition contains special characters:
|
|
FAQ for Upgrading from Oracle JDBC 11.2.0.4 Driver to 19.20.0.0 Driver
What is happening?
The Oracle JDBC Driver is upgraded from OJDBC6 JAR (11.2.0.4 version) to the OJDBC10 JAR (19.20.0.0 version). The OJDBC10 JAR is bundled with the Oracle Snap Pack as the default driver.
Why are we upgrading the Oracle driver?
The decision to upgrade the Oracle JDBC driver from version 11.2.0.4 to 19.20.0.0 is made to improve security, performance, stability, and reliability. Oracle Database 19c offers significant enhancements, bug fixes, and new features unavailable in the 11g version. Upgrading to 19.20.0.0 ensures continued support and compatibility with modern systems and provides a more efficient and secure database environment.
What is the timeline for this upgrade?
This upgrade is available as a stable upgrade for November 8, 2023, while you can have an early preview available shortly after the August 2023 GA release.
Will I be impacted?
If you are using the default version, you will be impacted. The impact may be minimal if you utilize the latest driver or a higher version than 19c.
Do I need to reconfigure my accounts?
You do not have to reconfigure your account settings or drivers; the account can remain as-is to work with the latest driver. However, if you currently use the default version and wish to revert to the previous version behavior, we recommend you to use the OJDBC6 JAR.
How do you override the behavior changes?
Use the OJDBC6 JAR from the 11.2.0.4 version to maintain the same behavior as before the driver upgrade.