更新时间:2024-09-13 GMT+08:00
分享

下载JDBC或ODBC驱动

JDBC或ODBC驱动程序用于连接GaussDB(DWS)集群,用户可以在管理控制台下载GaussDB(DWS)提供的JDBC或ODBC驱动程序,也可以使用开源的JDBC或ODBC驱动程序。

支持的开源JDBC或ODBC驱动程序

GaussDB(DWS)也支持开源的JDBC驱动程序:PostgreSQL JDBC驱动程序9.3-1103或更高版本。

GaussDB(DWS)也支持开源的ODBC驱动程序:PostgreSQL ODBC 09.01.0200或更高版本。

下载JDBC或ODBC驱动程序

  1. 登录GaussDB(DWS)管理控制台。
  2. 在左侧导航栏中,单击“连接客户端”
  3. “下载驱动程序”区域,选择一个驱动下载。

    图1 下载驱动
    • JDBC驱动

      方式一:

      选择“DWS JDBC Driver”,然后单击“下载”可以下载与现有集群版本匹配的JDBC驱动。驱动包名为“dws_8.1.x_jdbc_driver.zip”,解压后有两个JDBC的驱动jar包,分别为“gsjdbc4.jar”和“gsjdbc200.jar”。

      • gsjdbc4.jar:与PostgreSQL保持兼容,其中类名、类结构与PostgreSQL驱动完全一致,曾经运行于PostgreSQL的应用程序可以直接移植到当前系统中使用。
      • gsjdbc200.jar:如果同一JVM进程内需要同时访问PostgreSQL及GaussDB(DWS)请使用该驱动包。该包主类名为“com.huawei.gauss200.jdbc.Driver”(即将“org.postgresql”替换为“com.huawei.gauss200.jdbc”) ,数据库连接的URL前缀为“jdbc:gaussdb”,其余与gsjdbc4.jar相同。

      如果同时拥有不同版本的集群,单击“下载”时会下载与集群最低版本相对应的JDBC驱动。如果当前没有集群,单击“下载”时将下载到低版本的JDBC驱动。GaussDB(DWS)集群可向下兼容低版本的JDBC驱动。

      单击“历史版本”可根据集群版本下载相应版本的JDBC驱动,建议按集群版本进行下载。

      JDBC驱动包支持在所有平台所有版本中使用,且依赖JDK 1.6及以上版本。

      如果同时拥有不同版本的集群,系统会弹出对话框,提示您选择“集群版本”然后下载与集群版本相对应的驱动程序。在“专属集群页面的集群列表中,单击指定集群的名称,再选择“集群详情”页签,可查看集群版本。

      表1 JDBC驱动下载地址

      驱动名称

      下载地址

      校验文件

      DWS JDBC Driver

      dws_8.2.x_jdbc_driver.zip

      dws_8.2.x_jdbc_driver.zip.sha256

      dws_8.1.x_jdbc_driver.zip

      dws_8.1.x_jdbc_driver.zip.sha256

      方式二:

      用户还可以通过配置maven仓库的方式下载SDK包。单击“Maven项目依赖”,进入以下页面:

      图2 Maven页面

      图2所示的列表中,第一列代表集群版本号,第二列代表GaussDB(DWS) JDBC驱动包的版本号,请根据集群版本号,选择相应版本的驱动包,然后进入以下页面:

      图3 Maven项目依赖

      复制Maven库信息,并将其添加到pom.xml文件中。例如,在pom.xml文件中添加如下代码配置:

      • gsjdbc4.jar
        1
        2
        3
        4
        5
        <dependency>
            <groupId>com.huaweicloud.dws</groupId>
            <artifactId>huaweicloud-dws-jdbc</artifactId>
            <version>8.1.0</version> 
        </dependency>
        
      • gsjdbc200.jar
        <dependency>
            <groupId>com.huaweicloud.dws</groupId>
            <artifactId>huaweicloud-dws-jdbc</artifactId>
            <version>8.1.1.1-200</version>
        </dependency>  
    • ODBC驱动

      选择相应的版本,然后单击“下载”可以下载与集群版本匹配的ODBC驱动。如果同时拥有不同版本的集群,单击“下载”时会下载与集群最低版本相对应的ODBC驱动。如果当前没有集群,单击“下载”时将下载到低版本的ODBC驱动。GaussDB(DWS)集群可向下兼容低版本的ODBC驱动。

      单击“历史版本”可根据操作系统和集群版本下载相应版本的ODBC驱动,建议按集群版本进行下载。

      ODBC驱动不兼容Window server 2016系统。

相关文档