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á.
Driver Amazon QLDB para .NET
Para trabalhar com dados em seu ledger, você pode se conectar ao Amazon QLDB a partir do seu aplicativo Microsoft .NET usando um driver AWS fornecido. O driver se destina ao .NET Standard 2.0. Mais especificamente, ele suporta o .NET Core (LTS) 2.1+ e o .NET Framework 4.5.2+. Para obter informações sobre compatibilidade, consulte .NET Standard
É 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 driver QLDB para .NET.
Recursos para driver
Para obter mais informações sobre a funcionalidade suportada pelo driver .NET, consulte os recursos a seguir:
Pré-requisitos
Antes de começar a usar o driver QLDB para .NET, você deverá fazer o seguinte:
-
Siga as instruções de configuração AWS no Acessar o Amazon QLDB. Essa transmissão inclui o seguinte:
-
Cadastre-se no AWS.
-
Crie um usuário com as permissões apropriadas para QLDB.
-
Conceda acesso programático para desenvolvimento.
-
-
Baixe e instale o SDK do .NET Core versão 2.1 ou posterior do site de downloads Microsoft.NET
. -
(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
. -
Configure seu ambiente de desenvolvimento para AWS SDK for .NET
. -
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 AWS SDK for .NET..
-
Defina seu 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 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 .NET existente.
-
Para instalar o driver QLDB e o AWS SDK for .NET 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
Use o gerenciador de pacotes NuGet para instalar o driver QLDB para .NET. Recomendamos usar o Visual Studio ou um IDE de sua escolha para adicionar dependências ao seu projeto. O nome do pacote do driver é Amazon.QLDB.Driver
Por exemplo, no Visual Studio, abra o Console do Gerenciador de pacotes NuGet no menu Ferramentas. 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 AWS SDK for .NET e Amazon Ion.
Instale o mapper de objetos Ion
A versão 1.3.0 do driver QLDB para .NET introduz suporte para aceitar e retornar tipos de dados C# nativos sem a necessidade de trabalhar com o Amazon Ion. Para usar esse recurso, adicione o seguinte pacote ao seu projeto.
-
Amazon.Qldb.Driver.Serialization
— Uma biblioteca que pode mapear valores de Ion para objetos CLR simples e antigos (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 arquivo SERIALIZATION.md no repositório do GitHub. awslabs/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.
