{"id":11705,"date":"2021-08-23T00:00:26","date_gmt":"2021-08-23T07:00:26","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=11705"},"modified":"2025-06-13T21:23:04","modified_gmt":"2025-06-14T04:23:04","slug":"get-started-nodejs-sdk-couchbase","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/ko\/get-started-nodejs-sdk-couchbase\/","title":{"rendered":"Couchbase\uc6a9 Node.js SDK\ub97c \uc2dc\uc791\ud558\ub294 \ubc29\ubc95"},"content":{"rendered":"

\ub2e8 \uba87 \uc904\uc758 \ucf54\ub4dc\ub85c<\/strong> \ub2e4\uc74c JavaScript \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc744 \ube4c\ub4dc\ud560 \ub54c Node.js\uc640 \ud568\uaed8 Couchbase\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n

\uc774 \ud5ec\ub85c \uc6d4\ub4dc<\/em> \ud29c\ud1a0\ub9ac\uc5bc\uc740 \uc0ac\uc6a9\uc758 \uae30\ubcf8 \uccab \ub2e8\uacc4\ub97c \uc548\ub0b4\ud569\ub2c8\ub2e4. Node.js SDK<\/a> \ub97c \uc0ac\uc6a9\ud558\uc5ec Couchbase 7.0\uc758 \ucd5c\uc2e0 \uae30\ub2a5<\/a>. \ucd5c\uc18c\ud55c JavaScript\uc640 NoSQL \ub370\uc774\ud130\ubca0\uc774\uc2a4<\/a> - \ud558\uc9c0\ub9cc \uc804\ubb38 \uc9c0\uc2dd\uc740 \ud544\uc694\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4.<\/p>\n

\uce74\uc6b0\uce58\ubca0\uc774\uc2a4 \uc124\uce58 \ubc0f \uc900\ube44<\/h2>\n

\uc560\ud50c\ub9ac\ucf00\uc774\uc158 \uac1c\ubc1c\uc744 \uc2dc\uc791\ud558\uae30 \uc804\uc5d0 \uba3c\uc800 \ub2e4\uc74c\uacfc \uac19\uc774 \uc124\uc815\ud558\uc138\uc694. \ucd5c\uc2e0 \ubc84\uc804\uc758 \uce74\uc6b0\uce58\ubca0\uc774\uc2a4 \uc11c\ubc84<\/a> \ub610\ub294 \uce74\uc6b0\uce58\ubca0\uc774\uc2a4 \ud074\ub77c\uc6b0\ub4dc \uacc4\uc815\uc5d0 \ubb34\ub8cc\ub85c \uac00\uc785\ud558\uc138\uc694.<\/a>.<\/p>\n

After installation, set up the `travel-sample` Bucket which creates a set of sample documents with flights, hotels, landmarks and more. You’ll find this data handy for testing a range of different kinds of applications.<\/p>\n

\uae30\ubcf8 Node.js \uc560\ud50c\ub9ac\ucf00\uc774\uc158 \uc124\uc815\ud558\uae30<\/h2>\n

\uc774 \uae00\uc758 \ub098\uba38\uc9c0 \ubd80\ubd84\uc5d0\uc11c\ub294 \uc790\uc8fc \uc0ac\uc6a9\ud558\ub294 \ucf54\ub4dc \ud3b8\uc9d1 \ub3c4\uad6c\uc640 \ud568\uaed8 Node.js\uac00 \uc774\ubbf8 \uc124\uce58\ub418\uc5b4 \uc788\ub2e4\uace0 \uac00\uc815\ud558\uaca0\uc2b5\ub2c8\ub2e4. (\ucc98\uc74c \uc2dc\uc791\ud558\ub294 \uac1c\ubc1c\uc790\ub294 \uba87 \uac00\uc9c0 \uae30\ubcf8 \ud29c\ud1a0\ub9ac\uc5bc\uc744 \ucc3e\uc544\uc11c \uc791\uc5c5 \ud658\uacbd\uc744 \uad6c\ucd95\ud574\uc57c \ud569\ub2c8\ub2e4.)<\/p>\n

\uccab \ubc88\uc9f8 \ub2e8\uacc4\ub294 \ud504\ub85c\uc81d\ud2b8 \ud3f4\ub354\ub97c \ub9cc\ub4e4\uace0 \ub2e4\uc74c\uc744 \uc0ac\uc6a9\ud558\uc5ec \ud328\ud0a4\uc9c0 \ud15c\ud50c\ub9bf\uc744 \ucd08\uae30\ud654\ud558\ub294 \uac83\uc785\ub2c8\ub2e4. npm init -y<\/code>\ub97c \ud074\ub9ad\ud569\ub2c8\ub2e4:<\/p>\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<\/pre>\n
<\/div>\n
\uce74\uc6b0\uce58\ubca0\uc774\uc2a4 Node.js \ubaa8\ub4c8 \uc885\uc18d\uc131 \ucd94\uac00\ud558\uae30<\/h2>\n
\ub2e4\uc74c\uc73c\ub85c, \ub2e4\uc74c \uc885\uc18d\uc131\uc5d0 Couchbase Node.js \ubaa8\ub4c8\uc744 \ucd94\uac00\ud569\ub2c8\ub2e4. package.json<\/code> \ub97c \uc2e4\ud589\ud558\uc5ec npm \uc124\uce58<\/code> \uba85\ub839\uacfc \ud568\uaed8 --\uc800\uc7a5<\/code> \uc635\uc158\uc73c\ub85c \uc124\uc815\ud569\ub2c8\ub2e4:<\/p>\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 No description\r\nnpm WARN cb-node@1.0.0 No repository field.\r\n\r\n+ couchbase@3.2.0\r\n<\/pre>\n
<\/div>\n
\uadf8\ub9ac\uace0 package.json<\/code> \ud30c\uc77c\uc5d0 \uc885\uc18d\uc131 \uc139\uc158\uc774 \uc0dd\uacbc\uc2b5\ub2c8\ub2e4:<\/p>\n
\"dependencies\": {\r\n\"couchbase\": \"^3.2.0\"\r\n}\r\n<\/pre>\n
<\/div>\n
\uce74\uc6b0\uce58\ubca0\uc774\uc2a4 \ud074\ub7ec\uc2a4\ud130\uc5d0 \uc5f0\uacb0<\/h2>\n
\ubaa8\ub4c8\uc774 \ubaa8\ub450 \uc81c\ub300\ub85c \uc124\uce58\ub418\uc5c8\ub294\uc9c0, \uadf8\ub9ac\uace0 \ud074\ub7ec\uc2a4\ud130\uc5d0 \uc5f0\uacb0\ud560 \uc218 \uc788\ub294\uc9c0 \ud14c\uc2a4\ud2b8\ud558\ub824\uba74 Couchbase \ubc84\ud0b7\uc5d0 \uc5f0\uacb0\ud558\uace0 \uc561\uc138\uc2a4\ud560 \uc218 \uc788\ub294 \uc0ac\uc6a9\uc790\ub97c \ucd94\uac00\ud558\uae30 \uc704\ud574 \ubc84\ud0b7 \uc774\ub984\uc744 \uc54c\uc544\uc57c \ud569\ub2c8\ub2e4.<\/p>\n
var couchbase = require(\"couchbase\");\r\n<\/pre>\n
<\/div>\n
\uac00\uc7a5 \uac04\ub2e8\ud558\uac8c \uc0ac\uc6a9\ud558\ub824\uba74 \uc608\uc81c\uc758 \ub098\uba38\uc9c0 \ubd80\ubd84\uc744 \uc5f0\uacb0 \ud568\uc218\ub85c \ub798\ud551\ud558\uc138\uc694:<\/p>\n
couchbase.connect(\r\n  'couchbase:\/\/127.0.0.1',\r\n  {\r\n    username: 'Administrator',\r\n    password: 'Administrator'\r\n  },\r\n...)\r\n<\/pre>\n
<\/div>\n
\ub610\ud55c \ud0a4 \uc2a4\ud398\uc774\uc2a4\ub97c \uc120\ud0dd\ud574\uc57c \ud569\ub2c8\ub2e4, \ubc94\uc704 \ub610\ub294 \uceec\ub809\uc158<\/a> - \uc5d0 \uc561\uc138\uc2a4\ud558\ub824\ub294 \uacbd\uc6b0 \ud574\ub2f9\ud569\ub2c8\ub2e4. \uc774 \ucd08\uae30 \ud14c\uc2a4\ud2b8 \ucf00\uc774\uc2a4\uc5d0\uc11c\ub294 \ubc94\uc704\uc640 \uceec\ub809\uc158\uc744 \ubaa8\ub450 \ubb34\uc2dc\ud558\ub294 \uae30\ubcf8 \uceec\ub809\uc158\uc744 \uc0ac\uc6a9\ud558\uaca0\uc2b5\ub2c8\ub2e4:<\/p>\n
...\r\n(err, cluster) => {\r\n  var bucket = cluster.bucket('travel-sample')\r\n  var coll = bucket.defaultCollection()\r\n...\r\n<\/pre>\n
<\/div>\n
JSON \ubb38\uc11c \uac00\uc838\uc624\uae30<\/h2>\n
\uc218\ucc9c \uac1c\uc758 \uc0d8\ud50c\uc774 \uc788\uc2b5\ub2c8\ub2e4. JSON<\/a> \ubb38\uc11c\uc5d0 \uc788\ub294 \uc5ec\ud589 \uc0d8\ud50c<\/code> \ubc84\ud0b7.<\/p>\n
\uae30\ubcf8 \ud0a4-\uac12 \uc5f0\uc0b0\uc744 \uc0ac\uc6a9\ud558\uc5ec \ubb38\uc11c\ub97c \uc694\uccad\ud558\ub824\uba74 \ub2e4\uc74c\uc744 \uc0ac\uc6a9\ud558\uc138\uc694. get<\/code> \ud568\uc218\ub97c \ud638\ucd9c\ud558\uace0 \ubb38\uc11c ID\ub97c \uc785\ub825\ud569\ub2c8\ub2e4. \uc544\ub798 \uadf8\ub9bc\uacfc \uac19\uc774 \uc6f9 \ucf58\uc194\uc744 \uc0ac\uc6a9\ud558\uc5ec \uc9c0\uc815\ub41c \ud638\ud154 \ubb38\uc11c\ub97c \uac80\uc0c9\ud558\uc5ec ID\ub97c \uc5bb\uc744 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n
<\/div>\n
\"A<\/a><\/p>\n
<\/div>\n
\uc751\ub2f5\uacfc \uc624\ub958\ub97c \uc7a1\uc740 \ub2e4\uc74c \ucf58\uc194\uc5d0 \uc778\uc1c4\ud558\uc5ec \uc131\uacf5 \uc5ec\ubd80\ub97c \ud655\uc778\ud569\ub2c8\ub2e4.<\/p>\n
coll.get('hotel_5336', (err, res) => {\r\n  if (err) throw err\r\n  console.log(res.value)\r\n<\/pre>\n
<\/div>\n
\uc5ec\uae30\uae4c\uc9c0 \uc77d\uc73c\uc168\uace0 \uccab \ubc88\uc9f8 Node.js \uc571\uc774\ub77c\uba74 \ucd95\ud558\ub4dc\ub9bd\ub2c8\ub2e4! \uc774\uc81c \uac00\uc7a5 \uac04\ub2e8\ud55c \uad6c\ubb38\uc73c\ub85c Couchbase\uc5d0\uc11c \ubb38\uc11c\ub97c \uac00\uc838\uc624\ub294 \ubc29\ubc95\uc744 \uc54c\uac8c \ub418\uc5c8\uc2b5\ub2c8\ub2e4. \uc804\uccb4 \ucf54\ub4dc \uc0d8\ud50c\uc740 \uc544\ub798\uc5d0 \uc788\uc2b5\ub2c8\ub2e4:<\/p>\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<\/pre>\n
<\/div>\n
\uc774 \uc608\uc2dc\ub294 \ube14\ub85c\ud0b9 \ucf54\ub4dc\uac00 \ud3ec\ud568\ub41c \uae30\ubcf8 \uc608\uc2dc\ub77c\ub294 \uc810\uc744 \uae30\uc5b5\ud558\uc138\uc694. \ub2e4\uc74c \uae00\uc5d0\uc11c\ub294 \ube14\ub85c\ud0b9\uc744 \uc0ac\uc6a9\ud558\uc9c0 \uc54a\ub294 \ube44\ub3d9\uae30 \uc608\uc2dc\ub97c \ubcf4\uc5ec\ub4dc\ub9ac\ub294 \uc608\uc81c\ub97c \ub2e4\ub8f0 \uc608\uc815\uc785\ub2c8\ub2e4.<\/p>\n
JavaScript\ub97c \uc0ac\uc6a9\ud558\uc5ec \ubb38\uc11c \uc0dd\uc131 \ub610\ub294 \uc0bd\uc785<\/h2>\n
\uc0c8 \ubb38\uc11c\ub97c \ub9cc\ub4e4\ub824\uba74 \uc5c5\uc11c\ud2b8<\/code> \ud568\uc218\ub97c \ud638\ucd9c\ud569\ub2c8\ub2e4. \uc774 \ud568\uc218\ub294 \uc5c5\uc11c\ud2b8<\/code> (\uc0c8 \ubb38\uc11c\uc758 \uacbd\uc6b0) \uc0bd\uc785\ucc98\ub7fc \uc791\ub3d9\ud558\uac70\ub098 \uc774\ubbf8 \ub3d9\uc77c\ud55c ID\ub97c \uac00\uc9c4 \ubb38\uc11c\uac00 \uc788\ub294 \uacbd\uc6b0 \ub2e8\uc21c\ud788 \uc5c5\ub370\uc774\ud2b8\ud558\uae30 \ub54c\ubb38\uc785\ub2c8\ub2e4.<\/p>\n
Ensure that the user you specify has adequate write privileges before trying an `upsert`. The examples below assume full Bucket administrative access to keep things simple.<\/p>\n
\uc774 \uc2dc\uc810\uc5d0\uc11c \uc2a4\ud06c\ub9bd\ud2b8\ub97c \uc0c8 \ud30c\uc77c\uc5d0 \ubcf5\uc0ac\ud558\uc5ec \ub2e4\uc74c\uc744 \ud14c\uc2a4\ud2b8\ud569\ub2c8\ub2e4. \uc5c5\uc11c\ud2b8<\/code> \uae30\ub2a5\uacfc \ub3c5\ub9bd\uc801\uc778 get<\/code> \ud568\uc218\uc785\ub2c8\ub2e4.<\/p>\n
Upsert<\/code> \uc5d0\ub294 \ubb38\uc11c ID\uc640 \ubb38\uc11c \ub370\uc774\ud130\uac00 \ud3ec\ud568\ub41c JSON \uac1d\uccb4\uac00 \ud544\uc694\ud569\ub2c8\ub2e4. \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc5d0 \ud478\uc2dc\ud560 \ub54c ID\ub97c \uc785\ub825\ud569\ub2c8\ub2e4. JSON \ub370\uc774\ud130\ub97c \uc800\uc7a5\ud560 \ubcc0\uc218\ub97c \ub9cc\ub4e4\uace0 \uc5ec\uae30\uc5d0 \uba87 \uac00\uc9c0 \uc694\uc18c\ub97c \ucd94\uac00\ud569\ub2c8\ub2e4.<\/p>\n
newdoc = {\r\n  type: \"hotel\",\r\n  id: 2,\r\n  name: \"Le Grande\",\r\n  city: \"Paris, France\"\r\n}\r\n<\/pre>\n
<\/div>\n
\uadf8\ub7f0 \ub2e4\uc74c \uc5c5\uc11c\ud2b8<\/code> \ud568\uc218\ub97c \uc0c8 \ubb38\uc11c ID\uc640 \ud568\uaed8 \uc0ac\uc6a9\ud558\uc138\uc694.<\/p>\n
coll.upsert('hotel_2', newdoc, (err, res) => {\r\n  console.log(res)\r\n})\r\n<\/pre>\n
<\/div>\n
\ucd9c\ub825\uc744 \uc778\uc1c4\ud558\uc5ec \ubcc0\uacbd\/\uac70\ub798\uac00 \uc644\ub8cc\ub418\uc5c8\uc74c\uc744 \ud45c\uc2dc\ud569\ub2c8\ub2e4. \uadf8\ub9ac\uace0 CAS<\/code> \uac12\uc740 \ub2e4\ub978 \uc0c1\ud669\uc5d0\uc11c \ub2e4\ub978 \ub370\uc774\ud130 \ubc84\uc804\uc744 \ucd94\uc801\/\uc7a0\uae08\ud558\uae30 \uc704\ud574 \ub370\uc774\ud130\uc758 \ube48\ud2f0\uc9c0\ub97c \ube44\uad50\ud558\ub294 \ub370 \uc0ac\uc6a9\ub429\ub2c8\ub2e4.<\/p>\n
\uc2a4\ud06c\ub9bd\ud2b8\ub97c \uc2e4\ud589\ud558\uba74 \ub2e4\uc74c\uacfc \uac19\uc740 \ud2b8\ub79c\uc7ad\uc158 \uc694\uc57d\uc774 \uc0dd\uc131\ub429\ub2c8\ub2e4:<\/p>\n
$ node app.js\r\n\r\nMutationResult {\r\ncas: CbCas<1628915917601505280>,\r\ntoken: CbMutationToken<4:251812459673841:85:travel-sample> }\r\n<\/pre>\n
<\/div>\n
Now you can go back to your original `get` script and drop in the new document ID to test that it can now be retrieved.<\/p>\n
Here is the full script for doing the simple `upsert` in a standalone Node.js script.<\/p>\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<\/pre>\n
<\/div>\n
\uacb0\ub860<\/h2>\n
\uc774 \uae30\ubcf8 \uc790\ubc14\uc2a4\ud06c\ub9bd\ud2b8\uc640 \uce74\uc6b0\uce58\ubca0\uc774\uc2a4 \uc608\uc81c\ub97c \ud568\uaed8 \ub530\ub77c\ud574 \uc8fc\uc154\uc11c \uac10\uc0ac\ud569\ub2c8\ub2e4. Node.js\ub97c \uc0ac\uc6a9\ud558\uc5ec NoSQL \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc744 \uad6c\ucd95\ud558\ub294 \ub370 \ub3c4\uc6c0\uc774 \ub418\uc168\uae30\ub97c \ubc14\ub78d\ub2c8\ub2e4.<\/p>\n
\ub354 \ub9ce\uc740 SDK \uad00\ub828 \uc608\uc81c \ubcf4\uae30 Node.js SDK \uc124\uba85\uc11c\ub97c \ud655\uc778\ud558\uc138\uc694.<\/a>. \ub2e4\uc74c \uac8c\uc2dc\ubb3c\uc5d0\uc11c\ub294 \ube44\ub3d9\uae30\uc801\uc73c\ub85c \ud568\uc218\ub97c \uc0ac\uc6a9\ud558\ub294 \ubc29\ubc95\uc744 \uc0b4\ud3b4\ubcf4\uace0 \ucffc\ub9ac \ubc0f \uac80\uc0c9\uacfc \uac19\uc740 \ub2e4\ub978 Couchbase \ud568\uc218\uc5d0 \ub300\ud574 \uc790\uc138\ud788 \uc54c\uc544\ubcf4\uaca0\uc2b5\ub2c8\ub2e4.<\/p>\n
\ub098\uba38\uc9c0 Node.js + Couchbase \ubc29\ubc95 \uc2dc\ub9ac\uc988\ub3c4 \ud655\uc778\ud574 \ubcf4\uc138\uc694:<\/em><\/p>\n