Compartir a través de

Inicio rápido: Creación de una aplicación de Cassandra con CQLSH y Azure Cosmos DB

SE APLICA A: Casandra

En este artículo de inicio rápido creará una cuenta de Azure Cosmos DB for Apache Cassandra y utilizará CQLSH para crear un contenedor y una base de datos de Cassandra. Azure Cosmos DB es un servicio de base de datos multimodelo que permite crear y consultar rápidamente bases de datos de documentos, tablas, claves-valores y grafos con funcionalidades de distribución global y escala horizontal.

Requisitos previos

Creación de una cuenta de base de datos

Para poder crear una base de datos de documentos, debe crear una cuenta de Cassandra con Azure Cosmos DB.

  1. En el menú de Azure Portal o en la página principal, seleccione Crear un recurso.

  2. En la página Nuevos, busque y seleccione Azure Cosmos DB.

  3. En la página Azure Cosmos DB, seleccione Crear.

  4. En la página API , en la sección Cassandra , seleccione Crear.

    La API determina el tipo de cuenta que se va a crear. Azure Cosmos DB proporciona cinco API: NoSQL para bases de datos de documentos, Gremlin para bases de datos de grafos, MongoDB para bases de datos de documentos, Azure Table y Cassandra. Debe crear una cuenta independiente para cada API.

    Seleccione Cassandra porque en este tutorial va a crear una tabla que funcione con la API para Cassandra.

    Para más información sobre la API para Cassandra, consulte ¿Qué es Azure Cosmos DB para Apache Cassandra?.

  5. En la página Crear cuenta de Azure Cosmos DB , escriba la configuración básica de la nueva cuenta de Azure Cosmos DB.

    Configuración Valor Descripción
    Suscripción Su suscripción. Seleccione la suscripción de Azure que quiere usar para esta cuenta de Azure Cosmos DB.
    Grupo de recursos Crear nuevo.

    A continuación, escriba el mismo nombre que nombre de cuenta.    		 Seleccione Crear nuevo. Luego, escriba un nombre nuevo de grupo de recursos para la cuenta. Para simplificar, use el mismo nombre que el de la cuenta de Azure Cosmos DB.
    Nombre de cuenta Escriba un nombre único. Escriba un nombre único para identificar la cuenta de Azure Cosmos DB. El URI de tu cuenta, cassandra.cosmos.azure.com, se añadió a tu nombre único de cuenta.

    El nombre de la cuenta solo puede usar letras minúsculas, números y guiones (-) y debe tener entre 3 y 31 caracteres.
    Ubicación Región más cercana a los usuarios. Seleccione una ubicación geográfica para hospedar la cuenta de Azure Cosmos DB. Use la ubicación más cercana a los usuarios para proporcionarles el acceso más rápido a los datos.
    Modo de capacidad Rendimiento aprovisionado o sin servidor. Seleccione Rendimiento aprovisionado para crear una cuenta en modo rendimiento aprovisionado. Seleccione Sin servidor para crear una cuenta en modo sin servidor .
    Aplica el descuento del nivel gratuito de Azure Cosmos DB Aplicar o No aplicar. Con el nivel gratis de Azure Cosmos DB, obtendrá los primeros 1000 RU/s y 25 GB de almacenamiento gratis en una cuenta. Obtenga más información sobre el nivel gratis.
    Limitar el rendimiento total de la cuenta Seleccione esta opción para limitar el rendimiento de la cuenta. Esta opción es útil si desea limitar el rendimiento total de la cuenta a un valor específico.

    Nota:

    Puede tener hasta una cuenta de nivel Gratis de Azure Cosmos DB por suscripción de Azure. Debe optar por unirse al crear la cuenta. Si no ve la opción de aplicar el descuento del nivel Gratis, otra cuenta de la suscripción fue habilitada con el nivel Gratis.

    Página de la nueva cuenta de Azure Cosmos DB for Apache Cassandra

  6. En la pestaña Distribución global , configure los detalles siguientes. Use los valores predeterminados de este tutorial.

    Configuración Valor Descripción
    Redundancia geográfica Disable Habilite o deshabilite la distribución global en su cuenta. Para ello, debe emparejar su región con una región de par. Puede agregar más regiones a su cuenta más adelante.
    Escrituras de varias regiones Disable Con la funcionalidad de escrituras multiregión, puede aprovechar el rendimiento aprovisionado para las bases de datos y los contenedores en todo el mundo.
    Zonas de disponibilidad Disable Las zonas de disponibilidad son ubicaciones aisladas dentro de una región de Azure. Cada zona de disponibilidad consta de uno o varios centros de datos equipados con alimentación, refrigeración y redes independientes.

    Las siguientes opciones no están disponibles si selecciona Sin servidor como modo de capacidad:

    • Aplicación de descuento por nivel Gratis
    • Redundancia geográfica
    • Escrituras de varias regiones

  7. Opcionalmente, puede configurar otros detalles en las pestañas siguientes:

    • Redes: configure el acceso desde una red virtual.
    • Directiva de copia de seguridad: configure una directiva de copia de seguridad periódica o continua .
    • Cifrado: use una clave administrada por el servicio o una clave administrada por el cliente.
    • Etiquetas: las etiquetas son pares nombre-valor que puede usar para clasificar los recursos y ver la facturación consolidada aplicando la misma etiqueta a varios recursos y grupos de recursos.

  8. Seleccione Revisar + crear.

  9. Revise la configuración de la cuenta y seleccione Crear. La operación de creación de la cuenta tarda unos minutos. Espere hasta que la página del portal muestre Se completó la implementación .

    Captura de pantalla que muestra el panel Notificaciones de Azure Portal.

  10. Seleccione Ir al recurso para ir a la página de la cuenta de Azure Cosmos DB.

Instalación de la herramienta independiente CQLSH

Consulte CQL shell para conocer los pasos sobre cómo iniciar una herramienta independiente cqlsh.

Actualización de la cadena de conexión

Ahora vuelva a Azure Portal para obtener la información de la cadena de conexión y cópiela en la aplicación. Los detalles de la cadena de conexión permiten a la aplicación comunicarse con la base de datos hospedada.

  1. En la cuenta de Azure Cosmos DB, en Azure Portal, seleccione Cadena de conexión.

    Visualización y copia de un nombre de usuario de Azure Portal, página Cadena de conexión

  2. Utilice el botón del lado derecho de la pantalla para copiar el valor de USERNAME y PASSWORD.

  3. En el terminal, establezca las variables SSL:

    # Export the SSL variables:
export SSL_VERSION=TLSv1_2
export SSL_VALIDATE=false

  4. Conexión con Azure Cosmos DB for Apache Cassandra:

    • Pegue en el comando el valor de USERNAME y PASSWORD.
    cqlsh <USERNAME>.cassandra.cosmos.azure.com 10350 -u <USERNAME> -p <PASSWORD> --ssl --protocol-version=4

Comandos CQL para crear y ejecutar una aplicación

  • Creación de un espacio de claves
CREATE KEYSPACE IF NOT EXISTS uprofile 
WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'datacenter1' : 1 };
  • Creación de una tabla
CREATE TABLE IF NOT EXISTS uprofile.user (user_id int PRIMARY KEY, user_name text, user_bcity text);
  • Inserción de una fila en la tabla de usuario
INSERT INTO  uprofile.user (user_id, user_name, user_bcity) VALUES (101,'johnjoe','New York')

También puede insertar datos con el comando COPY.

COPY uprofile.user(user_id, user_name, user_bcity) FROM '/path to file/fileName.csv' 
WITH DELIMITER = ',' ;
  • Consulta de la tabla de usuario
SELECT * FROM uprofile.users;

En Azure Portal abra Explorador de datos para consultar, modificar y trabajar con estos nuevos datos. Visualización de los datos en el Explorador de datos: Azure Cosmos DB

Revisión de los SLA en Azure Portal

Azure Portal supervisa el rendimiento, capacidad de almacenamiento, disponibilidad, latencia y coherencia de su cuenta de Azure Cosmos DB. Los gráficos de las métricas asociadas con un Acuerdo de Nivel de Servicio (SLA) de Azure Cosmos DB muestran el rendimiento real en comparación con el valor de este acuerdo. Este conjunto de métricas hace que la supervisión de los Acuerdos de Nivel de Servicio sea transparente.

Para revisar las métricas y los Acuerdos de Nivel de Servicio:

  1. Seleccione Métricas en el menú de navegación de la cuenta de Azure Cosmos DB.

  2. Seleccione una pestaña como Latencia y seleccione un período de tiempo a la derecha. Compare las líneas Real y SLA de los gráficos.

    Conjunto de métricas de Azure Cosmos DB

  3. Revise las métricas de las otras pestañas.

Limpieza de recursos

Cuando haya terminado tanto con la aplicación como con la cuenta de Azure Cosmos DB, puede eliminar los recursos de Azure que creó para no tener más gastos. Para eliminar los recursos:

  1. En la barra de búsqueda de Azure Portal, busque y seleccione Grupos de recursos.

  2. En la lista, seleccione el grupo de recursos que creó para este inicio rápido.

    Selección del grupo de recursos que se eliminará

  3. En la página Información general del grupo de recursos, seleccione Eliminar grupo de recursos.

    Eliminar el grupo de recursos

  4. En la ventana siguiente, escriba el nombre del grupo de recursos que desea eliminar y, después, seleccione Eliminar.

Pasos siguientes

En este artículo de inicio rápido ha aprendido a crear una cuenta de Azure Cosmos DB con la API para Cassandra mediante CQLSH, que crea un contenedor y una base de datos de Cassandra. Ya puede importar datos adicionales en la cuenta de Azure Cosmos DB.

Importación de datos de Cassandra en Azure Cosmos DB

  • Last updated on