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.1
  • What is OceanBase Connector J?
    • Compatibility requirements
    • Overview of OceanBase Connector/J
  • Install Driver
    • Install and load the OceanBase Connector/J driver
  • Instructions
    • Quick start
      • Import packages
      • Create 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
      • Example
    • Data sources and URL
      • Data source overview
      • Data source characteristics and properties
      • Create and connect to a data source instance
      • Database URL
    • 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 API
      • CHAR, VARCHAR, and RAW data types
    • Statement caching
      • Overview of statement caching
      • Use statement caching
      • Reuse statement objects
    • Use CallableStatements to call stored procedures
    • Handle SQL exceptions
    • Result set
      • Overview of result sets
      • Limits
      • FetchSize
      • refreshRow
      • useCursorFetch
    • Batch processing
    • Failover and Load-Balancing
      • Failover and load balancing modes
      • LoadBalance strategies
      • LoadBalance strategies configuration methods
    • Security features
    • SQL NetworkCostInfo
    • 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
      • Result set performance
      • Use ARRAY and STRUCT classes
      • Distributed transactions
        • Overview of distributed transactions
        • XA components
        • Distributed transaction examples
      • Error messages in Oracle mode
      • Get remarks information
      • Data types supported in Oracle mode
    • Supported SQL and PL data types
    • Common APIs
      • Overview of common APIs
      • 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
  • Release Notes
    • V2.4
      • 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.1

SQL NetworkCostInfo

Last Updated:2026-09-04 08:24:25

Related APIs
Examples

SQL NetworkCostInfo allows you to obtain network overhead data by using some fine-grained APIs.

Related APIs

All the APIs listed in the following table are at the Connection level and require forced type conversion when they are executed to obtain detailed time values.

API
Description
Parameter
Unit of return value
networkStatistics Specifies whether to enable statistics collection. true: enables statistics collection. false: disables statistics collection. Default value: false Empty
getLastPacketCostTime Obtains the round-trip time of the last packet. Empty ms
getLastPacketReponseTimestamp Obtains the packet return timestamp of the last packet. Empty ms
getLastPacketSendTimestamp Obtains the sending timestamp of the last packet. Empty ms
clearNetworkCostInfo Clears previously cached data. Empty Empty

Examples

 public void testCostTime() {
        try {
            Connection conn = sharedConnection;
            ((OceanBaseConnection) conn).networkStatistics(true);
            PreparedStatement ps = conn
                .prepareStatement("insert into " + tableName2 + " values(?)");
            long ms = ((OceanBaseConnection) conn).getLastPacketCostTime();
            System.out.println("prepareStatement  cost info  = " + ms + "ms");
            /*  getNetWorkCostInfo gets the information of the last network transmission, setInt will not perform network transmission, so it needs to be cleaned up*/
            ((OceanBaseConnection) conn).clearNetworkCostInfo();
            ms = ((OceanBaseConnection) conn).getLastPacketCostTime();
            ps.setInt(1, 1);

            System.out.println("setInt   cost info  = " + ms + "ms");
            ps.execute();
            ms = ((OceanBaseConnection) conn).getLastPacketCostTime();
            long sendTs = ((OceanBaseConnection) conn).getLastPacketSendTimestamp();
            long responseTs = ((OceanBaseConnection) conn).getLastPacketResponseTimestamp();
            System.out
                .println(" (responseTs - sendTs) + \"m's\" = " + (responseTs - sendTs) + "ms");
            System.out.println("execute  cost info  = " + ms + "ms");
            ((OceanBaseConnection) conn).networkStatistics(false);
            ms = ((OceanBaseConnection) conn).getLastPacketCostTime();
        } catch (SQLException e) {
            Assert.assertEquals("Cant get network cost info while setNetworkStatisticsFlag(true)",
                e.getMessage());
        }

    }

Previous topic

Security features
Last

Next topic

Troubleshooting
Next
on this page
Related APIs
Examples