In this chapter, we’ll take a quick tour of CouchDB’s features, familiarizing ourselves with Futon, the built-in administration interface. We’ll create our first document and experiment with CouchDB views. Before we start, skip to Appendix D, Installing from Source and look for your operating system. You will need to follow those instructions and get CouchDB installed before you can progress. +
En éste capítulo haremos un tour rápido por las características de CouchDB y nos familiarizaremos con Futon, la interfaz de administración. Crearemos nuestro primer documento y experimentaremos con las vistas (views) de CouchDB. Antes de comenzar, de una mirada a Apéndice D, Instalación desde el Source y allí busque su sistema operativo. Va a necesitar seguir las instrucciones allí detalladas e instalar su CouchDB para poder continuar. -
We’ll have a very quick look at CouchDB’s bare-bones Application Programming Interface (API) by using the command-line utility curl. Please note that this is only one way of talking to CouchDB. We will show you plenty more throughout the rest of the book. What’s interesting about curl is that it gives you control over raw HTTP requests, and you can see exactly what is going on “underneath the hood” of your database.
+
Demos una rápida mirada al esqueleto de CouchDB Application Programming Interface (API) por medio de la utilidad de comando curl. Note que ésta es solo una de las formas de comunicarse con CouchDB. Le mostraremos muchas otras durante el resto del libro. Lo interesante de curl es que nos da control sobre direct los requerimientos HTTP, y nos permite ver exactamente que está ocurriendo "debajo de la superficie" en nuestra base de datos.
-
Make sure CouchDB is still running, and then do: +
Asegúrece que CouchDB está corriendo haciendo:
curl http://127.0.0.1:5984/-
This issues a GET request to your newly installed CouchDB instance.
+
Esto emite un requerimiento GET a su recien instalada instancia de CouchDB.
-
The reply should look something like: +
La respuesta debe ser algo del estilo de:
{"couchdb":"Welcome","version":"0.10.1"}
-Not all that spectacular. CouchDB is saying “hello” with the running version number. +
Nada muy espectacular. Solo CouchDB está diciendo “hola” y mostrando su número de version. -
Next, we can get a list of databases: +
Ahora, podemos obtener una lista de las bases de datos instalada:
curl -X GET http://127.0.0.1:5984/_all_dbs-
All we added to the previous request is the _all_dbs string.
+
Todo lo agregado a la consulta anterior es el _all_dbs.
-
The response should look like: +
La respuesta debería mostrar algo así:
[]-
Oh, that’s right, we didn’t create any databases yet! All we see is an empty list. +
Oh, está bien, no hemos creado ninguna base de datos todavía, por eso solo vemos una lista vacía.
The curl command issues GET requests by default. You can issue POST requests using curl -X POST. To make it easy to work with our terminal history, we usually use the -X option even when issuing GET requests. If we want to send a POST next time, all we have to change is the method.
+
El comando curl emite por defecto un requerimiento GET. Tu puedes emitir un requerimiento POST usando curl -X POST. Para facilitar el trabajo con el historial de la terminal, normalmente también usamos la opción -X explicitamente cada vez que hacemos un GET. si queremos enviar un POST la próxima vez, solo cambiamos el método.
HTTP does a bit more under the hood than you can see in the examples here. If you’re interested in every last detail that goes over the wire, pass in the -v option (e.g., curl -vX GET), which will show you the server curl tries to connect to, the request headers it sends, and response headers it receives back. Great for debugging!