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.12

Last Updated:2026-09-17 02:32:36

Version information
Overview
New features
Compatibility changes
Product behavioral changes
New URL parameters
Bug fixes

Version information

  • Release date: August 2, 2024
  • Version: V2.4.12

Overview

OceanBase Connector/J V2.4.12 readapts to the getScale(), getPrecision(), and getLength() methods of the ResultSetMetaData interface. It also ensures that the getProcedureColumns() method returns the correct result set in Oracle mode and optimizes the performance of the getDate() method.

New features

  • The new version readapts to the getScale(), getPrecision(), and getLength() methods of the ResultSetMetaData interface based on the compatibility mode.

  • The performance of the getDate() method is optimized.

Compatibility changes

Product behavioral changes

The getProcedureColumns() method can return the correct result set in Oracle mode.

New URL parameters

Parameter
Status
Default value
Description
obDateTypeOptimization (specific to OceanBase Connector/J) New False Specifies whether the getDate() method obtains a value directly from a byte array instead of converting the value to a string and then truncating the string.
useNewResultSetMetaData (specific to OceanBase Connector/J) New False Specifies whether metadata is compatible with MySQL Connector/J.

Bug fixes

  • Fixed the issue where the recover() method returns an empty result set for eXtended Architecture (XA) transactions.
  • Fixed the issue where the error returned when OceanBase Connector/J connects to OceanBase Database V4.2.x is inconsistent with that returned when it connects to OceanBase Database V3.2.x in the ArrayBinding delete scenario where both the PreparedStatement and PrepareExecute protocols are enabled and rewriteBatchedStatements=true is configured.
  • Fixed the issue where an error is returned when the executeBatch() method is called with useServerPrepStmts=true&usePieceData=true&useArrayBinding=true configured.
  • Fixed the issue where an error is returned when the setFetchSize() method is called while the value of FetchSize is greater than that of MaxRows in Oracle mode.
  • Fixed the issue where an error is returned when a cursor is used to retrieve columns from an updatable result set while the value of FetchSize is greater than that of MaxRows in MySQL mode.
  • Fixed the issue where an ArrayIndexOutOfBoundsException is thrown when the setCharacterStream(2) method is called to construct a CLOB.
  • Fixed the issue where an error is returned when the executeBatch() method is called while both the PreparedStatement and PrepareExecute protocols are enabled and useArraybinding=true is configured.
  • Fixed the issue where the connection hangs if the obtained result set is empty when multiple threads use the same connection (conn) in the PreparedStatement protocol.
  • Fixed the issue where the "Current position is after the last row" error is returned when a synonym of a complex PL data type is used to construct the input parameters of a stored procedure.

Previous topic

OceanBase Connector/J V2.4.13
Last

Next topic

OceanBase Connector/J V2.4.11
Next
on this page
Version information
Overview
New features
Compatibility changes
Product behavioral changes
New URL parameters
Bug fixes