这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

JDBC 客户端驱动程序

Vertica JDBC 客户端驱动程序符合 JDK 5 规范，它提供了一个接口，通过该接口可以使用 Java 与 Vertica 数据库进行通信。有关此 API 和其他 API 的详细信息，请参阅 API 参考。

要安装 JDBC 客户端驱动程序，请参阅安装 JDBC 客户端驱动程序。

1 - 安装 JDBC 客户端驱动程序

JDBC 客户端驱动程序符合 JDK 5 规范。根据您的环境和要求下载 JDBC 客户端驱动程序。如果您需要使用符合 FIPS 的驱动程序，请参阅为 JDBC 安装 FIPS 客户端驱动程序。

从 RPM 安装 Vertica 会自动安装 JDBC 客户端驱动程序。要使用 JDBC 客户端驱动程序，您只需将 Vertica JDBC .jar 添加到您的 CLASSPATH。

要手动安装 JDBC 客户端驱动程序：

  1. 从客户端驱动程序下载页面，下载与您的 Vertica 版本兼容的 JDBC 客户端驱动程序版本。

  2. 在希望从中访问 Vertica 的每个客户端系统上将 .jar 文件复制到 Java CLASSPATH 中的目录。您可以执行以下操作之一：

    • 将 .jar 文件复制到其自己的目录（例如 /opt/vertica/java/lib），然后将该目录添加到 CLASSPATH（建议采用此方法）。有关详细信息，请参阅修改 Java CLASSPATH。

    • 将 .jar 文件复制到已存在于 CLASSPATH 中的目录（例如，已将应用程序所依赖的其他 .jar 文件放置到的目录）。

    • 将 .jar 文件复制到系统范围的 Java 扩展目录。确切的位置因操作系统不同而异。一些示例包括：

      • Windows： C:\Program Files\Java\jrex.x.x_x\lib\ext\\

      • Mac OS： /Library/Java/Extensions 或 /Users/username/Library/Java/Extensions

  3. 创建连接以测试您的配置。

2 - 修改 Java CLASSPATH

CLASSPATH 环境变量包含目录的列表，Java 运行时将从该列表的目录查找库类文件。要让 Java 客户端代码访问 Vertica，您必须将包含 Vertica JDBC .jar 的目录添加到 CLASSPATH。

将符号链接用于 CLASSPATH

您可以选择将符号链接 vertica-jdbc-x.x.x.jar（其中 x.x.x 是版本号，此符号链接指向 JDBC 库 .jar 文件而非 .jar 文件本身）添加到 CLASSPATH。

使用符号链接可确保对 JDBC 库 .jar 文件（此文件使用其他文件名）进行的任何更新不会使 CLASSPATH 设置失效，因为符号链接的文件名将保持不变。您只需要更新符号链接，使其指向新的 .jar 文件。

Linux 和 OS X

以下示例使用符合 POSIX 的 shell。

要为当前会话设置 CLASSPATH：

$ export CLASSPATH=$CLASSPATH:/opt/vertica/java/lib/vertica-jdbc-x.x.x.jar

要为每个会话设置 CLASSPATH，请将以下内容添加到启动文件（例如 ~/.profile 或 /etc/profile）：

$ export CLASSPATH=$CLASSPATH:/opt/vertica/java/lib/vertica-jdbc-x.x.x.jar

Windows

提供指向 .jar、.zip 或 .class 文件的类路径。

C:> SET CLASSPATH=classpath1;classpath2...

例如：

C:> SET CLASSPATH=C:\java\MyClasses\vertica-jdbc-x.x.x.jar

与 Linux/UNIX 设置一样，此设置仅持续到当前会话关闭。若要永久设置 CLASSPATH，请设置环境变量：

  1. 在 Windows 控制面板中，单击系统。

  2. 单击高级 或高级系统设置。

  3. 单击环境变量。

  4. 在“用户变量”下，单击新建。

  5. 在“变量名”框中，键入 CLASSPATH。

  6. 在“变量值 (Variable value)”框中，键入指向系统上的 Vertica JDBC .jar 文件的路径（例如， C:\Program Files (x86)\Vertica\JDBC\vertica-jdbc-x.x.x.jar）

在 Java 命令中指定库目录

另一种与操作系统无关的、告知 Java 运行时在何处可以找到 Vertica JDBC 驱动程序的方法是：使用 -cp 或 -classpath 实参将包含 .jar 文件的目录显式添加到 Java 命令行。例如，可以使用以下命令启动客户端应用程序：

java -classpath /opt/vertica/java/lib/vertica-jdbc-x.x.x.jar myapplication.class

Java IDE 还可让您将目录添加到 CLASSPATH，或者可让您将 Vertica JDBC 驱动程序导入到项目中。有关详细信息，请参阅 IDE 文档。