Amazon Redshift
管理指南 (API Version 2012-12-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

使用 Apache Maven 配置 JDBC 连接

Apache Maven 是一款软件项目管理及理解工具。适用于 Java 的 AWS 开发工具包支持 Apache Maven 项目。有关更多信息,请参阅将 SDK 与 Apache Maven 一起使用

如果您使用 Apache Maven,可以配置并生成您的项目,以使用 Amazon Redshift JDBC 驱动程序与 Amazon Redshift 群集连接。为此,您需要将 JDBC 驱动程序添加为您的项目 pom.xml 文件中的依赖项。如果您使用 Maven 生成项目并希望使用 JDBC 连接,请按照此部分中的步骤执行操作。

将 JDBC 驱动程序配置为 Maven 依赖项

将 JDBC 驱动程序配置为 Maven 依赖项

  1. 将以下存储库添加到 pom.xml 文件的存储库部分。

    注意

    以下代码中的 URL 如果用在浏览器中,将返回错误。该 URL 应只用在 Maven 项目的上下文中。

    Copy
    <repositories> <repository> <id>redshift</id> <url>http://redshift-maven-repository.s3-website-us-east-1.amazonaws.com/release</url> </repository> </repositories>
  2. pom.xml 文件的依赖项部分声明您要使用的驱动程序版本。

    Amazon Redshift 向与 JDBC 4.2 API、JDBC 4.1 API 或 JDBC 4.0 API 兼容的工具提供多种驱动程序。有关这些驱动程序支持的功能的信息,请参阅 Amazon Redshift JDBC 驱动程序发行说明在 中国(北京) 区域中,请使用以下链接。https://s3.cn-north-1.amazonaws.com.cn/redshift-downloads-cn/drivers/Amazon+Redshift+JDBC+Release+Notes.pdf

    从以下列表中添加驱动程序的依赖项。

    注意

    对于 1.2.1.1001 版和更高版本,您可以使用通用驱动程序类名 com.amazon.redshift.jdbc.Driver 或下面列表中和驱动程序一起列出的特定于版本的类名;例如 com.amazon.redshift.jdbc42.Driver。对于 1.2.1001 之前的版本,只有特定于版本的类名受支持。

    • 与 JDBC 4.2 兼容的驱动程序:

      Copy
      <dependency> <groupId>com.amazon.redshift</groupId> <artifactId>redshift-jdbc42</artifactId> <version>1.2.10.1009</version> </dependency>

      此驱动程序的类名是 com.amazon.redshift.jdbc42.Driver

    • 与 JDBC 4.1 兼容的驱动程序:

      Copy
      <dependency> <groupId>com.amazon.redshift</groupId> <artifactId>redshift-jdbc41</artifactId> <version>1.2.10.1009</version> </dependency>

      此驱动程序的类名是 com.amazon.redshift.jdbc41.Driver

    • 与 JDBC 4.0 兼容的驱动程序:

      Copy
      <dependency> <groupId>com.amazon.redshift</groupId> <artifactId>redshift-jdbc4</artifactId> <version>1.2.10.1009</version> </dependency>

      此驱动程序的类名是 com.amazon.redshift.jdbc4.Driver

  3. 下载并阅读 Amazon Redshift JDBC Driver License Agreement

标准 Amazon Redshift JDBC 驱动程序包括使用 IAM 数据库身份验证所需的 AWS 开发工具包。我们建议使用标准驱动程序,除非驱动程序文件的大小对您的应用程序来说是一个问题。如果您需要更小的驱动程序文件,并且不使用 IAM 数据库身份验证,或如果您的 Java 类路径中已有适用于 Java 的 AWS 开发工具包 1.11.118 或更高版本,则请从以下列表中添加驱动程序的依赖项。

  • 与 JDBC 4.2 兼容的驱动程序:

    Copy
    <dependency> <groupId>com.amazon.redshift</groupId> <artifactId>redshift-jdbc42-no-awssdk</artifactId> <version>1.2.10.1009</version> </dependency>

    此驱动程序的类名是 com.amazon.redshift.jdbc42.Driver

  • 与 JDBC 4.1 兼容的驱动程序:

    Copy
    <dependency> <groupId>com.amazon.redshift</groupId> <artifactId>redshift-jdbc41-no-awssdk</artifactId> <version>1.2.10.1009</version> </dependency>

    此驱动程序的类名是 com.amazon.redshift.jdbc41.Driver

  • 与 JDBC 4.0 兼容的驱动程序:

    Copy
    <dependency> <groupId>com.amazon.redshift</groupId> <artifactId>redshift-jdbc4-no-awssdk</artifactId> <version>1.2.10.1009</version> </dependency>

    此驱动程序的类名是 com.amazon.redshift.jdbc4.Driver

无软件开发工具包的 Amazon Redshift Maven 驱动程序包含以下可选依赖项,您在项目中可以根据需要包含这些依赖项。

Copy
<dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-core</artifactId> <version>1.2.10.1009</version> <scope>runtime</scope> <optional>true</optional> </dependency> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-redshift</artifactId> <version>1.2.10.1009</version> <scope>runtime</scope> <optional>true</optional> </dependency> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-sts</artifactId> <version>1.2.10.1009</version> <scope>runtime</scope> <optional>true</optional> </dependency>

如果您的工具需要使用某个早期版本的驱动程序,请参阅使用 Maven 的早期 JDBC 驱动程序版本

如果您需要将这些驱动程序分发给客户或其他第三方,请发送电子邮件至 redshift-pm@amazon.com 以安排合适的许可证。

将驱动程序升级到最新版本

要将 Amazon Redshift JDBC 驱动程序升级或更改到最新版本,请将依赖项的版本部分修改为驱动程序的最新版本,然后用 Maven Clean Plugin 清除您的项目,如下所示。

Copy
mvn clean