获取驱动jar包并配置JDK环境

获取驱动jar包

解压发布包，并从中获取对应的驱动jar包：Jdk8发布包提供支持JDK1.8环境的驱动包；Jdk17发布包提供支持JDK17环境的驱动包；Jdk21发布包提供支持JDK21环境的驱动包。

Jdk17发布包目录结构（以X86为例）如下：

• GaussDB-Kernel_数据库版本号_Jdbc_X86_Jdk17_Distributed.tar.gz
  • GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz
    • gaussdbjdbc.jar
    • gscejdbc.jar
    • gsjdbc4.jar
    • gsjdbc200.jar
    • opengaussjdbc.jar
    • opengaussjdbc-ce.jar

根据需要从发布包中获取对应的jar驱动包：

• 对于JDK1.8环境，使用Jdk8的发布包：
  • gaussdbjdbc.jar：主类名为“com.huawei.gaussdb.jdbc.Driver”，数据库连接的url前缀为“jdbc:gaussdb”，此驱动包适用于JDK1.8环境。
  • gscejdbc.jar：主类名为“com.huawei.gaussdb.jdbc.Driver”，数据库连接的url前缀为“jdbc:gaussdb”，此驱动包打包了密态数据库需要加载的加解密相关的依赖库，密态场景使用此驱动包。目前仅支持EulerOS操作系统。
• 对于JDK17环境，使用Jdk17的发布包：
  • gaussdbjdbc.jar：主类名为“com.huawei.gaussdb.jdbc.Driver”，数据库连接的url前缀为“jdbc:gaussdb”，此驱动包适用于JDK17环境。
  • gscejdbc.jar：主类名为“com.huawei.gaussdb.jdbc.Driver”，数据库连接的url前缀为“jdbc:gaussdb”，此驱动包包含密态数据库所需的加解密依赖库，密态场景使用此驱动包。目前仅支持EulerOS操作系统。
• 对于JDK21环境，使用Jdk21的发布包：
  • gaussdbjdbc.jar：主类名为“com.huawei.gaussdb.jdbc.Driver”，数据库连接的url前缀为“jdbc:gaussdb”，此驱动包适用于JDK21环境。
  • gscejdbc.jar：主类名为“com.huawei.gaussdb.jdbc.Driver”，数据库连接的url前缀为“jdbc:gaussdb”，此驱动包包含密态数据库所需的加解密依赖库，密态场景使用此驱动包。目前仅支持EulerOS操作系统。

• 使用gscejdbc.jar驱动包时，需要先设置环境变量LD_LIBRARY_PATH。具体使用方式参见使用JDBC操作密态数据库。
• jdbc发布件jar包按照架构分类，gscejdbc.jar包必须与对应的部署环境一致才能使用，其他jar包无需与部署环境一致。
• Jdk17和Jdk21发布包的驱动暂不支持JDBC4.3标准新特性。

配置JDK环境

客户端需配置JDK环境，本章节以配置JDK1.8为例。JDK支持Windows、Linux等多种平台。以Windows为例，配置方法如下。

1. 在DOS窗口（Windows下的命令提示符）输入以下命令查看JDK版本。

   java -version

   确认是否已安装JDK1.8。若未安装，请从官方网站下载安装包并安装。

2. 根据如下步骤配置系统环境变量。
   1. 右键单击“我的电脑”，选择“属性”。
   2. 在“系统”页面左侧导航栏单击“高级系统设置”。
      

      因操作系统版本之间存在差异，操作时请以实际路径为准。

   3. 在“系统属性”页面，“高级”页签上单击“环境变量”。
   4. 在“环境变量”页面上，“系统变量”区域单击“新建”或“编辑”配置系统变量。变量说明如表1所示。

      表1 变量说明

      变量名	操作	变量值
      JAVA_HOME	若存在，则单击“编辑”。 若不存在，则单击“新建”。	JAVA的安装目录。 例如：C:\Program Files\Java\jdk1.8.0_131。
      Path	单击“编辑”。	若配置了JAVA_HOME，则在变量值的最前面加上： %JAVA_HOME%\bin。 若未配置JAVA_HOME，则在变量值的最前面加上JAVA安装的全路径： C:\Program Files\Java\jdk1.8.0_131\bin。
      CLASSPATH	单击“新建”。	%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar。