Amazon QLDB Driver pour. NET - Base de données Amazon Quantum Ledger (AmazonQLDB)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Amazon QLDB Driver pour. NET

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

Pour utiliser les données de votre registre, vous pouvez vous connecter à Amazon QLDB depuis votre Microsoft. NETapplication à l'aide d'un pilote AWS fourni. Le conducteur cible. NETNorme 2.0. Plus précisément, il soutient. NETCore (LTS) 2.1+ et. NETCadre 4.5.2+. Pour plus d'informations sur la compatibilité, consultez. NETStandard sur le site Microsoft Docs.

Nous vous recommandons vivement d'utiliser le mappeur d'objets Ion pour éviter complètement de devoir effectuer une conversion manuelle entre les types Amazon Ion et les types C# natifs.

Les rubriques suivantes décrivent comment démarrer avec le QLDB pilote pour. NET.

Ressources pour les conducteurs

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

Prérequis

Avant de commencer avec le QLDB pilote pour. NET, vous devez effectuer les opérations suivantes :

  1. Suivez les instructions AWS de configuration indiquées dansAccès à Amazon QLDB. Cela inclut les éléments suivants :

    1. Inscrivez-vous pour AWS.

    2. Créez un utilisateur doté des QLDB autorisations appropriées.

    3. Accordez un accès programmatique pour le développement.

  2. Téléchargez et installez le. NETCore SDK version 2.1 ou ultérieure de Microsoft. NETsite de téléchargements.

  3. (Facultatif) Installez un environnement de développement intégré (IDE) de votre choix, tel que Visual Studio, Visual Studio pour Mac ou Visual Studio Code. Vous pouvez les télécharger sur le site de Microsoft Visual Studio.

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

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

      Pour obtenir des instructions, consultez la section Configuration des AWS informations d'identification à l'aide d'un fichier d'informations d'identification dans le Guide du AWS SDK for .NET développeur.

    2. Définissez votre valeur par défaut Région AWS. Pour savoir comment procéder, consultez la section Région AWS Sélection.

      Pour obtenir la liste complète des régions disponibles, consultez la section QLDBPoints de terminaison et quotas Amazon 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 une application existante. NETprojet.

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

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

Installation

Utilisez le gestionnaire de NuGet packages pour installer le QLDB pilote pour. NET. Nous vous recommandons d'utiliser Visual Studio ou un autre IDE de votre choix pour ajouter des dépendances au projet. Le nom du package de pilotes est Amazon. QLDB.Chauffeur.

Par exemple, dans Visual Studio, ouvrez la console NuGet Package Manager dans le menu Outils. Entrez ensuite la commande suivante à l'PM>invite.

PM> Install-Package Amazon.QLDB.Driver

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

Installation du mappeur d'objets Ion

Version 1.3.0 du QLDB pilote pour. NETintroduit la prise en charge de l'acceptation et du renvoi de types de données C# natifs sans qu'il soit nécessaire de travailler avec Amazon Ion. Pour utiliser cette fonctionnalité, ajoutez le package suivant à votre projet.

  • Amazon. QLDB.Driver.Serialization — Une bibliothèque qui peut mapper les valeurs Ion à de vieux CLR objets ordinaires en C# (POCO), et inversement. Ce mappeur d'objets Ion permet à votre application d'interagir directement avec les types de données C# natifs sans avoir à travailler avec Ion. Pour un bref guide sur l'utilisation de cette bibliothèque, consultez le fichier SERIALIZATION.md dans le GitHub référentielawslabs/amazon-qldb-driver-dotnet.

Pour installer ce package, entrez la commande suivante.

PM> Install-Package Amazon.QLDB.Driver.Serialization

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