Driver Amazon QLDB para Go

Para trabalhar com dados em seu ledger, você pode se conectar ao Amazon QLDB a partir do seu aplicativo Go usando um driver AWS fornecido. Os tópicos a seguir descrevem como começar a usar o driver QLDB para Go.

Tópicos

• Recursos para driver
• Pré-requisitos
• Instalação
• Tutorial de início rápido
• Referência de Cookbook

Recursos para driver

Para obter mais informações sobre a funcionalidade suportada pelo driver Go, consulte os recursos a seguir:

• Referência de API: 3.x, 2.x, 1.x

• Código-fonte do driver (GitHub)

• Cookbook Amazon Ion

Pré-requisitos

Antes de começar a usar o driver QLDB para Go, você deverá fazer o seguinte:

1. Siga as instruções de configuração AWS no Acessar o Amazon QLDB. Essa transmissão inclui o seguinte:

   1. Cadastre-se no AWS.

   2. Crie um usuário com as permissões apropriadas para QLDB.

   3. Conceda acesso programático para desenvolvimento.

2. (Opcional) Instale um ambiente de desenvolvimento integrado (IDE) de sua escolha. Para obter uma lista dos IDEs para Go mais usados, consulte Plug-ins IDEs do editor no site Go.

3. Baixe e instale uma das seguintes versões do Go no site de downloads do Go:

   • 1.15 ou posterior — driver QLDB para Go v3

   • 1.14— driver QLDB para Go v1 ou v2

4. Configure seu ambiente de desenvolvimento para AWS SDK for Go.

   1. Configure suas AWS credenciais. Recomendamos criar um arquivo de credenciais compartilhadas.

      Para obter instruções, consulte Especificação de credenciais no Guia do desenvolvedor do AWS SDK for Go.

   2. Defina seu Região da AWS padrão. Para saber como, consulte Especificando Região da AWS.

      Para obter uma lista completa das regiões disponíveis, consulte endpoints e cotas Amazon QLDB em Referência geral da AWS.

Em seguida, você pode configurar um aplicativo de exemplo básico e executar exemplos de códigos curtos, ou você pode instalar o driver em um projeto Go existente.

• Para instalar o driver QLDB e o AWS SDK for Go em um projeto existente, vá para Instalação.

• Para configurar um projeto e executar exemplos de códigos curtos que demonstram transações básicas de dados em um ledger, consulte o Tutorial de início rápido.

Instalação

O driver QLDB para Go é de código aberto no repositório do GitHub awslabs/amazon-qldb-driver-go. O QLDB suporta as seguintes versões do driver e suas dependências Go.

Versão do driver	Versão Go	Status	Data da versão mais recente
1.x	1.14 ou posterior	Lançamento de produção	16 de junho de 2021
2.x	1.14 ou posterior	Lançamento de produção	21 de julho de 2021
3.x	1.15 ou posterior	Lançamento de produção	10 de novembro de 2022

Para instalar o driver

1. Certifique-se de que seu projeto esteja usando módulos Go para instalar as dependências do projeto.

2. No diretório do seu projeto, insira o seguinte comando go get.

   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

A instalação do driver também instala suas dependências, incluindo AWS SDK for Go ou AWS SDK for Go v2 e os pacotes e Amazon Ion.

Para exemplos de código curto de como executar transações básicas de dados em um ledger, consulte o Referência de Cookbook.