Controlador Amazon QLDB para .NET - Amazon Quantum Ledger Database (Amazon QLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Controlador Amazon QLDB para .NET

Para trabajar con los datos de su libro mayor, puede conectarse a Amazon QLDB desde su aplicación Microsoft .NET mediante un controladorAWS proporcionado. El controlador apunta a .NET Standard 2.0. Más específicamente, es compatible con .NET Core (LTS) 2.1+ y .NET Framework 4.5.2+. Para obtener información sobre la compatibilidad, consulte .NET Standard en el sitio de Microsoft Docs.

Recomendamos encarecidamente utilizar el mapeador de objetos Ion para evitar por completo la necesidad de realizar conversiones manuales entre los tipos de Amazon Ion y los tipos nativos de C#.

En los siguientes temas se describe cómo empezar a utilizar el controlador QLDB para .NET.

Recursos para el controlador

Para obtener más información acerca de la funcionalidad que admite el controlador .NET, consulte los siguientes recursos:

Requisitos previos

Antes de empezar a utilizar el controlador QLDB para .NET, debe hacer lo siguiente:

  1. Siga las instruccionesAWS de configuración que aparecen enAcceso a Amazon QLDB. Estas incluyen las siguientes:

    1. Registrarse enAWS.

    2. Cree un usuarioAWS Identity and Access Management (IAM) con los permisos de QLDB adecuados.

    3. Obtenga una clave de acceso IAM para el desarrollo.

  2. Descargue e instale la versión 2.1 o posterior del SDK de .NET Core desde el sitio de descargas de Microsoft .NET.

  3. (Opcional) Instale el entorno de desarrollo integrado (IDE) de su elección, como Visual Studio, Visual Studio para Mac o Visual Studio Code. Puede descargarlos desde el sitio de Microsoft Visual Studio.

  4. Configure su entorno de desarrollo para AWS SDK for .NET:

    1. Configura tusAWS credenciales. Se recomienda crear un archivo de credenciales compartidas.

      Para obtener instrucciones, consulte Configuración deAWS credenciales mediante un archivo de credenciales en la Guía paraAWS SDK for .NET desarrolladores.

    2. Establece tu configuración predeterminadaRegión de AWS. Para saber cómo hacerlo, consulte la sección Región de AWSde selección.

      Para obtener una lista completa de las regiones disponibles, consulte los puntos de enlace y las cuotas de Amazon QLDB en la ReferenciaAWS general.

A continuación, puede configurar una aplicación de ejemplo básica y ejecutar ejemplos de código cortos, o puede instalar el controlador en un proyecto .NET existente.

  • Para instalar el controlador QLDB y elAWS SDK for .NET en un proyecto existente, vaya aInstalación.

  • Para configurar un proyecto y ejecutar ejemplos de código cortos que demuestren las transacciones de datos básicas en un libro mayor, consulte laTutorial de inicio rápido.

Instalación

Utilice el administrador de NuGet paquetes para instalar el controlador QLDB para .NET. Le recomendamos que utilice Visual Studio o un IDE de su elección para añadir dependencias al proyecto. El nombre del paquete de controladores es Amazon.qldb.driver.

Por ejemplo, en Visual Studio, abra la consolaNuGet del administrador de paquetes en el menú Herramientas. A continuación ingrese el comando siguiente en elPM> símbolo del sistema.

PM> Install-Package Amazon.QLDB.Driver

Al instalar el controlador también se instalan sus dependencias, incluidos los paquetes Amazon IonAWS SDK for .NET y Amazon Ion.

Instale el mapeador de objetos iónicos

La versión 1.3.0 del controlador QLDB para .NET permite aceptar y devolver tipos de datos nativos de C# sin necesidad de trabajar con Amazon Ion. Para utilizar esta función, añada el siguiente paquete a su proyecto.

  • Amazon.qldb.driver.Serialization: una biblioteca que puede asignar valores de Ion a objetos CLR (POCO) simples y antiguos de C# y viceversa. Esto permite que su aplicación interactúe directamente con los tipos de datos nativos de C# sin necesidad de trabajar con Ion. Para obtener una guía breve sobre cómo usar esta biblioteca, consulte el archivo Serialization.md del GitHub repositorioawslabs/amazon-qldb-driver-dotnet.

Para instalar este paquete ingrese el comando siguiente:

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

Para ver ejemplos de código cortos sobre cómo ejecutar transacciones de datos básicos en un libro mayor, consulte laReferencia de los libros de recetas.