QLDBDriver da Amazon para. NET - Banco de dados Amazon Quantum Ledger (AmazonQLDB)
Recursos para driverPré-requisitosInstalação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

QLDBDriver da Amazon para. NET

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

Para trabalhar com dados em seu livro contábil, você pode se conectar à Amazon QLDB usando seu Microsoft. NETaplicativo usando um driver AWS fornecido. Os alvos do motorista. NETPadrão 2.0. Mais especificamente, ele suporta. NETCore (LTS) 2.1+ e. NETEstrutura 4.5.2+. Para obter informações sobre compatibilidade, consulte. NETPadrão no site do Microsoft Docs.

É altamente recomendável usar o mapeador de objetos Ion para ignorar completamente a necessidade de conversão manual entre tipos Amazon Ion e tipos nativos de C#.

Os tópicos a seguir descrevem como começar a usar o QLDB driver do. NET.

Tópicos

Recursos para driver

Para obter mais informações sobre a funcionalidade suportada pelo. NETmotorista, consulte os seguintes recursos:

Pré-requisitos

Antes de começar com o QLDB driver do. NET, você deve fazer o seguinte:

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

    1. Inscreva-se em AWS.

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

    3. Conceda acesso programático para desenvolvimento.

  2. Baixe e instale o. NETCore SDK versão 2.1 ou posterior da Microsoft. NETsite de downloads.

  3. (Opcional) Instale um ambiente de desenvolvimento integrado (IDE) de sua escolha, como Visual Studio, Visual Studio para Mac ou Visual Studio Code. Você pode baixá-los do site do Microsoft Visual Studio.

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

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

      Para obter instruções, consulte Como configurar credenciais AWS usando um arquivo de credenciais no Guia do desenvolvedor do AWS SDK for .NET .

    2. Defina sua Região da AWS padrão. Para saber como, consulte seleção Região da AWS.

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

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

  • Para instalar o QLDB driver e o AWS SDK for .NET em um projeto existente, vá paraInstalaçã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

Use o gerenciador de NuGet pacotes para instalar o QLDB driver para. NET. Recomendamos usar o Visual Studio ou um IDE de sua escolha para adicionar dependências do projeto. O nome do pacote do driver é Amazon. QLDB.Motorista.

Por exemplo, no Visual Studio, abra o NuGet Package Manager Console no menu Tools. Então, digite o seguinte comando no PM> prompt:

PM> Install-Package Amazon.QLDB.Driver

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

Instale o mapper de objetos Ion

Versão 1.3.0 do QLDB driver para. NETintroduz suporte para aceitar e retornar tipos de dados C# nativos sem a necessidade de trabalhar com o Amazon Ion. Para usar esse atributo, adicione o seguinte pacote ao seu projeto.

  • Amazon. QLDB.Driver.Serialization — Uma biblioteca que pode mapear valores de íons para CLRobjetos antigos simples (POCO) em C# e vice-versa. Esse mapper de objetos Ion permite que seu aplicativo interaja diretamente com os tipos de dados C# nativos sem a necessidade de trabalhar com o Ion. Para obter um breve guia sobre como usar essa biblioteca, consulte o SERIALIZATIONarquivo.md no GitHub repositórioawslabs/amazon-qldb-driver-dotnet.

Para instalar esse pacote, insira o seguinte comando:

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

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