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.
QLDBControlador de Amazon para. NET
importante
Aviso de fin de soporte: los clientes actuales podrán usar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre
Para trabajar con los datos de tu libro mayor, puedes conectarte a Amazon QLDB desde tu Microsoft. NETaplicación mediante un controlador AWS proporcionado. El conductor apunta. NETEstándar 2.0. Más específicamente, es compatible. NETCore (LTS) 2.1+ y. NETFramework 4.5.2+. Para obtener información sobre la compatibilidad, consulte. NET
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 temas siguientes se describe cómo empezar a utilizar el QLDB controlador para. NET.
Temas
Recursos de controladores
Para obtener más información sobre las funciones compatibles con. NETcontrolador, consulte los siguientes recursos:
Requisitos previos
Antes de empezar con el QLDB controlador para. NET, debe hacer lo siguiente:
-
Siga las instrucciones de AWS configuración que se indican enAcceder a Amazon QLDB. Esta incluye lo siguiente:
-
Inscríbase en AWS.
-
Cree un usuario con los QLDB permisos adecuados.
-
Conceda acceso programático de desarrollo.
-
-
Descargue e instale el. NETCore SDK versión 2.1 o posterior de Microsoft. NETsitio de descargas
. -
(Opcional) Instale un 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
. -
Configurar el entorno de desarrollo para AWS SDK for .NET
: -
Configure sus AWS credenciales. 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 .
-
Defina su Región de AWS predeterminada. Para saber cómo hacerlo, consulte Selección de Región de AWS.
Para obtener una lista completa de las regiones disponibles, consulta los QLDBpuntos de conexión y las cuotas de Amazon en. Referencia general de AWS
-
A continuación, puede configurar una aplicación de muestra básica y ejecutar ejemplos de código abreviado, o puede instalar el controlador en una existente. NETproyecto.
-
Para instalar el QLDB controlador y el AWS SDK for .NET en un proyecto existente, proceda aInstalación.
-
Para configurar un proyecto y ejecutar ejemplos de códigos cortos que muestren las transacciones de datos básicas en un libro mayor, consulte Tutorial de inicio rápido.
Instalación
Utilice el administrador de NuGet paquetes para instalar el QLDB controlador para. NET. Recomendamos usar Visual Studio o uno IDE de su elección para agregar las dependencias del proyecto. El nombre del paquete de controladores es Amazon. QLDB.Conductor.
Por ejemplo, en Visual Studio, abra la consola NuGet Package Manager 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 los paquetes Amazon Ion y AWS SDK for .NET Amazon.
Instale el mapeador de objetos de Ion
Versión 1.3.0 del controlador para. QLDB NETintroduce la compatibilidad para 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 asignar valores de Ion a CLRobjetos antiguos y simples de C# (POCO) 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 ver una breve guía sobre cómo usar esta biblioteca, consulta el archivo.md en el SERIALIZATION repositorio. GitHub awslabs/amazon-qldb-driver-dotnet
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 mayor, consulte Referencia de libro de recetas.
