![\"The](\"\/wp-content\/original-assets\/2016\/december\/getting-comfortable-couchbase-mobile-couchbase-server-command-line\/couchbase-mobile-stack_1920.png\")
<\/p>\n<\/p>\n
Este ser\u00e1 el tercer post de una serie sobre la\u00a0Couchbase M\u00f3vil<\/a>\u00a0pila. Puede encontrar el primer y segundo post\u00a0aqu\u00ed<\/a>\u00a0y\u00a0aqu\u00ed<\/a>respectivamente. Cubren la instalaci\u00f3n de\u00a0Servidor Couchbase<\/a>\u00a0y algunas partes interesantes de\u00a0Consola web de Couchbase<\/a>. En este post hablaremos sobre c\u00f3mo trabajar con Couchbase Server desde la l\u00ednea de comandos.<\/p>\n Para sentirse c\u00f3modo con toda la pila, es genial instalar y ejecutar todo en su m\u00e1quina de desarrollo. En esta serie de entradas, voy a caminar a trav\u00e9s de los pasos para empezar con cada componente. Tambi\u00e9n mostrar\u00e9 c\u00f3mo explorar un poco m\u00e1s por el camino.<\/p>\n S\u00f3lo har\u00e9 una configuraci\u00f3n m\u00ednima. Esto no pretende explicar lo que necesitas para un entorno de producci\u00f3n. Asumo que est\u00e1s familiarizado con algunos conceptos b\u00e1sicos de NoSQL, tienes alguna comprensi\u00f3n de Couchbase, y sabes c\u00f3mo construir aplicaciones en algo como Java, Android o iOS. Si quieres leer m\u00e1s sobre bases de datos NoSQL o Couchbase, puedes encontrar un mont\u00f3n de recursos en la web\u00a0Couchbase<\/a>\u00a0sitio.<\/p>\n Couchbase es de c\u00f3digo abierto. Todo lo que usar\u00e9 aqu\u00ed es gratis para probar. Mira al final del post para m\u00e1s recursos si necesitas ayuda.<\/p>\n Couchbase Server tiene un buen n\u00famero de herramientas de l\u00ednea de comandos. Tambi\u00e9n tiene una extensa API REST. Echemos un vistazo a algunos puntos interesantes.<\/p>\n En un Mac, normalmente puedes encontrar las herramientas de l\u00ednea de comandos en \/Applications\/Couchbase Server.app\/Contents\/Resources\/couchbase-core\/bin.<\/p>\n Puede encontrar las ubicaciones de los comandos para Linux y Windows aqu\u00ed: https:\/\/developer.couchbase.com\/documentation\/server\/current\/cli\/cli-intro.html<\/a><\/p>\n Esta herramienta puede funcionar en nodos individuales o en clusters enteros. Admite comandos para todo, desde la manipulaci\u00f3n de buckets hasta las r\u00e9plicas entre centros de datos. He aqu\u00ed algunos ejemplos.<\/p>\n El siguiente comando devolver\u00e1 una breve lista de los servidores de un cl\u00faster.<\/p>\n Salida<\/p>\n Como era de esperar, esto muestra que tenemos un servidor activo ejecut\u00e1ndose localmente.<\/p>\n (Nota: por brevedad, en adelante omitir\u00e9 las opciones de cluster, nombre de usuario y contrase\u00f1a. Sin embargo, las necesitar\u00e1s para los comandos reales).<\/p>\n Podemos activar el registro. Hay opciones para cargar autom\u00e1ticamente los datos para el soporte.<\/p>\n Salida<\/p>\n A continuaci\u00f3n, comprueba el estado.<\/p>\n Salida<\/p>\n Y deja de talar.<\/p>\n Salida<\/p>\n Los archivos de registro son extensos. La muestra aqu\u00ed conten\u00eda muchos archivos y m\u00e1s de un megabyte de informaci\u00f3n. Es todo texto que puedes mirar. Si alguna vez necesitas soporte para una instalaci\u00f3n de CB Server, es bueno saber c\u00f3mo obtener estos datos.<\/p>\n La otra herramienta que veremos es cbq, el int\u00e9rprete de comandos interactivo para ejecutar consultas N1QL.<\/p>\n En este caso, el comando se ejecutar\u00e1 en bucle pidi\u00e9ndonos informaci\u00f3n. Empieza ejecut\u00e1ndolo sin opciones.<\/p>\n Inmediatamente deber\u00eda ver un par de avisos y el s\u00edmbolo del sistema.<\/p>\n Para realizar consultas, necesitar\u00e1s al menos un \u00edndice primario. Algunas versiones de los datos de la muestra de cerveza vienen con uno, otras no.<\/p>\n Salida<\/p>\n He aqu\u00ed un ejemplo de consulta bastante simple.<\/p>\n Salida<\/p>\n Hemos extra\u00eddo todas las cervezas que tienen \"Imperial\" como parte de su descripci\u00f3n de estilo.<\/p>\n F\u00edjese en las marcas traseras alrededor de la muestra de cerveza. Son necesarias debido al gui\u00f3n del nombre.<\/p>\n N1QL deber\u00eda resultarte familiar si conoces SQL. N1QL es un superconjunto de SQL. Los datos JSON a menudo no son planos como los datos relacionales. N1QL tiene extensiones para hacer cosas como desenrollar matrices. Puedes leer m\u00e1s sobre N1QL\u00a0aqu\u00ed<\/a>.<\/p>\n Para comprender N1QL en mayor profundidad, recomiendo probar este estupendo\u00a0tutorial interactivo<\/a>.<\/p>\n Puedes encontrar un \u00fatil post de Nic Raboy sobre caracter\u00edsticas m\u00e1s avanzadas de cbq\u00a0aqu\u00ed<\/a>.<\/p>\n Couchbase Server dispone de un amplio conjunto de\u00a0Puntos finales REST<\/a>. La mayor\u00eda tienen que ver con la gesti\u00f3n de las implantaciones.<\/p>\n Mostrar\u00e9 ejemplos usando curl. Hay una herramienta muy buena que recomiendo como reemplazo de curl,\u00a0httpie<\/a>. Es un poco m\u00e1s f\u00e1cil de usar y crea una salida coloreada. No lo usar\u00e9 aqu\u00ed ya que curl es m\u00e1s com\u00fan.<\/p>\n Me parecen interesantes otros puntos finales para ver lo que producen, pero para nuestros fines voy a centrarme en las consultas.<\/p>\n En un post anterior sobre la\u00a0Consola web de Couchbase<\/a>hemos echado un vistazo a las vistas. Las vistas crean un \u00edndice est\u00e1tico que puedes utilizar para recuperar informaci\u00f3n. Puedes controlar la respuesta con una serie de opciones. Gran parte del valor de las vistas proviene de c\u00f3mo se definen las funciones map\/reduce, pero estas opciones mejoran a\u00fan m\u00e1s el uso de las vistas para consultar datos. El filtrado por clave es especialmente \u00fatil. Ve\u00e1moslo.<\/p>\n Se accede a las vistas mediante URI de la forma<\/p>\n Para nuestra muestra de cerveza, podemos obtener toda la informaci\u00f3n sobre la f\u00e1brica y la cerveza de esta manera.<\/p>\n El resultado es una gran cantidad de informaci\u00f3n. He aqu\u00ed una breve muestra de la salida.<\/p>\n Puede ver la informaci\u00f3n clave. Podemos utilizarla para limitar los resultados. He aqu\u00ed un ejemplo utilizando una sola clave.<\/p>\n Y el resultado.<\/p>\n F\u00edjate que he a\u00f1adido la opci\u00f3n -g. Curl por defecto permite ciertos tipos de coincidencia de patrones (globbing). Esto funciona utilizando los caracteres especiales {} y []. Los necesitamos para especificar la clave en JSON. La forma m\u00e1s f\u00e1cil es desactivar globbing. No olvide tambi\u00e9n las comillas simples alrededor del par\u00e1metro.<\/p>\n Ese ejemplo filtraba por una clave. Aqu\u00ed hay uno que muestra c\u00f3mo obtener resultados que coincidan con m\u00e1s de una a la vez.<\/p>\n Observa que la salida no est\u00e1 ordenada.<\/p>\n M\u00e1s all\u00e1 del uso en la depuraci\u00f3n (o simplemente entender lo que est\u00e1 pasando con) puntos de vista, he visto algunas cosas interesantes escritas s\u00f3lo con secuencias de comandos de shell y este tipo de consulta.<\/p>\n Resulta que tambi\u00e9n se pueden ejecutar consultas N1QL desde la l\u00ednea de comandos. He aqu\u00ed un ejemplo sencillo que extrae todo del cubo de muestras de cerveza.<\/p>\n La salida incluye algunas estad\u00edsticas y los documentos completos. (Las estad\u00edsticas se env\u00edan a stderr en un Mac).<\/p>\n The N1QL command must have certain characters encoded to work properly. In this case, you can probably guess that %20 is the encoding for a single space. You can read more about that on this\u00a0Stack Overflow post<\/a>.<\/p>\n Hemos dedicado bastante tiempo a Couchbase Server. A continuaci\u00f3n nos adentraremos en el mundo m\u00f3vil con una inmersi\u00f3n en\u00a0Pasarela de sincronizaci\u00f3n<\/a>. Seguir\u00e9 m\u00e1s o menos el mismo formato. En el caso de Sync Gateway, sin embargo, veremos que hay mucho m\u00e1s que hacer utilizando las API REST. Esto incluir\u00e1 algunos trucos para ayudar a diagnosticar problemas comunes. Despu\u00e9s veremos Couchbase Lite, y terminaremos viendo c\u00f3mo se mueven los datos de extremo a extremo a trav\u00e9s de la pila completa. Permanece atento.<\/p>\n [buttongroup][button style=\"btn-link btn-lg\" icon=\"fa-arrow-left\" align=\"left\" iconcolor=\"#dd3333\u2033 type=\"link\" target=\"false\" title=\"Anterior: Consola web de Couchbase\" link=\"https:\/\/www.couchbase.com\/blog\/confortable-couchbase-mobile-couchbase-web-console\/\" linkrel=\"\"][button style=\"btn-link btn-lg\" icon=\"fa fa-arrow-right\" align=\"left\" iconcolor=\"#dd3333\u2033 type=\"link\" target=\"false\" title=\"Siguiente: Instalaci\u00f3n de Sync Gateway\" link=\"https:\/\/www.couchbase.com\/blog\/getting-comfortable-couchbase-mobile-installing-sync-gateway\/\" linkrel=\"\"][\/buttongroup]<\/p>\n Consulte m\u00e1s recursos en nuestra\u00a0portal para desarrolladores<\/a>\u00a0y s\u00edganos en Twitter @CouchbaseDev<\/a>.<\/p>\n Puede enviar preguntas a nuestro\u00a0foros<\/a>. Y participamos activamente en\u00a0Stack Overflow<\/a>.<\/p>\nFondo<\/h2>\n
L\u00ednea de comandos<\/h2>\n
Utilidades de l\u00ednea de comandos<\/h3>\n
couchbase-cli: la herramienta de gesti\u00f3n de cl\u00fasteres por l\u00ednea de comandos<\/h3>\n
Lista de servidores<\/h5>\n
$ couchbase-cli server-list -c localhost:8091 -u Administrator -p password<\/pre>\n
ns_1@127.0.0.1 127.0.0.1:8091 healthy active<\/pre>\n
Recogida de registros<\/h5>\n
$ couchbase-cli collect-logs-start --all-nodes<\/pre>\n
SUCCESS: Log collection started<\/pre>\n
$ couchbase-cli collect-logs-status<\/pre>\n
Status: completed\r\nDetails:\r\n Node: ns_1@127.0.0.1\r\n Status: collected\r\n path : \/Users\/hod\/Library\/Application Support\/Couchbase\/var\/lib\/couchbase\/tmp\/collectinfo-2016-12-06T213207-ns_1@127.0.0.1.zip<\/pre>\n
$ couchbase-cli collect-logs-stop<\/pre>\n
SUCCESS: collect logs successfully stopped<\/pre>\n
cbq: Shell de l\u00ednea de comandos para N1QL<\/h4>\n
$ cbq<\/pre>\n
No input credentials. In order to connect to a server with authentication, please provide credentials.\r\n Connected to : https:\/\/localhost:8091\/. Type Ctrl-D or QUIT to exit.\r\n\r\n Path to history file for the shell : \/Users\/hod\/.cbq_history \r\ncbq><\/pre>\n
Crear un \u00edndice primario<\/h5>\n
cbq> CREATE PRIMARY INDEX on `beer-sample`;<\/pre>\n
{\r\n \"requestID\": \"e708d3aa-cfa4-4322-9c8c-a6b6524ba99b\",\r\n \"signature\": null,\r\n \"results\": [\r\n ],\r\n \"status\": \"success\",\r\n \"metrics\": {\r\n \"elapsedTime\": \"579.828473ms\",\r\n \"executionTime\": \"578.844657ms\",\r\n \"resultCount\": 0,\r\n \"resultSize\": 0\r\n }\r\n}<\/pre>\nConsultas en curso<\/h5>\n
cbq> SELECT DISTINCT category, style FROM `beer-sample` WHERE type = \"beer\" AND style LIKE \"%Imperial%\" ORDER BY category, style;<\/pre>\n
{\r\n \"requestID\": \"2d4b3052-d42f-4081-bff1-1a06576dec92\",\r\n \"signature\": {\r\n \"category\": \"json\",\r\n \"style\": \"json\"\r\n },\r\n \"results\": [\r\n {\r\n \"category\": \"North American Ale\",\r\n \"style\": \"American-Style Imperial Stout\"\r\n },\r\n {\r\n \"category\": \"North American Ale\",\r\n \"style\": \"Imperial or Double India Pale Ale\"\r\n },\r\n {\r\n \"category\": \"North American Ale\",\r\n \"style\": \"Imperial or Double Red Ale\"\r\n }\r\n ],\r\n \"status\": \"success\",\r\n \"metrics\": {\r\n \"elapsedTime\": \"259.555065ms\",\r\n \"executionTime\": \"259.496458ms\",\r\n \"resultCount\": 3,\r\n \"resultSize\": 331,\r\n \"sortCount\": 3\r\n }\r\n}<\/pre>\nAPI REST<\/h3>\n
Ver consultas<\/h5>\n
GET \/[bucket-name]\/_design\/[ddoc-name]\/_view\/[view-name]<\/pre>\n
$ curl https:\/\/localhost:8092\/beer-sample\/_design\/beer\/_view\/brewery_beers<\/pre>\n
{\"total_rows\":7303,\"rows\":[\r\n{\"id\":\"21st_amendment_brewery_cafe\",\"key\":[\"21st_amendment_brewery_cafe\"],\"value\":null},\r\n{\"id\":\"21st_amendment_brewery_cafe-21a_ipa\",\"key\":[\"21st_amendment_brewery_cafe\",\"21st_amendment_brewery_cafe-21a_ipa\"],\"value\":null},\r\n{\"id\":\"21st_amendment_brewery_cafe-563_stout\",\"key\":[\"21st_amendment_brewery_cafe\",\"21st_amendment_brewery_cafe-563_stout\"],\"value\":null},<\/pre>\n$ curl -g https:\/\/localhost:8092\/beer-sample\/_design\/beer\/_view\/brewery_beers?key='[\"yuksom_breweries\"]'<\/pre>\n
{\"total_rows\":7303,\"rows\":[\r\n{\"id\":\"yuksom_breweries\",\"key\":[\"yuksom_breweries\"],\"value\":null}\r\n]\r\n}<\/pre>\n$ curl -g -u Administrator:password https:\/\/localhost:8092\/beer-sample\/_design\/beer\/_view\/brewery_beers?keys='[[\"yuksom_breweries\"],[\"wild_duck_brewing\"]]'<\/pre>\n
{\"total_rows\":7303,\"rows\":[\r\n{\"id\":\"yuksom_breweries\",\"key\":[\"yuksom_breweries\"],\"value\":null},\r\n{\"id\":\"wild_duck_brewing\",\"key\":[\"wild_duck_brewing\"],\"value\":null}\r\n]\r\n}<\/pre>\nConsultas N1QL<\/h5>\n
$ curl https:\/\/localhost:8093\/query\/service?statement='SELECT%20*%20FROM%20`beer-sample`'<\/pre>\n
% Total % Received % Xferd Average Speed Time Time Time Current\r\n Dload Upload Total Spent Left Speed\r\n100 16240 0 16240 0 0 299k 0 --:--:-- --:--:-- --:--:-- 299k<\/pre>\n
{\r\n \"requestID\": \"936d7b6a-1dea-4625-a6b2-1be91967187e\",\r\n \"signature\": {\r\n \"*\": \"*\"\r\n },\r\n \"results\": [\r\n {\r\n \"beer-sample\": {\r\n \"address\": [\r\n \"563 Second Street\"\r\n ],\r\n \"city\": \"San Francisco\",\r\n \"code\": \"94107\",\r\n \"country\": \"United States\",\r\n \"description\": \"The 21st Amendment Brewery offers a variety of award winning house made brews and American grilled cuisine in a comfortable loft like setting. Join us before and after Giants baseball games in our outdoor beer garden. A great location for functions and parties in our semi-private Brewers Loft. See you soon at the 21A!\",\r\n \"geo\": {\r\n \"accuracy\": \"ROOFTOP\",\r\n \"lat\": 37.7825,\r\n \"lon\": -122.393\r\n },\r\n \"name\": \"21st Amendment Brewery Cafe\",\r\n \"phone\": \"1-415-369-0900\",\r\n \"state\": \"California\",\r\n \"type\": \"brewery\",\r\n \"updated\": \"2010-10-24 13:54:07\",\r\n \"website\": \"https:\/\/www.21st-amendment.com\/\"\r\n }\r\n },\r\n {\r\n \"beer-sample\": {\r\n...<\/pre>\nPr\u00f3ximos pasos<\/h2>\n
Posdata<\/h2>\n