Nuevo en Couchbase 6.6: Importación de documentos mediante Web Admin Console

Couchbase 6.6 viene con una característica muy necesaria, Importar documentos usando Couchbase Admin Web Console. Esto proporciona una manera fácil de importar rápidamente pequeño conjuntos de datos en diversos formatos para complementar cbimport que es una solución de línea de comandos más completa, con muchas más opciones de importación de datos. 

En esta entrada del blog, veremos algunos casos de uso y algunas trampas al importar datos.

Comprobación de la función

Se accede a Importar documentos haciendo clic en el botón Documentos en el panel izquierdo y el enlace Importar documento en el panel azul de la parte superior de la página. 

Los campos se explican por sí mismos, pero voy a echar un vistazo a la importación de un pequeño conjunto de datos (sólo 5 líneas) para demostrar la función. He creado 4 archivos con diferentes formatos en mi portátil para demostrar la función. Tenga en cuenta que no necesitamos necesariamente un cubo de destino vacío, pero para esta prueba, he creado un cubo prueba que aún no tiene ningún documento.

Vamos a importar nuestro conjunto de datos JSON List.

1. Hice clic en el Seleccionar archivo para importar y seleccione aeropuerto.jsonun archivo con 5 documentos JSON en mi portátil.
2. Antes de importar realmente los datos, la pantalla muestra una muestra del Contenido del fichero en diferentes formatos. Esto sirve como comprobación rápida.
3. A continuación tengo la opción de establecer el clave del documento durante la importación, en el Importar con ID de documento botones de opción. Las opciones son UUID, o, cuando sea posible, un Valor del campo.
   • Nota al elegir Valor del campo:
     • Este campo tiene que estar en todos los documentos con un valor único no nulo. 
     • Ta herramienta no garantiza que los campos ID de candidato tengan valores únicos en todos los documentos. La interfaz de usuario de importación sólo comprueba que el campo sea presente en cada documento.
     •  Si selecciona un campo ID con valores duplicados, los documentos antiguos se sobrescribirán con los nuevos documentos que tengan el mismo ID.
   • Por ahora, seguiré con el UUID elección y seguir adelante con la Importación.
4. A continuación, seleccioné prueba como mi Cubo de destino.
5. A continuación, hago clic en el botón Importar datos en la parte inferior de la pantalla.

La importación se ha realizado correctamente y también muestra el número de documentos importados en un cuadro emergente.
La pantalla también muestra un útil cbimport en caso de que el tamaño de los datos sea grande.

 Vamos a importar el mismo conjunto de documentos, pero esta vez, elija la opción Valor del campo así:

Elegiré id.
Ahora, que he importado el mismo conjunto de documentos dos veces, pero con diferentes llavesAhora tendré 10 documentos en el cubo. Comprobémoslo haciendo clic en el botón Editor de documentos en el botón azul panel en la parte superior.

Aquí vemos los 10 documentos, un conjunto de 5 con el id como clave del documento y otro conjunto de 5 con el UUID generado por el servidor como clave.

Veamos 1 documento:

Se ve bien.

Otras pruebas

También puede probar a importar el mismo conjunto de datos en distintos formatos.

Formatos de archivo

Lista JSON

Una lista JSON es una lista (indicada mediante corchetes) de cualquier número de objetos JSON (indicados mediante llaves) separados por comas.

Líneas JSON

Líneas JSON es un archivo donde cada línea tiene un objeto JSON completo separado en esa línea.

CSV (Variables separadas por comas)

Nota:

• El formato CSV "aplana" los datos JSON y no admite matrices ni valores anidados.
• El formato CSV no tiene una forma bien definida de admitir valores nulos. Los valores de cadena en CSV se entrecomillan opcionalmente, por lo que no existe una forma estándar de distinguir la cadena "null" del valor null. Por lo tanto, después de importar desde un conjunto de datos CSV, el valor null se importará como la cadena "null".

TSV (Variables separadas por tabulaciones)

Nota:

• El formato TSV "aplana" los datos JSON y no admite matrices ni valores anidados.
• El formato TSV no tiene una forma bien definida de admitir valores nulos. Los valores de cadena en TSV se entrecomillan opcionalmente, por lo que no existe una forma estándar de distinguir la cadena "null" del valor null. Por lo tanto, después de importar desde un conjunto de datos CSV, el valor null se importará como la cadena "null".

Explorar los recursos de Couchbase Server 6.6