Uso de Spring Data con Azure Cosmos DB para Apache Cassandra

Artículo
05/23/2023

En este artículo se muestra cómo crear una aplicación de ejemplo que usa Spring Data para almacenar y recuperar información mediante Azure Cosmos DB para Apache Cassandra.

Requisitos previos

Una suscripción a Azure: cree una cuenta gratuita.
Kit de desarrollo de Java (JDK), versión 8 o posterior.
Apache Maven.
Azure CLI.

Un cliente Git.
cURL o una utilidad HTTP similar para probar la funcionalidad.

Creación de una cuenta de Azure Cosmos DB

El procedimiento siguiente crea y configura una cuenta de Azure Cosmos DB en Azure Portal.

Creación de una cuenta de Azure Cosmos DB mediante Azure Portal

Nota:

Puede leer información más detallada sobre la creación de cuentas en la documentación de Azure Cosmos DB.

Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.
Seleccione Crear un recurso, seleccione Comenzar y, a continuación, seleccione Azure Cosmos DB.
En la pantalla Seleccionar opción de API, seleccione Cassandra.
Especifique la información siguiente:
- Suscripción: especifique la suscripción de Azure que se va a usar.
- Grupo de recursos: especifique si desea crear un nuevo grupo de recursos o elegir un grupo de recursos existente.
- Nombre de cuenta: elija un nombre único para la cuenta de Azure Cosmos DB; este nombre se usará para crear un nombre de dominio completo como wingtiptoyscassandra.documents.azure.com.
- API: especifique Cassandra para este tutorial.
- Ubicación: especifique la región geográfica más cercana para la base de datos.
Cuando haya escrito toda la información anterior, haga clic en Revisar y crear.
Si todo parece correcto en la página de revisión, haga clic en Crear.

La implementación de la base de datos tarda unos minutos.

Adición de un espacio de claves a la cuenta de Azure Cosmos DB

Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.
Seleccione Todos los recursos y, a continuación, seleccione la cuenta de Azure Cosmos DB que creó.
Seleccione Data Explorer, seleccione flecha abajo y seleccione New Keyspace (Nuevo espacio de claves). Especifique un identificador único en Keyspace id (Identificador del espacio de claves) y, a continuación, haga clic en OK (Aceptar).

Recuperación de la configuración de conexión para la cuenta de Azure Cosmos DB

Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.
Seleccione Todos los recursos y, a continuación, seleccione la cuenta de Azure Cosmos DB que creó.
Seleccione Conectar cadenas y copie los valores de los campos Punto de contacto, Puerto, Nombre de usuario y Contraseña principal; usará esos valores para configurar la aplicación más adelante.

Configurar la aplicación de ejemplo

En el siguiente procedimiento se configura la aplicación de prueba.

Abra un shell de comandos y clone el proyecto de ejemplo con un comando git como el siguiente ejemplo:
```
git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
```
Busque el archivo application.properties en el directorio resources del proyecto de ejemplo o cree el archivo si aún no existe.

Abra el archivo application.properties en un editor de texto y agréguele o configure las siguientes líneas; luego, sustituya los valores de ejemplo por los valores adecuados que se mencionaron anteriormente:

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

Donde:

Parámetro	Descripción
`spring.data.cassandra.contact-points`	Especifica el punto de contacto que se mencionó anteriormente en este artículo.
`spring.data.cassandra.port`	Especifica el puerto que se mencionó anteriormente en este artículo.
`spring.data.cassandra.username`	Especifica el nombre de usuario que se mencionó anteriormente en este artículo.
`spring.data.cassandra.password`	Especifica la contraseña principal que se mencionó anteriormente en este artículo.

Guarde y cierre el archivo application.properties.

Empaquetado y prueba de la aplicación de ejemplo

Vaya al directorio que contiene el archivo pom.xml para compilar y probar la aplicación.

Compile la aplicación de ejemplo con Maven; por ejemplo:
```
mvn clean package
```

Inicie la aplicación de ejemplo; por ejemplo:

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

Cree nuevos registros con curl desde un símbolo del sistema como en los ejemplos siguientes:

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

La aplicación debe devolver valores como el ejemplo siguiente:

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

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

Recupere todos los registros existentes con curl desde un símbolo del sistema como los siguientes ejemplos:

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

La aplicación debe devolver valores como los ejemplos siguientes:

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

Resumen

En este tutorial, ha creado una aplicación java de ejemplo que usa Spring Data para almacenar y recuperar información mediante Azure Cosmos DB para Apache Cassandra.

Limpieza de recursos

Cuando ya no lo necesite, use Azure Portal para eliminar los recursos creados en este artículo y evitar cargos inesperados.

Pasos siguientes

Para más información acerca de Spring y Azure, vaya al centro de documentación de Azure.

Spring en Azure

Consulte también

Para más información sobre el uso de Azure con Java, consulte Azure para desarrolladores de Java y Working with Azure DevOps and Java (Trabajo con Azure DevOps y Java).

Compartir vía