.NET et DAX

Pour exécuter l’exemple .NET pour DAX

1. Accédez à la page des téléchargements Microsoft et téléchargez le dernier SDK .NET 9 pour Linux. Le fichier téléchargé est dotnet-sdk-N.N.N-linux-x64.tar.gz.

2. Extrayez les fichiers du kit SDK.

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

   Remplacez N.N.N par le numéro de version réel du kit SDK .NET, par exemple : 9.0.305.

3. Vérifiez l’installation.

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

   Le numéro de version du kit SDK .NET doit alors s’imprimer.

   Note

   Au lieu du numéro de version, vous pouvez recevoir l’erreur suivante :

   erreur : libunwind.so.8 : impossible d’ouvrir le fichier objet partagé: Fichier ou répertoire inexistant

   Pour résoudre l’erreur, installez le package libunwind.

   sudo yum install -y libunwind

   Une fois que vous avez terminé, vous devez pouvoir exécuter la commande dotnet --version sans erreur.

4. Crée un projet .NET.

   dotnet new console -o myApp 

   Cela nécessite quelques minutes pour effectuer une one-time-only configuration. Une fois l’opération terminée, exécutez l’exemple de projet.

   dotnet run --project myApp

   Vous devriez recevoir le message suivant : Hello World!

5. Le fichier myApp/myApp.csproj contient les métadonnées de votre projet. Pour utiliser le client DAX dans votre application, modifiez le fichier de telle sorte qu’il ressemble à ceci.

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

6. Téléchargez le code source de l’exemple de programme (fichier .zip).

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

   Une fois le téléchargement terminé, extrayez les fichiers source.

   unzip TryDax.zip

7. Exécutez maintenant les exemples de programmes de DotNet, un par un. Pour chaque programme, copiez son contenu dans le fichier myApp/Program.cs, puis exécutez le projet MyApp.

   Exécutez les programmes .NET suivants. Le premier programme crée une table DynamoDB nommée TryDaxTable. Le deuxième programme écrit des données dans la table.

   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. Ensuite, exécutez certains programmes pour effectuer les opérations GetItem, Query et Scan sur votre cluster DAX. Pour déterminer le point de terminaison de votre cluster DAX, choisissez l’une des options suivantes :

   • Utilisation de la console DynamoDB – Choisissez votre cluster DAX. Le point de terminaison du cluster s’affiche dans la console, comme dans l’exemple suivant.

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

   • À l'aide de AWS CLI— Entrez la commande suivante.

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

     Le point de terminaison du cluster apparaît dans la sortie, comme dans l’exemple suivant.

     {
         "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"
     }

   À présent, exécutez les programmes suivants, en spécifiant le point de terminaison de votre cluster comme paramètre de ligne de commande. (Remplacez l’exemple de point de terminaison par le point de terminaison réel de votre cluster DAX.)

   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

   Notez les informations de durée, soit le nombre de millisecondes requis pour les tests GetItem, Query et Scan.

9. Exécutez le programme .NET suivant pour supprimer TryDaxTable.

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