Pilote Amazon QLDB pour Go

Pour utiliser les données de votre registre, vous pouvez vous connecter à Amazon QLDB depuis votre application Go à l'aide d'un piloteAWS fourni. Les rubriques suivantes décrivent comment installer le pilote QLDB pour Go.

Rubriques

• Ressources pour les conducteurs
• Prérequis
• Installation
• Didacticiel de démarrage rapide
• Référence de livre de recettes

Ressources pour les conducteurs

Pour plus d'informations sur les fonctionnalités prises en charge par le pilote Go, consultez les ressources suivantes :

• Référence de l'API : 3.x, 2.x, 1.x

• Code source du pilote (GitHub)

• Livre de recettes Amazon Ion

Prérequis

Avant de démarrer le pilote QLDB pour Go, vous devez effectuer les opérations suivantes :

1. Suivez les instructions deAWS configuration dansAccès à Amazon QLDB. Cela inclut les éléments suivants :

   1. Inscrivez-vous àAWS.

   2. Créez un utilisateur avec les autorisations QLDB appropriées.

   3. Accorder un accès par programmation.

2. (Facultatif) Installez l'environnement de développement intégré (IDE) de votre choix. Pour obtenir la liste des IDE couramment utilisés pour Go, consultez la section Plug-ins et IDE de l'éditeur sur le site Web de Go.

3. Téléchargez et installez l'une des versions suivantes de Go à partir du site de téléchargement de Go :

   • 1.15 ou version ultérieure — pilote QLDB pour Go v3

   • 1.14 — Pilote QLDB pour Go v1 ou v2

4. Configurez votre environnement de développement pour AWS SDK for Go:

   1. Configurez vosAWS informations d'identification. Nous vous recommandons de créer un fichier d'informations d'identification partagées.

      Pour obtenir des instructions, consultez la section Spécification des informations d'identification dans le Guide duAWS SDK for Go développeur.

   2. Définissez votre valeur par défautRégion AWS. Pour savoir comment procéder, voir Spécifier leRégion AWS.

      Pour obtenir la liste complète des régions disponibles, consultez les points de terminaison et les quotas Amazon QLDB dans le Références générales AWS.

Vous pouvez ensuite configurer un exemple d'application de base et exécuter des exemples de code abrégé, ou vous pouvez installer le pilote dans un projet Go existant.

• Pour installer le pilote QLDB et leAWS SDK for Go dans un projet existant, passez àInstallation.

• Pour configurer un projet et exécuter des exemples de code abrégé illustrant les transactions de données de base sur un registre, consultez leDidacticiel de démarrage rapide.

Installation

Le pilote QLDB pour Go est open source dans le GitHub référentiel awslabs/amazon-qldb-driver-go. QLDB prend en charge les versions de pilotes suivantes et leurs dépendances à Go.

Versions du pilote	Version Go	État	Dernière date de parution
1.x	1.14 ou version ultérieure	Version de production	16 juin 2021
2.x	1.14 ou version ultérieure	Version de production	21 juillet 2021
3.x	1.15 ou version ultérieure	Version de production	10 novembre 2022

Pour installer le pilote

1. Assurez-vous que votre projet utilise des modules Go pour installer les dépendances du projet.

2. Dans le répertoire de votre projet, entrez lago get commande suivante.

   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

L'installation du pilote installe également ses dépendances, notamment les packages AWS SDK for Goor AWS SDK for Gov2 et Amazon Ion.

Pour des exemples de code courts expliquant comment exécuter des transactions de données de base sur un registre, consultez leRéférence de livre de recettes.