Come usare Spring Data con Azure Cosmos DB per Apache Cassandra

Questo articolo illustra come usare Spring Data con Azure Cosmos DB per Apache Cassandra per creare un'applicazione di esempio Java che archivia e recupera i dati.

Prerequisiti

• Una sottoscrizione di Azure: crearne una gratuitamente.

• Java Development Kit (JDK), versione 8 o successiva.

• Apache Maven.

• Interfaccia della riga di comando di Azure.

• Un client Git.

• cURL o un'utilità HTTP simile per testare la funzionalità.

Creare un account Azure Cosmos DB

La procedura seguente crea e configura un account Azure Cosmos DB nel portale di Azure.

Creare un account Azure Cosmos DB usando il portale di Azure

Nota

Per altre informazioni sulla creazione di account, vedere la documentazione Azure Cosmos DB.

1. Navigare al portale di Azure all'indirizzo https://portal.azure.com/ e accedere.

2. Selezionare Crea una risorsa, iniziare e quindi selezionare Azure Cosmos DB.

3. Nella schermata selezionare l'opzione Seleziona API selezionare Cassandra.

   

4. Specificare le informazioni seguenti:

   • Sottoscrizione: Specifica la sottoscrizione di Azure da usare.
   • Gruppo di risorse: specificare se creare un nuovo gruppo di risorse o scegliere un gruppo di risorse esistente.
   • Nome account: scegliere un nome univoco per l'account Azure Cosmos DB. Questo nome viene usato per creare un nome di dominio completo, ad esempio wingtiptoyscassandra.documents.azure.com.
   • API: specificare Cassandra per questa esercitazione.
   • Località: Specifica l'area geografica più vicina per il tuo database.

   

5. Quando si immettono tutte le informazioni precedenti, selezionare Rivedi e crea.

6. Se tutti gli elementi sono corretti nella pagina di revisione, selezionare Crea.

La distribuzione del database richiede alcuni minuti.

Aggiungere un keyspace all'account Azure Cosmos DB

1. Navigare al portale di Azure all'indirizzo https://portal.azure.com/ e accedere.

2. Selezionare Tutte le risorse e quindi selezionare l'account Azure Cosmos DB creato.

3. Selezionare Esplora dati, selezionare la freccia giù e selezionare Nuovo keyspace. Immettere un identificatore univoco per l'ID Keyspace e quindi selezionare OK.

   

   

Recuperare le impostazioni di connessione per l'account Azure Cosmos DB

1. Navigare al portale di Azure all'indirizzo https://portal.azure.com/ e accedere.

2. Selezionare Tutte le risorse e quindi selezionare l'account Azure Cosmos DB creato.

3. Selezionare Stringhe di connessione e copiare i valori per i campi Punto di contatto, Porta, Nome utente e Password primaria . Questi valori vengono usati per configurare l'applicazione in un secondo momento.

   

Configurare l'applicazione di esempio

La procedura seguente configura l'applicazione di test.

1. Aprire una shell dei comandi e clonare il progetto di esempio usando un comando Git simile all'esempio seguente:

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

2. Individuare il file application.properties nella directory delle risorse del progetto di esempio oppure creare il file, se non esiste già.

3. Aprire il file application.properties in un editor di testo e aggiungere o configurare le righe seguenti nel file e sostituire i valori di esempio con i valori appropriati di precedenza:

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

   Dove:

   Parametro	Descrizione
   spring.data.cassandra.contact-points	Specifica il punto di contatto menzionato in precedenza in questo articolo.
   spring.data.cassandra.port	Specifica la porta menzionata in precedenza in questo articolo.
   spring.data.cassandra.username	Indica il tuo nome utente specificato precedentemente in questo articolo.
   spring.data.cassandra.password	Specifica la password primaria precedentemente menzionata in questo articolo.

4. Salvare e chiudere il file application.properties.

Creare un pacchetto e testare l'applicazione di esempio

Passare alla directory contenente il file pom.xml per compilare e testare l'applicazione.

1. Compilare l'applicazione di esempio con Maven; Per esempio:

   mvn clean package
   

2. Avviare l'applicazione di esempio; Per esempio:

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

3. Creare nuovi record usando curl da un prompt dei comandi. Gli esempi seguenti illustrano come creare record:

   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
   

   L'applicazione deve restituire valori simili all'esempio seguente:

   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. Recuperare tutti i record esistenti usando curl da un prompt dei comandi. Gli esempi seguenti illustrano come recuperare i record:

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

   L'applicazione deve restituire valori simili agli esempi seguenti:

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

Sommario

In questa esercitazione è stata creata un'applicazione di esempio Java che usa Spring Data per archiviare e recuperare informazioni usando Azure Cosmos DB per Apache Cassandra.

Pulire le risorse

Quando le risorse non sono più necessarie, usare il portale di Azure per eliminarle. L'eliminazione delle risorse consente di evitare addebiti imprevisti.

Passaggi successivi

Per altre informazioni su Spring e Azure, passare al Centro documentazione di Spring in Azure.

Spring su Azure

Vedere anche

Per altre informazioni sull'uso di Azure con Java, vedere Azure for Java Developers e il Lavorare con Azure DevOps e Java.