Java et DAX

Le kit SDK DAX pour Java 2.x est compatible avec le Kit SDK AWS for Java 2.x. Il repose sur Java 8+ et inclut la prise en charge des I/O non bloquantes. Pour plus d'informations sur l'utilisation de DAX avec le kit SDK AWS pour Java 1.x, consultez Utilisation de DAX avec le kit SDK AWS pour Java 1.x

Utilisation du client en tant que dépendance Maven

Suivez la procédure pour utiliser le client pour le kit SDK DAX pour Java dans votre application comme dépendance.

1. Téléchargez et installez Apache Maven. Pour plus d'informations, consultez Downloading Apache Maven et Installing Apache Maven.

2. Ajoutez la dépendance de client Maven au fichier POM (Project Object Model) de votre application. Dans l'exemple, remplacez x.x.x par le numéro de version réel du client.

   <!--Dependency:-->
   <dependencies>
       <dependency>
           <groupId>software.amazon.dax</groupId>
           <artifactId>amazon-dax-client</artifactId>
           <version>x.x.x</version>
       </dependency>
   </dependencies>

TryDax exemple de code

Après avoir configuré votre espace de travail et ajouté le kit SDK DAX en tant que dépendance, copiez TryDax.java dans votre projet.

Exécutez le code à l'aide de cette commande.

java -cp classpath TryDax

Vous devez visualiser des résultats similaires à ce qui suit.

Creating a DynamoDB client

Attempting to create table; please wait...
Successfully created table.  Table status: ACTIVE
Writing data to the table...
Writing 10 items for partition key: 1
Writing 10 items for partition key: 2
Writing 10 items for partition key: 3
...

Running GetItem and Query tests...
First iteration of each test will result in cache misses
Next iterations are cache hits

GetItem test - partition key 1-100 and sort keys 1-10
  Total time: 4390.240 ms - Avg time: 4.390 ms
  Total time: 3097.089 ms - Avg time: 3.097 ms
  Total time: 3273.463 ms - Avg time: 3.273 ms
  Total time: 3353.739 ms - Avg time: 3.354 ms
  Total time: 3533.314 ms - Avg time: 3.533 ms
Query test - partition key 1-100 and sort keys between 2 and 9
  Total time: 475.868 ms - Avg time: 4.759 ms
  Total time: 423.333 ms - Avg time: 4.233 ms
  Total time: 460.271 ms - Avg time: 4.603 ms
  Total time: 397.859 ms - Avg time: 3.979 ms
  Total time: 466.644 ms - Avg time: 4.666 ms

Attempting to delete table; please wait...
Successfully deleted table.

Notez les informations de durée, soit le nombre de millisecondes requis pour les tests GetItem et Query. Dans ce cas, vous avez exécuté le programme par rapport au point de terminaison DynamoDB. Vous allez maintenant réexécuter le programme mais, cette fois, par rapport à votre cluster DAX.

Pour déterminer le point de terminaison de votre cluster DAX, choisissez l'une des options suivantes :

• Sur la console DynamoDB, sélectionnez 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

• A l'aide de AWS CLI, entrez la commande suivante :

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

  L'adresse, le port et l'URL du point de terminaison de cluster apparaissent 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"
  }

Maintenant, réexécutez le programme mais, cette fois, spécifiez l'URL du point de terminaison du cluster en tant que paramètre de ligne de commande.

java -cp classpath TryDax dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com

Examinez la sortie et notez les informations de durée. Les durées d'exécution des opérations GetItem et Query devraient être sensiblement plus courtes avec DAX qu'avec DynamoDB.

Métriques SDK

Avec le SDK DAX pour Java 2.x, vous pouvez collecter des métriques sur les clients du service dans votre application et analyser les résultats sur Amazon. CloudWatch Pour plus d'informations, consultez Activer les métriques du kit SDK.

Note

Le kit SDK DAX pour Java collecte uniquement les métriques ApiCallSuccessful et ApiCallDuration.