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 controlador proporcionado por AWS. El controlador está orientado 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 más información sobre la compatibilidad, consulte .NET Standard en el sitio de Microsoft Docs.

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

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

Temas

• Recursos de controladores
• Requisitos previos
• Instalación
• Tutorial de inicio rápido
• Referencia de libro de recetas

Recursos de controladores

Para obtener más información sobre la funcionalidad compatible con el controlador .Net, consulte los siguientes recursos:

• Referencia de la API

• Código fuente del controlador (GitHub)

• Ejemplo de código fuente de aplicación (GitHub)

• Libro de recetas de Amazon Ion

• Mapeador de objetos de Ion (GitHub)

Requisitos previos

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

1. Siga las instrucciones de configuración de AWS en Acceso a Amazon QLDB. Estas incluyen las siguientes:

   1. Regístrese en AWS.

   2. Cree un usuario con los permisos de QLDB adecuados.

   3. Conceda acceso programático de 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. Configurar el entorno de desarrollo para AWS SDK for .NET:

   1. Configuración de sus credenciales de AWS Recomendamos crear un archivo de credenciales compartidas.

      Para obtener más instrucciones, consulte Configurar credenciales de AWS mediante un archivo de credenciales en la Guía para desarrolladores de AWS SDK for .NET.

   2. Defina su Región de AWS predeterminada. Para saber cómo hacerlo, consulte Selección de Región de AWS.

      Para obtener una lista de las regiones disponibles, consulte Puntos de conexión y cuotas de Amazon QLDB en la Referencia general de AWS.

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

• Para instalar el controlador QLDB y el AWS SDK for .NET en un proyecto existente, proceda con Instalación.

• Para configurar un proyecto y ejecutar ejemplos de códigos cortos que muestren transacciones de datos básicas en un libro mayor, consulte Tutorial de inicio rápido.

Instalación

Use el administrador de paquetes NuGet para instalar el controlador QLDB para .NET. Recomendamos usar Visual Studio o el IDE de su elección para agregar las dependencias del proyecto. El nombre del paquete de controlador es Amazon.QLDB.Driver.

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

PM> Install-Package Amazon.QLDB.Driver

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

Instale el mapeador de objetos de Ion

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 usar esta característica, añada el siguiente paquete a su proyecto.

• Amazon.QLDB.Driver.Serialization: una biblioteca que puede mapear valores de Ion a objetos CLR antiguos simples (POCO) de C# y viceversa. Este mapeador de objetos de Ion permite que su aplicación interactúe directamente con los tipos de datos nativos de C# sin que tenga que trabajar con Ion. Para consultar una breve guía sobre cómo usar esta biblioteca, acceda al archivo SERIALIZATION.md en el repositorio awslabs/amazon-qldb-driver-dotnet de GitHub.

Para instalar este paquete, introduzca el comando siguiente.

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

Para ver ejemplos de códigos cortos sobre cómo ejecutar transacciones de datos básicos en un libro de contabilidad, consulte Referencia de libro de recetas.