Utilisation de Spring Data avec Azure Cosmos DB pour Apache Cassandra

Cet article explique comment utiliser Spring Data avec Azure Cosmos DB pour Apache Cassandra afin de créer un exemple d’application Java qui stocke et récupère des données.

Conditions préalables

• Un abonnement Azure - en créer un gratuitement.

• kit de développement Java (JDK), version 8 ou ultérieure.

• Apache Maven.

• Azure CLI.

• Un client Git.

• cURL ou un utilitaire HTTP similaire pour tester les fonctionnalités.

Créer un compte Azure Cosmos DB

La procédure suivante crée et configure un compte Azure Cosmos DB dans le portail Azure.

Créer un compte Azure Cosmos DB à l’aide du portail Azure

1. Accédez au portail Azure à https://portal.azure.com/ et connectez-vous.

2. Sélectionnez Créer une ressource, sélectionnez Prise en main, puis Azure Cosmos DB.

3. Dans l’écran Sélectionner une option d’API, sélectionnez Cassandra.

   

4. Spécifiez les informations suivantes :

   • Abonnement: spécifiez votre abonnement Azure à utiliser.
   • Groupe de ressources : spécifiez s’il faut créer un groupe de ressources ou choisir un groupe de ressources existant.
   • Nom du compte : choisissez un nom unique pour votre compte Azure Cosmos DB. Ce nom est utilisé pour créer un nom de domaine complet comme wingtiptoyscassandra.documents.azure.com.
   • API: spécifiez Cassandra pour ce didacticiel.
   • emplacement: spécifiez la région géographique la plus proche de votre base de données.

   

5. Lorsque vous entrez toutes les informations précédentes, sélectionnez Vérifier + créer.

6. Si tout semble correct sur la page de révision, sélectionnez Créer.

Le déploiement de la base de données prend quelques minutes.

Ajouter un espace de clés à votre compte Azure Cosmos DB

1. Accédez au portail Azure à https://portal.azure.com/ et connectez-vous.

2. Sélectionnez Toutes les ressources, puis sélectionnez le compte Azure Cosmos DB que vous avez créé.

3. Sélectionnez Data Explorer, sélectionnez la flèche vers le bas, puis sélectionnez Nouvel espace de clés. Entrez un identificateur unique pour votre ID Keyspace, puis sélectionnez OK.

   

   

Récupérer les paramètres de connexion de votre compte Azure Cosmos DB

1. Accédez au portail Azure à https://portal.azure.com/ et connectez-vous.

2. Sélectionnez Toutes les ressources, puis sélectionnez le compte Azure Cosmos DB que vous avez créé.

3. Sélectionnez les chaînes de connexion, puis copiez les valeurs des champs Point de contact, Port, Nom d’utilisateur et Mot de passe principal . Vous utilisez ces valeurs pour configurer votre application ultérieurement.

   

Configurer l’exemple d’application

La procédure suivante configure l’application de test.

1. Ouvrez un interpréteur de commandes et clonez l’exemple de projet à l’aide d’une commande Git comme dans l’exemple suivant :

   git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
   

2. Recherchez le fichier application.properties dans les ressources répertoire de l’exemple de projet, ou créez le fichier s’il n’existe pas déjà.

3. Ouvrez le fichier application.properties dans un éditeur de texte, puis ajoutez ou configurez les lignes suivantes dans le fichier, puis remplacez les exemples de valeurs par les valeurs appropriées précédemment :

   spring.data.cassandra.contact-points=wingtiptoyscassandra.cassandra.cosmos.azure.com
   spring.data.cassandra.port=10350
   spring.data.cassandra.username=wingtiptoyscassandra
   spring.data.cassandra.password=********
   

   Où:

   Paramètre	Descriptif
   spring.data.cassandra.contact-points	Spécifie le point de contact mentionné plus haut dans cet article.
   spring.data.cassandra.port	Spécifie le port mentionné précédemment dans cet article.
   spring.data.cassandra.username	Spécifie le nom d’utilisateur mentionné plus haut dans cet article.
   spring.data.cassandra.password	Spécifie le mot de passe principal mentionné plus haut dans cet article.

4. Enregistrez et fermez le fichier application.properties.

Empaqueter et tester l’exemple d’application

Accédez au répertoire qui contient le fichier pom.xml pour générer et tester l’application.

1. Générez l’exemple d’application avec Maven ; par exemple:

   mvn clean package
   

2. Démarrez l’exemple d’application ; par exemple:

   java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
   

3. Créez de nouveaux enregistrements à l’aide curl d’une invite de commandes. Les exemples suivants montrent comment créer des enregistrements :

   curl -s -d "{\"name\":\"dog\",\"species\":\"canine\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   
   curl -s -d "{\"name\":\"cat\",\"species\":\"feline\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   

   Votre application doit retourner des valeurs comme l’exemple suivant :

   Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.
   
   Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.
   

4. Récupérez tous les enregistrements existants à l’aide curl d’une invite de commandes. Les exemples suivants montrent comment récupérer des enregistrements :

   curl -s http://localhost:8080/pets
   

   Votre application doit retourner des valeurs comme les exemples suivants :

   [{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]
   

Résumé

Dans ce tutoriel, vous avez créé un exemple d’application Java qui utilise Spring Data pour stocker et récupérer des informations à l’aide de Azure Cosmos DB pour Apache Cassandra.

Nettoyer les ressources

Lorsque vous n’avez plus besoin des ressources, utilisez le portail Azure pour les supprimer. La suppression des ressources vous permet d’éviter des frais inattendus.

Étapes suivantes

Pour en savoir plus sur Spring et Azure, passez au centre de documentation Spring sur Azure.

Voir aussi

Pour plus d’informations sur l’utilisation d’Azure avec Java, consultez les Azure for Java Developers et les Working with Azure DevOps and Java.