Configurar sua conexão JDBC com o Apache Maven

O Apache Maven é uma ferramenta de gerenciamento e compreensão de projetos de software. O AWS SDK for Java é compatível com os projetos do Apache Maven. Para obter mais informações, consulte Usar o SDK com o Apache Maven no Guia do desenvolvedor do AWS SDK for Java.

Se você usa o Apache Maven, pode configurar e construir seus projetos para usar um driver JDBC do Amazon Redshift para se conectar ao seu cluster do Amazon Redshift. Para fazer isso, adicione o driver JDBC como uma dependência no arquivo pom.xml do projeto. Se você usa o Maven para compilar um projeto e deseja usar uma conexão JDBC, siga as etapas da próxima seção.

Configuração do driver de JDBC como uma dependência do Maven

Como configurar o driver JDBC como uma dependência do Maven

1. Adicione o repositório Amazon ou o repositório Maven Central à seção de repositórios do arquivo pom.xml.

   nota

   O URL exibido no exemplo de código a seguir retornará um erro se for usado em um navegador. Use este URL somente no contexto de um projeto Maven.

   Para um repositório do Amazon Maven, use o seguinte.

   <repositories>
       <repository>
         <id>redshift</id>
         <url>http://redshift-maven-repository.s3-website-us-east-1.amazonaws.com/release</url>
       </repository>
   </repositories>

   Para conectar-se usando Secure Sockets Layer (SSL), adicione o repositório a seguir ao arquivo pom.xml.

   <repositories>
       <repository>
         <id>redshift</id>
         <url>https://s3.amazonaws.com/redshift-maven-repository/release</url>
       </repository>
   </repositories>

   Para um repositório Maven Central, adicione o seguinte ao arquivo pom.xml:

   <repositories>
       <repository>
         <id>redshift</id>
         <url>https://repo1.maven.org/maven2</url>
       </repository>
   </repositories>

2. Declare a versão do driver que deseja usar na seção de dependências do arquivo pom.xml.

   O Amazon Redshift oferece drivers para ferramentas compatíveis com a API JDBC 4.2. Para obter informações sobre a funcionalidade compatível com esses drivers, consulte Baixe o driver JDBC do Amazon Redshift, versão 2.1.

   Adicione uma dependência para o driver conforme mostrado a seguir.

   Substitua driver-version no exemplo a seguir com a versão do driver, por exemplo 2.1.0.1.

   Para um driver compatível com JDBC 4.2, use o seguinte:

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

   O nome da classe deste driver é com.amazon.redshift.Driver.

Os drivers do Amazon Redshift Maven precisam das dependências opcionais a seguir quando você usa a autenticação de banco de dados do IAM.

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

Atualização do driver para a versão mais recente

Para atualizar ou alterar o driver JDBC do Amazon Redshift para a versão mais recente, primeiro modifique a seção de versão da dependência para a versão mais recente do driver. Limpe seu projeto com o Maven Clean Plugin, conforme mostrado a seguir.

mvn clean