.NET e DAX

Como executar o exemplo do .NET para o DAX

1. Acesse a página Downloads da Microsoft e baixe o SDK do .NET 9 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: 9.0.305).

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 

   Ele levará alguns minutos executando uma configuração isolada. 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>net9.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 de dotNet, 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