{"id":1982,"date":"2021-08-23T00:00:26","date_gmt":"2021-08-23T07:00:26","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/get-started-nodejs-sdk-couchbase\/"},"modified":"2021-08-23T00:00:26","modified_gmt":"2021-08-23T07:00:26","slug":"get-started-nodejs-sdk-couchbase","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/get-started-nodejs-sdk-couchbase\/","title":{"rendered":"C\u00f3mo empezar con el SDK de Node.js para Couchbase"},"content":{"rendered":"

Con solo unas pocas l\u00edneas de c\u00f3digo<\/strong> puedes empezar a usar Couchbase con Node.js para crear tu pr\u00f3xima aplicaci\u00f3n de JavaScript.<\/p>\n\n\n\n

Este hola mundo<\/em> el tutorial te gu\u00eda a trav\u00e9s de los primeros pasos b\u00e1sicos de uso el SDK de Node.js<\/a> con el \u00faltimas caracter\u00edsticas de Couchbase 7.0<\/a>. Se asume que tienes al menos cierta familiaridad tanto con JavaScript como Bases de datos NoSQL<\/a> \u2013 pero no se requiere experiencia.<\/p>\n\n\n\n

Instalar y preparar Couchbase<\/h2>\n\n\n\n

Antes de sumergirte en el desarrollo de una aplicaci\u00f3n, comienza por configurar la \u00faltima versi\u00f3n de Couchbase Server<\/a> o reg\u00edstrese gratis para obtener una cuenta de Couchbase Cloud<\/a>.<\/p>\n\n\n\n

Despu\u00e9s de la instalaci\u00f3n, configure el Bucket `travel-sample`, el cual crea un conjunto de documentos de muestra con vuelos, hoteles, puntos de referencia y m\u00e1s. Encontrar\u00e1 estos datos \u00fatiles para probar una variedad de diferentes tipos de aplicaciones.<\/p>\n\n\n\n

Configurar una aplicaci\u00f3n b\u00e1sica de Node.js<\/h2>\n\n\n\n

Por el resto de esta publicaci\u00f3n, asumir\u00e9 que ya tienes Node.js instalado junto con tus herramientas de edici\u00f3n de c\u00f3digo favoritas. (Los desarrolladores primerizos deben buscar algunos tutoriales b\u00e1sicos para obtener un entorno de trabajo).<\/p>\n\n\n\n

Su primer paso es crear una carpeta de proyecto e inicializar la plantilla de paquete con npm init -y<\/code>, como se muestra a continuaci\u00f3n:<\/p>\n\n\n\n

tyler@local:~\/src\/cb-node$ npm init -y\r\nWrote to \/home\/tyler\/src\/cb-node\/package.json:\r\n\r\n{\r\n\"name\": \"cb-node\",\r\n\"version\": \"1.0.0\",\r\n\"description\": \"\",\r\n\"main\": \"index.js\",\r\n\"scripts\": {\r\n\"test\": \"echo \"Error: no test specified\" && exit 1\"\r\n},\r\n\"keywords\": [],\r\n\"author\": \"\",\r\n\"license\": \"ISC\"\r\n}\r\n<\/code><\/pre>\n\n\n\n
Agregar la dependencia del m\u00f3dulo de Node.js para Couchbase<\/h2>\n\n\n\n
A continuaci\u00f3n, agregue el m\u00f3dulo de Node.js de Couchbase a las dependencias en package.json<\/code> al ejecutar el npm install<\/code> comando con el --guardar<\/code> opci\u00f3n, as\u00ed:<\/p>\n\n\n\n
$ npm install couchbase --save\r\n> couchbase@3.2.0 install \/home\/tyler\/src\/cb-node\/node_modules\/couchbase\r\n> prebuild-install || node-gyp rebuild\r\n\r\n...\r\n\r\nnpm WARN cb-node@1.0.0 Sin descripci\u00f3n\r\nnpm WARN cb-node@1.0.0 Sin campo de repositorio.\r\n\r\n+ couchbase@3.2.0\r\n<\/code><\/pre>\n\n\n\n
El package.json<\/code> el archivo ahora tiene la secci\u00f3n de dependencias:<\/p>\n\n\n\n
\"dependencies\": {\n\"couchbase\": \"^3.2.0\"\n}\r\n<\/code><\/pre>\n\n\n\n
Conectarse a un cl\u00faster de Couchbase<\/h2>\n\n\n\n
Para probar que todos los m\u00f3dulos est\u00e9n instalados correctamente \u2013y que puedas conectarte al cl\u00faster\u2013, necesitas saber el nombre del bucket para conectarte y agregar un usuario que pueda acceder al bucket de Couchbase.<\/p>\n\n\n\n
var couchbase = require("couchbase");\r\n<\/code><\/pre>\n\n\n\n
Para el uso m\u00e1s simple, envuelve el resto del ejemplo en una funci\u00f3n connect:<\/p>\n\n\n\n
couchbase.connect(\n  'couchbase:\/\/127.0.0.1',\n  {\n    username: 'Administrator',\n    password: 'Administrator'\n  },\n...)\r\n<\/code><\/pre>\n\n\n\n
Tambi\u00e9n debes seleccionar el espacio de claves, es decir, \u00c1mbito o Colecci\u00f3n(es)<\/a> \u2013 usted desea acceder, si corresponde. En este caso de prueba inicial, usaremos una Colecci\u00f3n predeterminada que ignora por completo los \u00c1mbitos y las Colecciones:<\/p>\n\n\n\n
...\n(err, cluster) => {\n  var bucket = cluster.bucket('travel-sample')\n  var coll = bucket.defaultCollection()\n...\r\n<\/code><\/pre>\n\n\n\n
Obtener un documento JSON<\/h2>\n\n\n\n
Hay miles de muestras JSON<\/a> documentos en el travel-sample<\/code> Balde.<\/p>\n\n\n\n
Para solicitar un documento utilizando operaciones b\u00e1sicas de clave-valor, utilice el conseguir<\/code> funci\u00f3n y proporcione un ID de documento. Puede usar la consola web para buscar un documento de hotel determinado para obtener el ID, como se muestra a continuaci\u00f3n.<\/p>\n\n\n\n
\"A<\/a><\/p>\n\n\n\n
Capture la respuesta y el error, luego imprima en la consola para ver si es exitoso.<\/p>\n\n\n\n
coll.get('hotel_5336', (err, res) => {\n  if (err) throw err\n  console.log(res.value)\r\n<\/code><\/pre>\n\n\n\n
Si lleg\u00f3 hasta aqu\u00ed y es su primera aplicaci\u00f3n de Node.js, \u00a1felicitaciones! Ahora sabe c\u00f3mo obtener un documento de Couchbase con la sintaxis m\u00e1s sencilla. El c\u00f3digo completo de ejemplo se muestra a continuaci\u00f3n:<\/p>\n\n\n\n
var couchbase = require('couchbase')\r\n\r\ncouchbase.connect(\r\n  'couchbase:\/\/127.0.0.1',\r\n  {\r\n    username: 'Administrator',\r\n    password: 'Administrator'\r\n  },\r\n  (err, cluster) => {\r\n    var bucket = cluster.bucket('travel-sample')\r\n    var coll = bucket.defaultCollection()\r\n\r\n    coll.get('hotel_5336', (err, res) => {\r\n      if (err) throw err\r\n      console.log(res.value)\r\n    })\r\n  }\r\n)\r\n<\/code><\/pre>\n\n\n\n
Tenga en cuenta que este es un ejemplo b\u00e1sico que incluye c\u00f3digo bloqueante. En un art\u00edculo futuro, abordar\u00e9 un ejemplo que muestra ejemplos as\u00edncronos no bloqueantes en su lugar.<\/p>\n\n\n\n
Crear o actualizar un documento usando JavaScript<\/h2>\n\n\n\n
Para crear un nuevo documento puedes usar el actualizar o insertar<\/code> funci\u00f3n. Se llama actualizar o insertar<\/code> porque act\u00faa como un insert (para documentos nuevos) o si ya hay un documento con el mismo ID, simplemente lo actualizar\u00e1.<\/p>\n\n\n\n
Aseg\u00farese de que el usuario que especifique tenga los privilegios de escritura adecuados antes de intentar un `upsert`. Los ejemplos a continuaci\u00f3n asumen acceso administrativo completo al Bucket para mantener las cosas simples.<\/p>\n\n\n\n
En este punto, copia tu script en un nuevo archivo para probar el actualizar o insertar<\/code> funcionalidad independiente de la conseguir<\/code> funci\u00f3n.<\/p>\n\n\n\n
Actualizar o insertar<\/code> requiere un ID de documento y un objeto JSON con los datos del documento. Proporcionas el ID al enviarlo a la base de datos. Crea la variable para almacenar los datos JSON y agr\u00e9gale algunos elementos.<\/p>\n\n\n\n
newdoc = {\n  type: \"hotel\",\n  id: 2,\n  name: \"Le Grande\",\n  city: \"Par\u00eds, Francia\"\n}\r\n<\/code><\/pre>\n\n\n\n
A continuaci\u00f3n, llame al actualizar o insertar<\/code> funci\u00f3n junto con el nuevo ID de documento.<\/p>\n\n\n\n
coll.upsert('hotel_2', newdoc, (err, res) => {\n  console.log(res)\n})\r\n<\/code><\/pre>\n\n\n\n
Imprimir la salida para mostrar que una mutaci\u00f3n o transacci\u00f3n se ha completado. El CAS<\/code> el valor se utiliza en otros contextos para comparar la antig\u00fcedad de los datos con el fin de rastrear o bloquear diferentes versiones de los datos.<\/p>\n\n\n\n
La ejecuci\u00f3n del script produce el siguiente resumen de transacci\u00f3n:<\/p>\n\n\n\n
Aplicaci\u00f3n app.js del nodo $\r\n\r\nMutationResult {\ncas: CbCas<1628915917601505280>,\ntoken: CbMutationToken<4:251812459673841:85:travel-sample> }\r\n<\/code><\/pre>\n\n\n\n
Ahora puedes volver a tu script `get` original e insertar el nuevo ID de documento para comprobar que ya se puede recuperar.<\/p>\n\n\n\n
Aqu\u00ed est\u00e1 el script completo para hacer el `upsert` simple en un script de Node.js independiente.<\/p>\n\n\n\n
var couchbase = require('couchbase')\r\n\r\ncouchbase.connect(\r\n  'couchbase:\/\/127.0.0.1',\r\n  {\r\n    username: 'Administrator',\r\n    password: 'Administrator'\r\n  },\r\n  (err, cluster) => {\r\n    var bucket = cluster.bucket('travel-sample')\r\n    var coll = bucket.defaultCollection()\r\n\r\n    newdoc = {\r\n      type: "hotel",\r\n      id: 2,\r\n      name: "Le Grande",\r\n      city: "Paris, France"\r\n    }\r\n\r\n    coll.upsert('hotel_2', newdoc, (err, res) => {\r\n      console.log("Hotel added")\r\n      console.log(res)\r\n    })\r\n  }\r\n)\r\n<\/code><\/pre>\n\n\n\n
Conclusi\u00f3n<\/h2>\n\n\n\n
Gracias por seguir estos ejemplos b\u00e1sicos de JavaScript con Couchbase. Espero que esto te ayude a comenzar a construir una aplicaci\u00f3n NoSQL usando Node.js.<\/p>\n\n\n\n
Para obtener m\u00e1s ejemplos relacionados con el SDK consulta la documentaci\u00f3n del SDK de Node.js<\/a>. En publicaciones futuras, exploraremos el uso de las funciones de forma asincr\u00f3nica y profundizaremos en otras funciones de Couchbase como query y search.<\/p>\n\n\n\n
Ponte al d\u00eda con el resto de la serie de tutoriales de Node.js + Couchbase:<\/em><\/p>\n\n\n\n