Objetivos

1. Abra el panel de control de IBM Cloudant.
2. Cree una base de datos.
3. Añadir documentos JSON a la base de datos y ejecutar una consulta.
4. Crear una réplica de una base de datos.
5. Supervisar las tareas activas.
6. Supervisar con IBM Cloudant.

Antes de empezar

Cree una instancia de servicio en IBM Cloud antes de iniciar esta guía de aprendizaje. Para crear una. puede seguir las instrucciones de la guía de aprendizaje Guía de inicio.

Cómo abrir la instancia de servicio en el panel de control de IBM Cloudant

Abra su instancia de servicio IBM Cloudant siguiendo estos pasos:

1. Vaya al panel de control de IBM Cloud.

2. Pulse Servicios en la lista de recursos.

3. En la sección Servicios, pulse la instancia Cloudant-o7 que ha creó en la guía de aprendizaje Guía de inicio y pulse Iniciar panel de control. Se abre el panel de control de IBM Cloudant.

Ahora puedes crear una base de datos y ejecutar consultas en ella.

Creación de una base de datos

En este ejercicio, se crea la base de datos dashboard-demo, que es la base de datos que se utiliza en este tutorial.

1. En el panel de control de IBM Cloudant, pulse Crear base de datos.

   Se abre la ventana Crear base de datos.

2. Escriba el nombre de base de datos dashboard-demo.

3. Seleccione No particionada y pulse Crear.

   La base de datos dashboard-demo se abre automáticamente.

Ahora puede crear documentos.

Adición de documentos a la base de datos

Los documentos que cree en este ejercicio incluyen los datos que se utilizan para consultar la base de datos dashboard-demo en ejercicios posteriores.

1. Pulse Crear documento.

   Se abre la ventana Nuevo documento.

2. Copie el texto de ejemplo siguiente y sustituya el texto existente en el nuevo documento. Utilice el texto de ejemplo siguiente para el documento 1:

   {
     "firstname": "Sally",
     "lastname": "Brown",
     "age": 16,
     "location": "New York City, NY",
     "_id": "doc1"
   }
   

3. Repita los pasos 1 y 2 para añadir los cuatro documentos restantes a la base de datos. Utilice el texto de ejemplo siguiente para el documento 2:

   {
     "firstname": "John",
     "lastname": "Brown",
     "age": 21,
     "location": "New York City, NY",
     "_id": "doc2"
   }
   

   Utilice el texto de ejemplo siguiente para el documento 3:

   {
     "firstname": "Greg",
     "lastname": "Greene",
     "age": 35,
     "location": "San Diego, CA",
     "_id": "doc3"
   }
   

   Utilice el texto de ejemplo siguiente para el documento 4:

   {
     "firstname": "Anna",
     "lastname": "Greene",
     "age": 44,
     "location": "Baton Rouge, LA",
     "_id": "doc4"
   }
   

   Utilice el texto de ejemplo siguiente para el documento 5:

   {
     "firstname": "Lois",
     "lastname": "Brown",
     "age": 33,
     "location": "New York City, NY",
     "_id": "doc5"
   }
   

   Ha rellenado dashboard-demo con cinco documentos. Puede ver los documentos desde la vista Tabla en la siguiente captura de pantalla:

   

Réplica de una base de datos

Al replicar una base de datos, se sincroniza el estado de dos bases de datos: origen y destino. Una réplica copia todos los cambios que se han producido en la base de datos de origen en la base de datos de destino. Cuando se suprime un documento de la base de datos de origen, también se suprime de la base de datos de destino.

Para obtener más información, consulte Réplica.

1. Pulse Réplica.

2. Pulse Nueva réplica.

   Se abre la página Configuración de trabajo.

   Además, puede crear una réplica desde la página Bases de datos pulsando Replicar en la columna Acciones.

3. Escriba la siguiente información para el trabajo de réplica. Utilice la información siguiente en la sección Origen:

   • Tipo: seleccione Base de datos remota.
   • Nombre: especifique el URL de la base de datos: $SERVICE_URL/query-movies.
   • Autenticación: deje None.

   Utilice la información siguiente en la sección Destino:

   • Tipo: seleccione Nueva base de datos local.
   • Nueva base de datos: escriba el nombre de la nueva base de datos, query-movies.
   • Opciones nuevas de la base de datos: no seleccione la opción Particionadas.
   • Autenticación: seleccione Autenticación de IAM.
   • Clave de API de IAM: escriba la apikey desde las credenciales de servicio de la instancia.

   Para obtener más información, consulte la sección sobre Localización de las credenciales de servicio.

   Utilice la información siguiente en la sección Opciones:

   • Tipo de réplica: deje el valor One time.
   • Documento de réplica - Dejar como Custom ID (optional.

   

4. Pulse Iniciar réplica.

   Se abre la página Réplica, en la que puede ver que el trabajo de réplica se está ejecutando.

   

5. Consulte el estado cuando el trabajo finalice el cambio a Completado.

6. Compruebe que se ha creado la base de datos en la página Bases de datos.

   

Supervisión de tareas activas

La página Tareas activas muestra una lista de todas las tareas en ejecución. Al supervisar el rendimiento del sistema, esta lista puede ayudarle a encontrar problemas potenciales. Puede ver una lista de tareas activas, que incluye compactación, réplica e indexación. Para obtener más información, consulte la guía Gestión de tareas.

Si la instancia no tiene ninguna tarea activa, puede volver al paso anterior, suprimir la base de datos query-movies y, a continuación, volver a replicarla. Si abre la página Tareas activas inmediatamente, puede ver la réplica.

1. Pulse Tareas activas.

   Se abre la página Tareas activas.

   

2. Pulse el separador asociado para ver información específica de la tarea.

Supervisión con IBM Cloudant

Supervise el uso con un gráfico que muestra el rendimiento por lecturas, escrituras y consultas globales. Puede ver las operaciones actuales, las solicitudes denegadas y el uso de almacenamiento.

La instancia de servicio no contiene datos porque solo sirve a fines de demostración. Sin embargo, puede ver qué información de supervisión tiene a su disposición siguiendo estos pasos:

1. Pulse Supervisión.

   Se abre la página Supervisión en el separador Operaciones actuales. Revise el consumo reciente de la capacidad de rendimiento suministrada consultando las solicitudes desglosadas por lecturas, escrituras y consultas globales. La línea de puntos es la capacidad máxima permitida para la instancia. La capacidad máxima se basa en lo que se establece para la capacidad de rendimiento suministrada.

   

2. Pulse Solicitudes denegadas.

   Revise el número de solicitudes denegadas de un segundo dado que se muestran por el número de 429: too many requests respuestas. Las solicitudes se deniegan cuando superan el conjunto de capacidad de rendimiento suministrada para la instancia. El gráfico muestra las solicitudes denegadas desglosadas por lecturas, escrituras y consultas globales.

   

3. Pulse Almacenamiento.

   Revise periódicamente el almacenamiento, de modo que esté preparado si cambian las necesidades de suministro del plan.

   

Para obtener más información, consulte Planes y suministro.