OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase Connector/J

V2.4.19
  • What is OceanBase Connector J?
    • Overview of OceanBase Connector/J
    • Compatibility requirements
  • Install Driver
    • Install and load OceanBase Connector/J
  • Instructions
    • Quick start
      • Import packages
      • Establish a database connection
      • Create a Statement object
      • Run queries and retrieve ResultSet objects
      • Process ResultSet objects
      • Close ResultSet and Statement objects
      • Manage tables and data
      • Commit changes
      • Close a database connection
      • Examples
    • Data sources and URL
      • Data source overview
      • Database URL
      • clientInfoProvider
    • Java data streams
      • Overview of Java data streams
      • LONG and LONG RAW data types
      • Use LOBs
        • Overview of LOB data types
        • LOB data interface
        • LOB locator interface
      • CHAR, VARCHAR, and RAW data types
    • Statement caching
      • Overview of statement caching
      • Use statement caching
      • Reuse statement objects
    • Call a stored procedure
    • Handle SQL exceptions
    • Result set
      • Overview of result sets
      • Limitations
      • FetchSize
      • refreshRow
      • useCursorFetch
    • Batch processing
    • Failover and Load-Balancing
      • Failover and load balancing modes
      • LoadBalance strategies
      • Load balancing strategy configuration methods
      • Replication mode
    • Rich client
    • Logging
    • Network overheads
    • Show Trace
    • Security features
    • Troubleshooting
  • Reference
    • Features specific to the Oracle mode
      • Binary Protocol (Prepared Statements)
        • COM_STMT_PREPARE_EXECUTE
        • COM_STMT_SEND_PIECE_DATA
      • Call PL stored procedures
      • Scrollability of a result set
      • Use ARRAY and STRUCT classes
      • Distributed transactions
        • Overview
        • XA components
        • Distributed transaction examples
      • Obtain remarks
      • Data types supported in Oracle mode
      • Error messages in Oracle mode
    • Supported SQL and PL data types
    • Common APIs
      • Overview
      • java.sql.Connection
      • java.sql.CallableStatement
      • java.sql.DatabaseMetaData
      • java.sql.Driver
      • java.sql.PreparedStatement
      • java.sql.ParameterMetaData
      • java.sql.ResultSet
      • java.sql.ResultSetMetaData
      • java.sql.Statement
      • javax.sql.ConnectionPoolDataSource
      • javax.naming.Context
      • javax.sql.PooledConnection
      • com.oceanbase.jdbc.ObPrepareStatement
    • Behavior differences between JDBC strict compatibility mode and non-strict compatibility mode
  • Release Notes
    • V2.4
      • OceanBase Connector/J V2.4.19
      • OceanBase Connector/J V2.4.18
      • OceanBase Connector/J V2.4.17
      • OceanBase Connector/J V2.4.16
      • OceanBase Connector/J V2.4.15
      • OceanBase Connector/J V2.4.14
      • OceanBase Connector/J V2.4.13
      • OceanBase Connector/J V2.4.12
      • OceanBase Connector/J V2.4.11
      • OceanBase Connector/J V2.4.8
      • OceanBase Connector/J V2.4.5
      • OceanBase Connector/J V2.4.4
      • OceanBase Connector/J V2.4.3
      • OceanBase Connector/J V2.4.2
      • OceanBase Connector/J V2.4.1
      • OceanBase Connector/J V2.4.0
    • V2.2
      • OceanBase Connector/J V2.2.11
      • OceanBase Connector/J V2.2.10
      • OceanBase Connector/J V2.2.7
      • OceanBase Connector/J V2.2.6
      • OceanBase Connector/J V2.2.3
      • OceanBase Connector/J V2.2.0

Download PDF

Document Feedback
  1. Documentation Center
  2. OceanBase Connector/J
  3. V2.4.19

OceanBase Connector/J V2.4.19

Last Updated:2026-09-17 02:33:48

Overview
New features
Compatibility changes
URL parameter changes
Bug fixes

Release date: September 7, 2026 Version: V2.4.19

Overview

JDBC V2.4.19 introduces a caching mechanism for metadata under the PS protocol, which avoids repeated retrieval and processing of the same metadata. It also extends support for UDT (User Defined Type) as a table column and supports output parameters for complex type elements in PL anonymous arrays.

New features

  • Added client-side caching for metadata (such as column names and types) under the PreparedStatement protocol, reducing network round-trip overhead with OBServer, lowering server load, and improving application-layer performance in retrieving result set metadata.
  • JDBC adaptation for OBServer custom type columns, enhancing the JDBC driver's ability to recognize and handle User Defined Types (UDT) as table column types in OBServer.
  • Supports PL output parameters as anonymous arrays containing complex types.

Compatibility changes

The compatibility changes in this version are mainly reflected in the new behavior of the following URL parameters.

URL parameter changes

Modify the following URL parameters:

Name
Changes
Description
obCachePsMetaData New Indicates whether to cache meta information under the PS protocol. This parameter takes effect only when it is enabled by setting the server parameter enable_ps_meta_response_optimize.
obGetDateStringWithMillis New Specifies whether to include milliseconds when retrieving a date value using getString in an Oracle-compatible tenant. (This parameter does not affect the result when compatible with OJDBC6.)

Bug fixes

The main issues fixed in this iteration are as follows.

  • Fixed a NullPointerException when using CallableStatement to call a stored procedure in JDBC.
  • Fixed a serialization error in the internal Rowid implementation class of JDBC.
  • Fixed precision loss when using the getString method to retrieve Date type data with compatibleOjdbcVersion=8.
  • Fixed an error of -4001 for DECIMAL type parameters when calling PKG stored procedures.
  • Fixed the issue where maximum open cursors exceeded occurred after enabling cachePrepStmts.
  • Fixed an issue where a null pointer was triggered in the inCallableStatementCache due to the Connection being closed prematurely in case of a JDBC exception.
  • Fixed issues related to requestId validation and race conditions during concurrent reads when using useBatchMultiSend under the 2.0 protocol.
  • Fixed an exception thrown when calling isLast() on a TYPE_SCROLL_INSENSITIVE ResultSet in Oracle-compatible mode.
  • Optimized the issue where the error message was not user-friendly when a streaming result set was not specified with extendOracleResultSetClass in Oracle-compatible mode.
  • Fixed an issue where the metadata lookup path was unclear when using ALL_ARGUMENTS to view PL parameters.

Previous topic

Behavior differences between JDBC strict compatibility mode and non-strict compatibility mode
Last

Next topic

OceanBase Connector/J V2.4.18
Next
on this page
Overview
New features
Compatibility changes
URL parameter changes
Bug fixes