Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

QLDBControlador Amazon para Java

Para trabajar con los datos de tu libro mayor, puedes conectarte a Amazon QLDB desde tu aplicación Java mediante un controlador AWS proporcionado. En los siguientes temas se describe cómo empezar a utilizar el QLDB controlador para Java.

Recursos de controladores

Para obtener más información sobre la funcionalidad compatible con el controlador de Java, consulte los siguientes recursos:

Requisitos previos

Antes de empezar a utilizar el QLDB controlador para Java, debe hacer lo siguiente:

A continuación, puede descargar la aplicación de ejemplo completa del tutorial, o bien instalar solo el controlador en un proyecto de Java y ejecutar ejemplos de códigos cortos.

Configuración de la región y las credenciales de AWS predeterminadas

El QLDB controlador y el subyacente AWS SDK for Javarequieren que proporciones AWS credenciales a tu aplicación en tiempo de ejecución. En los ejemplos de código de esta guía se supone que se usa un archivo de credenciales de AWS , tal como se describe en Configuración de las credenciales y la región predeterminadas en la Guía para desarrolladores de AWS SDK for Java 2.x .

Como parte de estos pasos, también debe establecer su valor predeterminado Región de AWS para determinar su QLDB punto final predeterminado. Los ejemplos de código se conectan QLDB de forma predeterminada Región de AWS. Para obtener una lista completa de las regiones en las que QLDB está disponible, consulta los QLDBpuntos de conexión y las cuotas de Amazon en. Referencia general de AWS

A continuación se muestra un ejemplo de un archivo de AWS credenciales denominado~/.aws/credentials, en el que la tilde (~) representa su directorio principal.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

Sustituya los valores de AWS sus propias credenciales por los valores your_access_key_id y your_secret_access_key.

Instalación

QLDBes compatible con las siguientes versiones del controlador Java y sus AWS SDK dependencias.

Para instalar el QLDB controlador, se recomienda utilizar un sistema de administración de dependencias, como Gradle o Maven. Por ejemplo, añada el artefacto siguiente como dependencia en su proyecto Java.

2.x

Gradle

Agregue esta dependencia a su archivo de configuración build.gradle.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '2.3.1'
}

Maven

Agregue esta dependencia a su archivo de configuración pom.xml.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>2.3.1</version>
  </dependency>
</dependencies>

Este artefacto incluye automáticamente el módulo AWS SDK for Java 2.x principal, las bibliotecas de Amazon Ion y otras dependencias necesarias.

1.x

Gradle

Agregue esta dependencia a su archivo de configuración build.gradle.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '1.1.0'
}

Maven

Agregue esta dependencia a su archivo de configuración pom.xml.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>1.1.0</version>
  </dependency>
</dependencies>

Este artefacto incluye automáticamente el módulo AWS SDK for Java principal, las bibliotecas de Amazon Ion y otras dependencias necesarias.

importante

Espacio de nombres de Amazon Ion: al importar las clases de Amazon Ion a su aplicación, debe usar el paquete que se encuentra debajo del espacio de nombres com.amazon.ion. AWS SDK for Java Depende de otro paquete de Ion incluido en el espacio de nombressoftware.amazon.ion, pero se trata de un paquete heredado que no es compatible con el controlador. QLDB

Para ver ejemplos de códigos cortos sobre cómo ejecutar transacciones de datos básicos en un libro mayor, consulte Referencia de libro de recetas.

Otras bibliotecas opcionales

Si lo desea, también puede agregar las bibliotecas útiles siguientes al proyecto. Estos artefactos son dependencias obligatorias en la aplicación de muestra Tutorial de Java.

Gradle

Agregue estas dependencias a su archivo de configuración build.gradle.

dependencies {
    compile group: 'com.amazonaws', name: 'aws-java-sdk-qldb', version: '1.11.785'
    compile group: 'com.fasterxml.jackson.dataformat', name: 'jackson-dataformat-ion', version: '2.10.0'
}

Maven

Agregue estas dependencias a su archivo de configuración pom.xml.

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-qldb</artifactId>
    <version>1.11.785</version>
  </dependency>
  <dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-ion</artifactId>
    <version>2.10.0</version>
  </dependency>
</dependencies>