Java 应用程序连接 OceanBase 数据库

更新时间：2026-05-25 19:54:12

本文提供 Java 应用程序连接 OceanBase 数据库的代码示例。

前提条件

确保设置了基本的数据库开发环境。
确保计算机上的 Java 环境为 Java JDK 8 版本。
获取 OceanBase Connector/J 驱动程序安装包。请在 OceanBase 官方网站的 资源 -> 下载中心 -> 企业版 -> 驱动和中间件 下的 OceanBase JDBC 驱动程序中单击对应的版本，填写信息后自助下载 OceanBase Connector/J 驱动程序安装包。

操作步骤

将 OceanBase Connector/J 的 JAR 包放入本地 /usr/share/java 路径中，并设置临时环境变量。
```
mv ./oceanbase-client-{version}.jar /usr/share/java
export CLASSPATH=/usr/share/java/oceanbase-client-{version}.jar:$CLASSPATH
```
说明

根据下载的实际文件版本进行相应操作。

编写 Java 示例文件 Test.java。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class Test {
    public static void main(String[] args) {
        try {
            String url = "jdbc:oceanbase://172.30.xx.xx:2881/?pool=false";
            String  user = "s**@oracle";
            String  password = "******";
            Class.forName("com.oceanbase.jdbc.Driver");
            Connection connection = DriverManager.getConnection(url, user, password);
            System.out.println(connection.getAutoCommit());
        }catch (SQLException ex) {
                    System.out.println("error!");
                    ex.printStackTrace() ;
        }catch (ClassNotFoundException e) {
                    e.printStackTrace();
        }
    }
}

参数说明：

url：jdbc:oceanbase://IP:端口/?pool=false。OceanBase 数据库连接 IP，通常是一个 OBProxy 地址，以及访问所用的端口号。
user：用户名@租户名。租户的连接用户，Oracle 模式的管理员用户名默认是 sys。

说明

对于专有云或独立部署的场景，username 的格式为：String username = "用户名@租户#集群"。
password：用户密码。

代码编辑完成后，可以通过如下命令进行编译和执行，返回 true 说明数据库连接成功。
```
//编译
javac Test.java
//运行
java Test
```

关于 OceanBase Connector/J 的详细使用信息，请参考官方文档 OceanBase Connector/J。