.NET e DAX - Amazon DynamoDB

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á.

.NET e DAX

Siga estas etapas para executar o exemplo .NET na sua instância do Amazon EC2.

nota

Este tutorial usa o SDK .NET 6, mas também funciona com o SDK .NET Core. Ele mostra como você pode executar um programa na sua Amazon VPC padrão para acessar seu cluster do Amazon DynamoDB Accelerator (DAX). Se você preferir, pode usar o AWS Toolkit for Visual Studio para escrever um aplicativo .NET e implantá-lo em sua VPC.

Para obter mais informações, consulte Criação e implantação de aplicações do Elastic Beanstalk no .NET usando o AWS Toolkit for Visual Studio no Guia do desenvolvedor do AWS Elastic Beanstalk.

Como executar o exemplo do .NET para o DAX

  1. Acesse a página de downloads da Microsoft e baixe o SDK do .NET 6 (ou .NET Core) para Linux mais recente. O arquivo obtido por download é o dotnet-sdk-N.N.N-linux-x64.tar.gz.

  2. Extraia os arquivos do SDK.

    mkdir dotnet
tar zxvf dotnet-sdk-N.N.N-linux-x64.tar.gz -C dotnet

    Substitua N.N.N pelo número de versão real do SDK do .NET (por exemplo: 6.0.100).

  3. Verifique a instalação.

    alias dotnet=$HOME/dotnet/dotnet
dotnet --version

    Isso deve imprimir o número da versão do SDK .NET.

    nota

    Em vez de obter o número da versão, é possível que você receba o seguinte erro:

    erro: libunwind.so.8: não é possível abrir o arquivo do objeto compartilhado: o arquivo ou diretório não existe

    Para resolver o erro, instale o pacote libunwind.

    sudo yum install -y libunwind

    Depois disso, você deve conseguir executar o comando dotnet --version sem nenhum erro.

  4. Crie um novo projeto .NET.

    dotnet new console -o myApp

    Isso requer alguns minutos para realizar uma one-time-only configuração. Ao concluir, execute o projeto de exemplo.

    dotnet run --project myApp

    Você deverá receber a seguinte mensagem: Hello World!

  5. O arquivo myApp/myApp.csproj contém os metadados do projeto. Para usar o cliente do DAX em sua aplicação, modifique o arquivo para que seja semelhante ao seguinte.

    <Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net6.0</TargetFramework>
    </PropertyGroup>
    <ItemGroup>
        <PackageReference Include="AWSSDK.DAX.Client" Version="*" />
    </ItemGroup>
</Project>

  6. Baixe o código-fonte do programa de exemplo (arquivo .zip).

    wget http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/samples/TryDax.zip

    Quando o download for concluído, extraia os arquivos de origem.

    unzip TryDax.zip

  7. Agora, execute os programas de exemplo, um por vez. Para cada programa, você copiará seu conteúdo em myApp/Program.cs e, seguida, executará o projeto MyApp.

    Execute os seguintes programas .NET. O primeiro programa cria uma tabela do DynamoDB chamada TryDaxTable. O segundo programa grava dados na tabela.

    cp TryDax/dotNet/01-CreateTable.cs myApp/Program.cs
dotnet run --project myApp

cp TryDax/dotNet/02-Write-Data.cs myApp/Program.cs
dotnet run --project myApp

  8. Depois, execute alguns programas para executar as operações GetItem, Query e Scan no cluster do DAX. Para determinar o endpoint do cluster do DAX, escolha uma das seguintes opções:

    • Usando o console do DynamoDB: escolha seu cluster do DAX. O endpoint do cluster é mostrado no console, como no exemplo a seguir.

      dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

    • Usando a AWS CLI: insira o comando a seguir.

      aws dax describe-clusters --query "Clusters[*].ClusterDiscoveryEndpoint"

      O endpoint do cluster é mostrado na saída, como no exemplo a seguir.

      {
    "Address": "my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com",
    "Port": 8111,
    "URL": "dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com"
}

    Agora execute os seguintes programas, especificando o endpoint do cluster como um parâmetro de linha de comando. (Substitua o endpoint de exemplo pelo endpoint do seu cluster do DAX real.)

    cp TryDax/dotNet/03-GetItem-Test.cs myApp/Program.cs
dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

cp TryDax/dotNet/04-Query-Test.cs myApp/Program.cs
dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

cp TryDax/dotNet/05-Scan-Test.cs myApp/Program.cs
dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

    Anote as informações de tempo: o número de milissegundos necessários para os testes GetItem, Query e Scan.

  9. Execute o seguinte programa .NET para excluir a TryDaxTable.

    cp TryDax/dotNet/06-DeleteTable.cs myApp/Program.cs
dotnet run --project myApp

Para obter mais informações sobre esses programas, consulte as seguintes seções: