ODPI-C Release notes

Version 2.0.0-rc.1 (June 16, 2017)

  1. OCI requires that both encoding and nencoding have values or that both encoding and encoding do not have values. The missing value is set to its default value if one of the values is set and the other is not (issue 36).
  2. Add optimization when client and server character sets are identical; in that case the size in bytes reported by the server is sufficient to hold the data that will be transferred from the server and there is no need to expand the buffer for character strings.
  3. Corrected handling of BFILE LOBs.
  4. Eliminated errors and warnings when using AIX compiler.
  5. Documentation improvements.

Version 2.0.0-beta.4 (May 24, 2017)

  1. Added support for getting/setting attributes of objects or element values in collections that contain LOBs, BINARY_FLOAT values, BINARY_DOUBLE values and NCHAR and NVARCHAR2 values. The error message for any types that are not supported has been improved as well.
  2. Enabled temporary LOB caching in order to avoid disk I/O as suggested.
  3. Changed default native type to DPI_ORACLE_TYPE_INT64 if the column metadata indicates that the values are able to fit inside a 64-bit integer.
  4. Added function dpiStmt_defineValue(), which gives the application the opportunity to specify the data type to use for fetching without having to create a variable.
  5. Added constant DPI_DEBUG_LEVEL as a set of bit flags which result in messages being printed to stderr. The following levels are defined:
    • 0x0001 - reports errors during free operations
    • 0x0002 - reports on reference count changes
    • 0x0004 - reports on public function calls
  6. An empty string is just as acceptable as NULL when enabling external authentication in dpiPool_create().
  7. Avoid changing the OCI actual length values for fixed length types in order to prevent error “ORA-01458: invalid length inside variable character string”.
  8. Ensured that the length set in the dpiBytes structure by the caller is passed through to the actual length buffer used by OCI.
  9. Added missing documentation for function dpiVar_setFromBytes().
  10. Handle edge case when an odd number of zeroes trail the decimal point in a value that is effectively zero (cx_Oracle issue 22).
  11. Eliminated resource leak when a standalone connection or pool is freed.
  12. Prevent attempts from binding the cursor being executed to itself.
  13. Corrected determination of unique bind variable names. The function dpiStmt_getBindCount() returns a count of unique bind variable names for PL/SQL statements only. For SQL statements, this count is the total number of bind variables, including duplicates. The function dpiStmt_getBindNames() has been adjusted to return the actual number of unique bind variable names (parameter numBindNames is now a pointer instead of a scalar value).
  14. Added additional test cases.
  15. Added check for Cygwin, as suggested.

Version 2.0.0-beta.3 (April 18, 2017)

  1. Add initial set of functional test cases.
  2. Add support for smallint and float data types in Oracle objects, as requested.
  3. Ensure that the actual array size is set to the number of rows returned in a DML returning statement.
  4. Remove unneeded function dpiVar_resize().
  5. Improve error message when specifying an invalid array position in a variable.
  6. Add structure ODPI-C Public Structure dpiVersionInfo to pass version information, rather than separate parameters. This affects functions dpiContext_getClientVersion() and dpiConn_getServerVersion().
  7. Rename functions that use an index to identify elements in a collection to include “ByIndex” in the name. This is clearer and also allows for functions that may be added in the future that will identify elements by other means. This affects functions dpiObject_deleteElementByIndex(), dpiObject_getElementExistsByIndex(), dpiObject_getElementValueByIndex(), and dpiObject_setElementValueByIndex().
  8. The OCI function OCITypeByFullName() is supported on a 12.1 Oracle Client but will give the error “OCI-22351: This API is not supported by the ORACLE server” when used against an 11.2 Oracle Database. The function dpiConn_getObjectType() now checks the server version and calls the correct routine as needed.
  9. Add parameter “exists” to functions dpiObject_getFirstIndex() and dpiObject_getLastIndex() which allow a calling program to avoid error “OCI-22166: collection is empty”.

Version 2.0.0-beta.2 (March 28, 2017)

  1. Use dynamic loading at runtime to load the OCI library and eliminate the need for the OCI header files to be present when building ODPI-C.
  2. Improve sample Makefile as requested in issue 1.
  3. Correct support for handling unsigned integers that are larger than the maximum size that can be represented by a signed integer. This corrects issue 3.
  4. Remove type DPI_ORACLE_TYPE_LONG_NVARCHAR which is not needed as noted in issue 5.
  5. Increase size of string which can be generated from an OCI number. This corrects issue 6.
  6. Ensure that zeroing the check integer on ODPI-C handles is not optimised away by the compiler.
  7. Silence compiler warnings from the Microsoft C++ compiler.
  8. Restore support for simple reference count tracing by the use of DPI_TRACE_REFS.
  9. Add additional error (ORA-56600: an illegal OCI function call was issued) to the list of errors that cause the session to be dropped from the session pool.
  10. Changed LOB sample to include code to populate both CLOBs and BLOBs in addition to fetching them.

Version 2.0.0-beta.1 (January 30, 2017)

  1. Initial release supporting the following features:
    • 11.2, 12.1 and 12.2 Oracle Client support
    • 9.2 and higher Oracle Database support (depending on Oracle Client version)
    • SQL and PL/SQL execution
    • Character datatypes (CHAR, VARCHAR2, NCHAR, NVARCHAR2, CLOB, NCLOB, LONG)
    • Numeric datatypes (NUMBER, BINARY_FLOAT, BINARY_DOUBLE)
    • Dates, Timestamps, Intervals
    • Binary types (BLOB, BFILE, RAW, LONG RAW)
    • PL/SQL datatypes (PLS_INTEGER, BOOLEAN, Collections, Records)
    • JSON
    • User Defined Types
    • REF CURSOR, Nested cursors, Implicit Result Sets
    • Array fetch
    • Array bind/execute
    • Session pools (homogeneous and non-homogeneous with proxy authentication)
    • Standalone connections
    • Database Resident Connection Pooling (DRCP)
    • External authentication
    • Statement caching (tagging)
    • End-to-end tracing, mid-tier authentication and auditing (action, module, client identifier, client info, database operation)
    • Edition Based Redefinition
    • Scrollable cursors
    • DML RETURNING
    • Privileged connection support (SYSDBA, SYSOPER, SYSASM, PRELIM_AUTH)
    • Database Startup/Shutdown
    • Session Tagging
    • Proxy authentication
    • Batch Errors
    • Array DML Row Counts
    • Query Result Caching
    • Application Continuity (with some limitations)
    • Query Metadata
    • Password Change
    • Two Phase Commit
    • OCI Client Version and Server Version
    • Connection Validation (when acquired from session pool or DRCP)
    • Continuous Query Notification
    • Advanced Queuing
    • Easily extensible (via direct OCI calls)