QLDBAmazon-Treiber für Go

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 Go-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 Go beschrieben.

Themen

• Ressourcen für Treiber
• Voraussetzungen
• Installation
• Schnellstart-Tutorial
• Referenz zum Kochbuch

Ressourcen für Treiber

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

• APIReferenz: 3.x, 2.x, 1.x

• Treiber-Quellcode () GitHub

• Amazon Ion Cookbook

Voraussetzungen

Bevor Sie mit dem QLDB Treiber für Go 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. (Optional) Installieren Sie eine integrierte Entwicklungsumgebung (IDE) Ihrer Wahl. Eine Liste der häufig IDEs für Go verwendeten Plugins finden Sie unter Editor-Plugins und IDEs auf der Go-Website.

3. Laden Sie eine der folgenden Versionen von Go von der Go-Download-Website herunter und installieren Sie sie:

   • 1.15 oder höher — QLDB Treiber für Go v3

   • 1.14 — QLDB Treiber für Go v1 oder v2

4. Konfigurieren Sie die Entwicklungsumgebung für das AWS SDK for Go:

   1. Richten Sie Ihre AWS Anmeldeinformationen ein. Wir empfehlen, eine gemeinsame Anmeldeinformationsdatei zu erstellen.

      Eine Anleitung dazu finden Sie im AWS SDK for Go Entwicklerhandbuch unter Angeben von Anmeldeinformationen.

   2. Stellen Sie Ihre Standardeinstellung ein AWS-Region. Wie das geht, erfahren Sie unter Spezifizieren von AWS-Region.

      Eine vollständige Liste der verfügbaren Regionen finden Sie unter QLDBAmazon-Endpunkte und Kontingente in der Allgemeine AWS-Referenz.

Als Nächstes können Sie eine einfache Beispielanwendung einrichten und kurze Codebeispiele ausführen — oder Sie können den Treiber in einem vorhandenen Go-Projekt installieren.

• Um den QLDB Treiber und den AWS SDK for Go 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

Installation

Der QLDB Treiber für Go ist Open Source im GitHub Repository awslabs/ amazon-qldb-driver-go. QLDBunterstützt die folgenden Treiberversionen und ihre Go-Abhängigkeiten.

Treiberversion	Go-Version	Status	Neuestes Veröffentlichungsdatum
1.x	1.14 oder später	Produktionsfreigabe	16. Juni 2021
2.x	1.14 oder später	Produktionsfreigabe	21. Juli 2021
3.x	1.15 oder später	Produktionsfreigabe	10. November 2022

Um den Treiber zu installieren

1. Stellen Sie sicher, dass Ihr Projekt Go-Module verwendet, um Projektabhängigkeiten zu installieren.

2. Geben Sie in Ihrem Projektverzeichnis den folgenden go get Befehl ein.

   3.x

   $ go get -u github.com/awslabs/amazon-qldb-driver-go/v3/qldbdriver

   2.x

   $ go get -u github.com/awslabs/amazon-qldb-driver-go/v2/qldbdriver

Durch die Installation des Treibers werden auch seine Abhängigkeiten installiert, einschließlich der Pakete AWS SDK for Gooder AWS SDK for Go v2 und Amazon Ion.

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