Compartir a través de


Uso de Spring Data con Azure Cosmos DB para Apache Cassandra

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

  • 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.

  1. Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.

  2. Seleccione Crear un recurso, seleccione Comenzar y, a continuación, seleccione Azure Cosmos DB.

  3. En la pantalla Seleccionar opción de API, seleccione Cassandra.

    Azure Portal, crear un recurso, seleccionar opción de API y Cassandra seleccionada.

  4. 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.

    Especifique la configuración de la cuenta de Azure Cosmos DB.

  5. Cuando haya escrito toda la información anterior, haga clic en Revisar y crear.

  6. 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

  1. Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.

  2. Seleccione Todos los recursos y, a continuación, seleccione la cuenta de Azure Cosmos DB que creó.

  3. 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).

    Selección de Nuevo espacio de claves.

    Cree un espacio de claves de Azure Cosmos DB.

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

  1. Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.

  2. Seleccione Todos los recursos y, a continuación, seleccione la cuenta de Azure Cosmos DB que creó.

  3. 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.

    Recupere la configuración de conexión de Azure Cosmos DB.

Configurar la aplicación de ejemplo

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

  1. 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
    
  2. Busque el archivo application.properties en el directorio resources del proyecto de ejemplo o cree el archivo si aún no existe.

  3. 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.
  4. 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.

  1. Compile la aplicación de ejemplo con Maven; por ejemplo:

    mvn clean package
    
  2. Inicie la aplicación de ejemplo; por ejemplo:

    java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
    
  3. 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'}.
    
  4. 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.

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).