.NET et DAX - Amazon DynamoDB

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

.NET et DAX

Procédez comme suit pour exécuter l'exemple .NET sur votre instance Amazon EC2.

Note

Ce didacticiel utilise le kit SDK .NET 6, mais fonctionne également avec le kit SDK .NET Core. Il montre comment exécuter un programme dans votre VPC Amazon par défaut pour accéder à votre cluster Amazon DynamoDB Accelerator (DAX). Si vous préférez, vous pouvez utiliser le AWS Toolkit for Visual Studio pour écrire une application .NET et la déployer dans votre VPC.

Pour plus d'informations, consultez Création et déploiement d'applications Elastic Beanstalk dans .NET à l'aide d' AWS Toolkit for Visual Studio dans le Guide du développeur AWS Elastic Beanstalk .

Pour exécuter l'exemple .NET pour DAX
  1. Accédez à la page Microsoft Downloads et téléchargez le dernier kit SDK .NET 6 (ou .NET Core) 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 : 6.0.100.

  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>net6.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. À présent, exécutez les exemples de programme, un seul à la fois. 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

Pour plus d'informations sur ces programmes, consultez les sections suivantes :