全部产品

安装驱动程序

安装 OceanBase Connector/J 驱动程序需要具备一定的前提条件,并根据相应的步骤进行安装。

前提条件

在安装使用 OceanBase Connector/J 驱动程序前请确保设置了基本的数据库开发环境,并确保计算机上的 Java 环境为 Java JDK 8 版本。

安装步骤

  1. 请联系技术支持人员获取 OceanBase Connector/J 驱动程序安装包。

    技术支持人员可以根据如下两种方式获取 OceanBase Connector/J 驱动程序安装包:

    方法 1:内网环境安装包下载路径

    方法 2:在内网环境中,使用 Maven 安装 OceanBase Connector/J 驱动程序。请将以下依赖项添加到 pom.xml 配置文件中:

    <dependency>
          <groupId>com.oceanbase</groupId> 
          <artifactId>oceanbaseclient</artifactId>
          <version>2.2.1</version>
    </dependency>
    //OceanBase Connector/J V1 版本的 groupId 是 com.alipay.oceanbase
    
    
    
  2. 编写 Java 示例文件 HelloWorld.java 并加载驱动类。

    public class HelloWorld {
       public static void main(String[] args) {
           try {
               Class.forName("com.alipay.oceanbase.jdbc.Driver");
           } catch (ClassNotFoundException e) {
               e.printStackTrace();
           }
       }
    }
    
    说明

    OceanBase Connector/J V1 版本的驱动为 com.alipay.oceanbase.obproxy.mysql.jdbc.Driver,即类名为 Class.forName("com.oceanbase.obproxy.mysql.jdbc.Driver");

  3. 编译 Java 示例文件,命令如下:

    javac -cp target/oceanbase-client-{version}.jar HelloWorld.java
    说明

    用户可以根据情况自行更改编译路径。

  4. 运行 Java 示例文件,命令如下:

    java -cp .:target/oceanbase-client-{version}.jar HelloWorld

如果第 2 步、第 3 步和第 4 步执行成功,并无报错信息,说明已正确加载 OceanBase Connector/J 驱动程序的 JAR 包。之后可以使用 OceanBase 数据库的 IP 地址及端口号进行数据库连接。即在如下代码段中,将 String url 字段填入相应的 IP 地址、端口号和 Schema Name。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
public class HelloWorld {
   public static void main(String[] args) {
       try {
           String url = "jdbc:oceanbase://ipaddress:port/shemaname?pool=false";
           String  user = "username";
           String  password = "password";
           Class.forName("com.alipay.oceanbase.jdbc.Driver");
           Connection connection = DriverManager.getConnection(url, user, password);
       } catch (ClassNotFoundException e) {
           e.printStackTrace();
       }
   }

数据库连接成功后,可以重新执行上述第 3 步和第 4 步进行加载类。