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.
Pilote Amazon QLDB pour .NET
Pour utiliser les données de votre registre, vous pouvez vous connecter à Amazon QLDB depuis votre application Microsoft .NET à l'aide d'un piloteAWS fourni. Le pilote cible .NET Standard 2.0. Plus précisément, il prend en charge .NET Core (LTS) 2.1+ et .NET Framework 4.5.2+. Pour plus d'informations sur la compatibilité, consultez .NET Standard
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 pilote QLDB Driver pour .NET.
Rubriques
Ressources pour les conducteurs ressources
Pour plus d'informations sur les fonctionnalités prises en charge par le pilote .NET, consultez les ressources suivantes :
Prérequis
Avant de commencer à utiliser le pilote QLDB Driver pour .NET, vous devez effectuer les opérations suivantes :
-
Suivez les instructions deAWS configuration dansAccès à Amazon QLDB. Cela inclut les éléments suivants :
-
S'inscrire àAWS.
-
Créer un utilisateur avec les autorisations QLDB appropriées.
-
Accorder un accès par programmation à des fins de développement.
-
-
Téléchargez et installez le SDK .NET Core version 2.1 ou ultérieure à partir du site de téléchargements Microsoft .NET
. -
(Facultatif) Installez l'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 depuis le site Microsoft Visual Studio
. -
Configurez votre environnement de développement pour AWS SDK for .NET
: -
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 Configuration desAWS informations d'identification à l'aide d'un fichier d'informations d'identification dans le Guide duAWS SDK for .NET développeur.
-
Définissez votre valeur par défautRégion AWS. Pour savoir comment procéder, consultez la section Région AWSSélection.
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 .NET existant.
-
Pour installer le pilote QLDB et leAWS SDK for .NET 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 leDdémarrage rapide.
Installation
Utilisez le gestionnaire de NuGet packages pour installer le pilote QLDB pour .NET. Nous vous recommandons d'utiliser Visual Studio ou un IDE de votre choix pour ajouter des dépendances au projet. Le nom du package de pilotes est Amazon.QLDB.Driver
Par exemple, dans Visual Studio, ouvrez la consoleNuGet du gestionnaire de packages dans le menu Outils. À l'PM>invite, entrez la commande suivante.
PM>Install-Package Amazon.QLDB.Driver
L'installation du pilote installe également ses dépendances, notamment les packages Amazon IonAWS SDK for .NET et Amazon.
Installation du mappeur d'objets Ion
La version 1.3.0 du pilote QLDB pour .NET prend en charge l'acceptation et le 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
: bibliothèque capable de mapper des valeurs Ion à de simples objets CLR (POCO) en C#, et inversement. Ce mappeur d'objets Ion permet à votre application d'interagir directement avec des 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érentiel awslabs/amazon-qldb-driver-dotnet.
Pour installer le package, entrez la commande suivante.
PM>Install-Package Amazon.QLDB.Driver.Serialization
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 cuisine.
