CouchDB - Creación de un documento

Los documentos son la estructura de datos central de CouchDB. El contenido de la base de datos se almacenará en forma de Documentos en lugar de tablas. Puede crear estos documentos utilizando la utilidad cURL proporcionada por CouchDB, así como Futon. Este capítulo cubre las formas de crear un documento en una base de datos.

Cada documento en CouchDB tiene una identificación única. Puede elegir su propia identificación que debe tener la forma de una cadena. Generalmente, se usa UUID (Universal Unique IDentifier), que son números aleatorios que tienen menos posibilidades de crear un duplicado. Se prefieren para evitar colisiones.

Crear un documento usando la utilidad cURL

Puede crear un documento en CouchDB enviando una solicitud HTTP al servidor usando el método PUT a través de la utilidad cURL. A continuación se muestra la sintaxis para crear un documento.

$ curl -X PUT http://127.0.0.1:5984/database name/"id" -d ' { document} '

Utilizando −X, podemos especificar un método de solicitud personalizado de HTTP que estamos usando, mientras nos comunicamos con el servidor HTTP. En este caso, estamos usando el método PUT. Cuando usamos el método PUT, el contenido de la url especifica el nombre del objeto que estamos creando usando la solicitud HTTP. Aquí tenemos que enviar lo siguiente:

El nombre del nombre de la base de datos en la que estamos creando el documento.
La identificación del documento.
Los datos del documento. −dLa opción se usa para enviar los datos / documentos a través de una solicitud HTTP. Mientras escribe un documento, simplemente ingrese sus pares Campo-Valor separados por dos puntos, entre corchetes de flores como se muestra a continuación:

{
   Name : Raju
   age : 23
   Designation : Designer
}

Ejemplo

Usando la sintaxis dada anteriormente si desea crear un documento con id 001 en una base de datos con nombre my_database, puede crearlo como se muestra a continuación.

$ curl -X PUT http://127.0.0.1:5984/my_database/"001" -d
'{ " Name " : " Raju " , " age " :" 23 " , " Designation " : " Designer " }'

{"ok":true,"id":"001","rev":"1-1c2fae390fa5475d9b809301bbf3f25e"}

La respuesta de CouchDB a esta solicitud contiene tres campos:

"ok", indicando que la operación fue exitosa.
"id", que almacena la identificación del documento y
"rev",esto indica la identificación de la revisión. Cada vez que revisa (actualiza o modifica) un documento,_revEl valor será generado por CouchDB. Si desea actualizar o eliminar un documento, CouchDB espera que incluya el_revcampo de la revisión que desea cambiar. Cuando CouchDB acepta el cambio, generará un nuevo número de revisión. Este mecanismo asegura el control de concurrencia.

Verificación

Si desea ver el documento creado, puede obtenerlo utilizando el documento como se muestra a continuación.

$ curl -X GET http://127.0.0.1:5984/my_database/001
{
   "_id": "001",
   "_rev": "1-3fcc78daac7a90803f0a5e383f4f1e1e",
   "Name": "Raju",
   "age": 23,
   "Designation": "Designer"
}

Creando un documento usando Futon

Para crear un documento, abra el http://127.0.0.1:5984/_utils/ url para obtener una página de resumen / índice de CouchDB como se muestra a continuación.

Seleccione la base de datos en la que desea crear el documento. Abra la página Descripción general de la base de datos y seleccioneNew Document opción como se muestra a continuación.

Cuando selecciona el New Documentopción, CouchDB crea un nuevo documento de base de datos, asignándole una nueva identificación. Puede editar el valor de la identificación y puede asignar su propio valor en forma de cadena. En la siguiente ilustración, hemos creado un nuevo documento con una identificación 001.

En esta página, puede observar tres opciones: guardar documento, agregar campo y cargar adjunto.

Agregar campo al documento

Para agregar un campo al documento, haga clic en Add Fieldopción. Después de crear una base de datos, puede agregarle un campo usando esta opción. Al hacer clic en él, obtendrá un par de cuadros de texto, a saber,Field, value.Puede editar estos valores haciendo clic en ellos. Edite esos valores y escriba el par de campo-valor que desee. Haga clic en el botón verde para guardar estos valores.

En la siguiente ilustración, hemos creado tres campos Nombre, edad y Designación del empleado.

Guardar documento

Puede guardar los cambios realizados en el documento haciendo clic en esta opción. Después de guardar, una nueva identificación_rev se generará como se muestra a continuación.

↰ Previous page Next page ↱