Press "Enter" to skip to content

CouchDB en 15 minutos

TuBaseDeDatos.org 0

couchdb-15minutos-tudblibre

Instalación (lo más básico)

Para instalar CouchDB sólo debes llamarlo desde los repositorios de tu distribución de GNU/Linux favorita. Por ejemplo en Ubuntu o Debian el comando adecuado sería:

$ apt-get install couchdb

Sin embargo en Fedora, CentOS o RedHat sería

$ yum install couchdb

Crear base de datos

Hola Mundo! (claro está)

  1. CouchDB es RESTful así que necesitará un cliente HTTP. Se utilizará telnet para el ejemplo (si no le gusta puede usar otro de su preferencia, o si no es muy ganado a la línea de comandos puede usar la interfaz Futon)
  2. Escriba: $ telnet localhost 5984
  3. La respuesta deberá ser:
    Trying 127.0.0.1...
    Connected to localhost.
    Escape character is '^]'.
  4. Corta y Pega
    PUT /example/some_doc_id HTTP/1.0
    Content-Length: 29
    Content-Type: application/json
    {"greetings":"Hello, World!"}
  5. La respuesta deberá ser:
    HTTP/1.0 201 Created
    Server: CouchDB/0.9.0 (Erlang OTP/R12B)
    Etag: "1-518824332"
    Date: Wed, 24 Jun 2009 13:33:11 GMT
    Content-Type: text/plain;charset=utf-8
    Content-Length: 51
    Cache-Control: must-revalidate
    {"ok":true,"id":"some_doc_id","rev":"1-518824332"}
    Connection closed by foreign host.
  6. En tu navegador visita http://localhost:5984/example/some_doc_id y debes ver:
    {"_id":"some_doc_id","_rev":"1-518824332","greetings":"Hello, World!"}

Resumen de la creación de documentos

  1. CouchDB es RESTful así que usted podrá crear documentos mediante PUT (como se mostró anteriormente) o usando POST.
  2. CouchDB usa una API JSON. Así que coloque (PUT) un documento en formato JSON y obtendrá (GET) resultados en formato JSON
  3. Para ver los datos use una Vista. (Suena algo obvio dicho de esta manera)
  4. Cada documento tiene una “_id” única.
  5. Cada documento está versionado con un “_rev”.

Crear una vista.. y véala

Relájese y eche un vistazo a las vistas:

  1. (Bueno en realidad usaremos un “show”, pero esto nos dará una buena idea del funcionamiento.)
  2. de nuevo
    $ telnet localhost 5984
    Trying 127.0.0.1...
    Connected to localhost.
    Escape character is '^]'.
    PUT /example/_design/render HTTP/1.0
    Content-Length: 77
    Content-Type: application/json
    
    {"shows" : {"salute" : "function(doc, req) {return {body: doc.greetings}}"}}
  3. Respuesta:
    HTTP/1.0 201 Created
    Server: CouchDB/0.9.0 (Erlang OTP/R12B)
    Etag: "1-2041852709"
    Date: Wed, 01 Jul 2009 06:08:59 GMT
    Content-Type: text/plain;charset=utf-8
    Content-Length: 55
    Cache-Control: must-revalidate
    
    {"ok":true,"id":"_design/render","rev":"1-2041852709"}
    Connection closed by foreign host.
  4.  Visite en su navegador: http://localhost:5984/example/_design/render/_show/salute/some_doc_id

Resumen de qué es una vista y qué es lo que hace

¿Qué sucedió?

  1. Un “show” procesa directamente un documento usando JavaScript.
  2. Los “shows” son agregados a un documento de diseño (en este caso “/_design/render” via la propiedad “shows”).
  3. La línea “body: doc.greetings” llena apropiadamente el cuerpo de las respuestas con el campo “greetings”.
  4. Al acceder a la dirección el navegador hace una petición GET a _design/render/_show/salute/some_doc_id para usar el show “salute” para procesar el documento “some_doc_id” agregado anteriormente.

¿Adonde seguir?

Si eres un usuario de bases de datos intuitivo podrás sacar provecho al uso de Futon, si tienes CouchBD corriendo en tu computador, simplemente visita http://localhost:5984/_utils/. Si deseas estudiar más a profundidad el funcionamiento de esta base de datos te invitamos a leer La Guía Definitiva de CouchDB y si eres impaciente salta directo a la sección de tour de inicio.

Al final

Esta es una traducción libre del texto del tutorial “CouchDB en 15 minutos” (http://wiki.apache.org/couchdb/CouchIn15Minutes)

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *