---
title: "Java 应用程序连接 OceanBase 数据库 | OceanBase 文档中心"
description: Java 应用程序连接 OceanBase 数据库 本文提供 Java 应用程序连接 OceanBase 数据库的代码示例。 前提条件 确保设置了基本的数据库开发环境。 确保计算机上的 Java 环境为 Java JDK 8 版本。 获取 OceanBase Connector/J 驱动程序安装包。请在 OceanB…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.0.0 企业版

# Java 应用程序连接 OceanBase 数据库

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

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

## 前提条件

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

## 操作步骤

1. 将 OceanBase Connector/J 的 JAR 包放入本地 `/usr/share/java` 路径中，并设置临时环境变量。

   ```shell
   mv ./oceanbase-client-{version}.jar /usr/share/java
   export CLASSPATH=/usr/share/java/oceanbase-client-{version}.jar:$CLASSPATH

   ```

   > **说明**
   >
   >  
   >
   > 根据下载的实际文件版本进行相应操作。
 2. 编写 Java 示例文件 `Test.java`。

   ```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**：用户密码。
 3. 代码编辑完成后，可以通过如下命令进行编译和执行，返回 true 说明数据库连接成功。

   ```java
   //编译
   javac Test.java
   //运行
   java Test

   ```

关于 OceanBase Connector/J 的详细使用信息，请参考官方文档 [OceanBase Connector/J](https://www.oceanbase.com/docs/oceanbase-connector-j-cn)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线