QLDBAmazon-Treiber für Java

Wichtig

Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter Migrieren eines Amazon QLDB Ledgers zu Amazon Aurora SQL Postgre.

Um mit Daten in Ihrem Ledger zu arbeiten, können Sie über Ihre Java-Anwendung eine Verbindung zu Amazon QLDB herstellen, indem Sie einen AWS bereitgestellten Treiber verwenden. In den folgenden Themen werden die ersten Schritte mit dem QLDB Treiber für Java beschrieben.

Themen

• Ressourcen für Treiber
• Voraussetzungen
• Einstellung Ihrer AWS Standardanmeldedaten und Region
• Installation
• Schnellstart-Tutorial
• Referenz zum Kochbuch

Ressourcen für Treiber

Weitere Informationen zu den vom Java-Treiber unterstützten Funktionen finden Sie in den folgenden Ressourcen:

• APIReferenz: 2.x, 1.x

• Treiber-Quellcode () GitHub

• Quellcode einer Beispielanwendung (GitHub)

• Ledger Loader-Framework () GitHub

• Beispiele für Amazon Ion-Code

Voraussetzungen

Bevor Sie mit dem QLDB Treiber für Java beginnen, müssen Sie Folgendes tun:

1. Folgen Sie den Anweisungen zur AWS Einrichtung unterZugriff auf Amazon QLDB. Diese umfasst die folgenden Funktionen:

   1. Melde dich an für AWS.

   2. Erstellen Sie einen Benutzer mit den entsprechenden QLDB Berechtigungen.

   3. Gewähren Sie programmatischen Zugriff für die Entwicklung.

2. Richten Sie eine Java-Entwicklungsumgebung ein, indem Sie Folgendes herunterladen und installieren:

   1. Java SE Development Kit 8, z. B. Amazon Corretto 8.

   2. (Optional) Integrierte Java-Entwicklungsumgebung (IDE) Ihrer Wahl, z. B. Eclipse oder IntelliJ.

3. Konfigurieren Sie Ihre Entwicklungsumgebung für den AWS SDK for Java Fall. Einstellung Ihrer AWS Standardanmeldedaten und Region

Als Nächstes können Sie die vollständige Beispielanwendung für das Tutorial herunterladen — oder Sie können nur den Treiber in einem Java-Projekt installieren und kurze Codebeispiele ausführen.

• Um den QLDB Treiber und den AWS SDK for Java in einem vorhandenen Projekt zu installieren, fahren Sie mit fort. Installation

• Informationen zum Einrichten eines Projekts und zum Ausführen von kurzen Codebeispielen, die grundlegende Datentransaktionen in einem Ledger veranschaulichen, finden Sie unter. Schnellstart-Tutorial

• Ausführlichere Beispiele für Daten- und API Verwaltungsvorgänge in der vollständigen Beispielanwendung für das Tutorial finden Sie unter. Java-Lernprogramm

Einstellung Ihrer AWS Standardanmeldedaten und Region

Der QLDB Treiber und der zugrunde liegende Treiber AWS SDK for Javaerfordern, dass Sie zur Laufzeit AWS Anmeldeinformationen für Ihre Anwendung angeben. Bei den Codebeispielen in diesem Handbuch wird davon ausgegangen, dass Sie eine Datei mit AWS Anmeldeinformationen verwenden, wie unter Standardanmeldedaten und Region festlegen im AWS SDK for Java 2.x Entwicklerhandbuch beschrieben.

Im Rahmen dieser Schritte sollten Sie auch Ihren Standard festlegen, AWS-Region um Ihren QLDB Standardendpunkt zu bestimmen. Die Codebeispiele stellen standardmäßig eine Verbindung zu QLDB her AWS-Region. Eine vollständige Liste der Regionen, in denen QLDB es verfügbar ist, finden Sie unter QLDBAmazon-Endpunkte und Kontingente in der Allgemeine AWS-Referenz.

Im Folgenden finden Sie ein Beispiel für eine AWS Anmeldeinformationsdatei mit dem Namen~/.aws/credentials, wobei die Tilde (~) für Ihr Home-Verzeichnis steht.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

Ersetzen Sie die Werte durch Ihre eigenen AWS Anmeldeinformationen your_access_key_id and your_secret_access_key.

Installation

QLDBunterstützt die folgenden Java-Treiberversionen und ihre AWS SDK Abhängigkeiten.

Treiberversion	AWS SDK	Status	Datum der letzten Veröffentlichung
1.x	AWS SDK for Java 1.x	Produktionsfreigabe	20. März 2020
2.x	AWS SDK for Java 2.x	Produktionsfreigabe	4. Juni 2021

Um den QLDB Treiber zu installieren, empfehlen wir die Verwendung eines Abhängigkeitsverwaltungssystems wie Gradle oder Maven. Fügen Sie beispielsweise das folgende Artefakt als Abhängigkeit in Ihr Java-Projekt ein.

2.x

Gradle

Fügen Sie diese Abhängigkeit in Ihre build.gradle Konfigurationsdatei ein.

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

Maven

Fügen Sie diese Abhängigkeit in Ihre pom.xml Konfigurationsdatei ein.

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

Dieses Artefakt beinhaltet automatisch das AWS SDK for Java 2.x Kernmodul, Amazon Ion-Bibliotheken und andere erforderliche Abhängigkeiten.

1.x

Gradle

Fügen Sie diese Abhängigkeit in Ihre build.gradle Konfigurationsdatei ein.

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

Maven

Fügen Sie diese Abhängigkeit in Ihre pom.xml Konfigurationsdatei ein.

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

Dieses Artefakt beinhaltet automatisch das AWS SDK for Java Kernmodul, Amazon Ion-Bibliotheken und andere erforderliche Abhängigkeiten.

Wichtig

Amazon Ion-Namespace — Wenn Sie Amazon Ion-Klassen in Ihre Anwendung importieren, müssen Sie das Paket verwenden, das sich unter dem com.amazon.ion Namespace befindet. Das AWS SDK for Java hängt von einem anderen Ion-Paket unter dem Namespace absoftware.amazon.ion, aber das ist ein Legacy-Paket, das nicht mit dem Treiber kompatibel ist. QLDB

Kurze Codebeispiele für die Ausführung grundlegender Datentransaktionen in einem Ledger finden Sie unter. Referenz zum Kochbuch

Andere optionale Bibliotheken

Optional können Sie Ihrem Projekt auch die folgenden nützlichen Bibliotheken hinzufügen. Bei diesen Artefakten handelt es sich um erforderliche Abhängigkeiten in der Java-Lernprogramm Beispielanwendung.

1. aws-java-sdk-qldb— Das QLDB Modul der AWS SDK for Java. Die QLDB unterstützte Mindestversion ist1.11.785.

   Verwenden Sie dieses Modul in Ihrer Anwendung, um direkt mit den in der aufgeführten API Verwaltungsoperationen zu interagierenQLDBAPIAmazon-Referenz.

2. jackson-dataformat-ion— XML Das Jackson-Datenformatmodul von Faster für Ion. Die Beispielanwendung erfordert Version 2.10.0 oder höher.

Gradle

Fügen Sie diese Abhängigkeiten zu Ihrer build.gradle Konfigurationsdatei hinzu.

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

Fügen Sie diese Abhängigkeiten zu Ihrer pom.xml Konfigurationsdatei hinzu.

<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>