Controlador Amazon QLDB para Go

Para trabajar con los datos de su libro mayor, puede conectarse a Amazon QLDB desde su aplicación Go mediante un controlador proporcionado por AWS. En los siguientes temas se describe cómo empezar a usar el controlador QLDB para Go.

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 las funcionalidades compatibles con el controlador Go, consulte los siguientes recursos:

• Referencia de API: 3.x, 2.x, 1.x

• Código origen del controlador (GitHub)

• Libro de recetas de Amazon Ion

Requisitos previos

Antes de empezar a usar el controlador QLDB para Go, 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. (Opcional) Instale un entorno de desarrollo integrado (IDE) de su elección. Para obtener una lista de los IDE más utilizados para Go, consulte los complementos e IDE del editor en el sitio web de Go.

3. Descargue e instale una de las siguientes versiones de Go desde el sitio de descargas de Go:

   • 1.15 o posterior: controlador de QLDB para Go v3

   • 1.14: controlador de la QLDB para Go v1 o v2

4. Configure el entorno de desarrollo para AWS SDK for Go:

   1. Configure sus credenciales de AWS. Recomendamos crear un archivo de credenciales compartidas.

      Para obtener instrucciones, consulte especificación de credenciales en la Guía para desarrolladores de AWS SDK for Go.

   2. Defina la Región de AWS predeterminada. Para obtener información sobre cómo hacerlo, consulte Especificar la Región de AWS.

      Para ver una lista completa de las regiones disponibles, consulte puntos de conexión y cuotas de Amazon QLDB en 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 Go existente.

• Para instalar el controlador QLDB y AWS SDK for Go en un proyecto existente, acceda a Instalació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

El controlador de la QLDB para Go es de código abierto en el repositorio awslabs/amazon-qldb-driver-go de GitHub. QLDB es compatible con las siguientes versiones de controlador y sus dependencias de Go.

Versión de controlador	Versión de Go	Estado	Fecha de lanzamiento más reciente
1.x	1.14 o posteriores	Lanzamiento de producción	16 de junio de 2021
2.x	1.14 o posteriores	Lanzamiento de producción	21 de julio de 2021
3.x	1.15 o posteriores	Lanzamiento de producción	10 de noviembre de 2022

Para instalar el controlador

1. Asegúrese de que su proyecto utilice los módulos de Go para instalar las dependencias del proyecto.

2. Ejecute el siguiente comando go get en el directorio de su proyecto.

   3.x

   $ go get -u github.com/awslabs/amazon-qldb-driver-go/v3/qldbdriver

   2.x

   $ go get -u github.com/awslabs/amazon-qldb-driver-go/v2/qldbdriver

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

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