Come usare Spring Data con Azure Cosmos DB per Apache Cassandra

Questo articolo illustra la creazione di un'applicazione di esempio che usa Spring Data per archiviare e recuperare informazioni usando Azure Cosmos DB per Apache Cassandra.

Prerequisiti

• Una sottoscrizione di Azure: crearne una gratuitamente.

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

• Apache Maven.

• Azure CLI.

• 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

Puoi leggere informazioni più dettagliate sulla creazione di account nella documentazione di Azure Cosmos DB .

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

2. Selezionare Crea una risorsa, quindi Iniziae 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 verrà 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. Dopo aver immesso tutte le informazioni precedenti, fare clic su Rivedi e crea.

6. Se tutti gli elementi sono corretti nella pagina di revisione, fare clic su Crea.

La distribuzione del database richiede alcuni minuti.

Aggiungere un keyspace all'account Azure Cosmos DB

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

2. Selezionare Tutte le risorsee quindi selezionare l'account Azure Cosmos DB che hai creato.

3. Selezionare Esplora dati, selezionare freccia giù e selezionare Nuovo spazio chiavi. Immettere un identificatore univoco per il keyspace ID , quindi fare clic su OK.

   

   

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

1. Accedi al portale di Azure all'indirizzo https://portal.azure.com/ ed effettua l'accesso.

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

3. Selezionare Stringhe di connessionee copiare i valori per i campi Contact Point, Port, Usernamee Primary Password; questi valori verranno 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. Crea nuovi record usando curl da un prompt dei comandi come negli esempi seguenti:

   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. Ottenere tutti i record esistenti usando curl dalla riga di comando come negli esempi seguenti:

   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 Java di esempio che usa Spring Data per archiviare e recuperare informazioni usando Azure Cosmos DB per Apache Cassandra.

Pulire le risorse

Quando non è più necessario, usare il portale di Azure per eliminare le risorse create in questo articolo per 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.