{"id":2192,"date":"2016-03-10T21:51:31","date_gmt":"2016-03-10T21:51:30","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2192"},"modified":"2025-10-09T07:10:18","modified_gmt":"2025-10-09T14:10:18","slug":"developer-preview-of-new-sub-document-api-included-w-2-2-6-release-of-couchbase-net-sdk","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/ko\/developer-preview-of-new-sub-document-api-included-w-2-2-6-release-of-couchbase-net-sdk\/","title":{"rendered":"2.2.6 \ub9b4\ub9ac\uc2a4\uc5d0 \ud3ec\ud568\ub41c \uc0c8\ub85c\uc6b4 \ud558\uc704 \ubb38\uc11c API\uc758 \uac1c\ubc1c\uc790 \ud504\ub9ac\ubdf0(Couchbase .NET SDK)"},"content":{"rendered":"

\ucc38\uace0: \ubaa8\ub4e0 \uc608\uc81c\ub294 \ub2e4\uc74c\uc5d0\uc11c \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uc5ec\uae30<\/a>.<\/strong><\/p>\n

\uc624\ub298 \uc800\ud76c\ub294 \uace7 \ucd9c\uc2dc\ub420 Couchbase Server\uc758 \uc0c8\ub85c\uc6b4 \uae30\ub2a5\uc5d0 \ub300\ud55c \ub9e4\uc6b0 \ud2b9\ubcc4\ud55c \uac1c\ubc1c\uc790 \ud504\ub9ac\ubdf0(DP)\ub97c \uacf5\uac1c\ud569\ub2c8\ub2e4. \ud558\uc704 \ubb38\uc11c<\/em>\ub97c \uc77c\ubc18 Couchbase Server .NET SDK 2.2.6\uacfc \ud568\uaed8 \ucd9c\uc2dc\ud569\ub2c8\ub2e4! \ud558\uc704 \ubb38\uc11c API\ub294 Couchbase Server 4.5\uc758 \uac1c\ubc1c\uc790 \ud504\ub9ac\ubdf0\uc5d0\uc11c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub294 Couchbase Server\uc758 \uc0c8\ub85c\uc6b4 \uae30\ub2a5\uc785\ub2c8\ub2e4.<\/p>\n

\uae30\uc5b5\ud558\uc2dc\uaca0\uc9c0\ub9cc, Couchbase\uc5d0\uc11c \ubaa8\ub4e0 \ubb38\uc11c \ubcc0\uacbd\uc740 \uc6d0\uc790\uc801\uc774\uba70 \uc804\uccb4 \ubb38\uc11c\uc640 \uad00\ub828\uc774 \uc788\uc2b5\ub2c8\ub2e4. \ub2e8\uc77c \ud544\ub4dc\ub9cc \ubcc0\uacbd\ud55c \ub2e4\uc74c \uc5c5\ub370\uc774\ud2b8\ub97c \uc218\ud589\ud558\ub824\ub294 \uacbd\uc6b0 \uc0c8 \uc218\uc815\ubcf8\uc5d0 \uc758\ud574 Couchbase \uc11c\ubc84\uc758 \uc804\uccb4 \ubb38\uc11c\uac00 \ubcf5\uc0ac\ub429\ub2c8\ub2e4. \ubb38\uc81c\ub294 \ubb38\uc11c\uac00 \ud06c\uac70\ub098 \ub124\ud2b8\uc6cc\ud06c\uac00 \ub290\ub9b0 \uacbd\uc6b0(\ub610\ub294 \ub458 \ub2e4) \uc218\uc815\ub418\uc9c0 \uc54a\uc740 \ub370\uc774\ud130\ub97c \uc804\uc1a1\ud558\ub294 \ub370 \ub9ce\uc740 \ub9ac\uc18c\uc2a4\uac00 \ub0ad\ube44\ub41c\ub2e4\ub294 \uac83\uc785\ub2c8\ub2e4. \ub354 \ub098\uc740 \uc131\ub2a5\uc758 \uc194\ub8e8\uc158\uc740 \ubb38\uc11c\uc758 \uc77c\ubd80\ubd84 \ub610\ub294 \ubcc0\uacbd\ub41c \uac12\ub9cc \uc804\uc1a1\ud558\ub294 \uac83\uc785\ub2c8\ub2e4. \uae30\ubcf8\uc801\uc73c\ub85c \ud558\uc704 \ubb38\uc11c API\ub97c \uc0ac\uc6a9\ud558\uba74 \ubb38\uc11c\uc758 \uc694\uc18c\ub97c \uc5c5\ub370\uc774\ud2b8\ud558\uac70\ub098 \uc694\uc18c\ub97c \uc0ad\uc81c\ud560 \ub54c \uacbd\ub85c<\/i>\u00a0\ub97c \uc720\uc120\uc73c\ub85c \uc804\uc1a1\ud558\uba74 \ubb38\uc11c\uc758 \ud574\ub2f9 \ubd80\ubd84\ub9cc \uc218\uc815\ub429\ub2c8\ub2e4.<\/p>\n

API\uc5d0\uc11c \uc9c0\uc6d0\ud558\ub294 \uc791\uc5c5\uc5d0\ub294 \uac1c\ubcc4 \uc911\ucca9 \uc694\uc18c\uc758 \ubcc0\uc774\ubd80\ud130 \uc5ec\ub7ec \uac00\uc9c0\uac00 \uc788\uc2b5\ub2c8\ub2e4. sub-<\/em>\ubb38\uc11c\ub97c \ubc30\uc5f4 \ubc0f \uc0ac\uc804 \uc218\uc815\uc5d0 \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uce74\uc6b4\ud130 \uc5f0\uc0b0\ub3c4 \uc9c0\uc6d0\ub418\uba70, \uc784\ubca0\ub514\ub4dc JSON \uc870\uac01\uc5d0 \ub300\ud55c \uac80\uc0c9 \uc5f0\uc0b0\ub3c4 \uc9c0\uc6d0\ub429\ub2c8\ub2e4.<\/p>\n

API\ub294 \uc720\ucc3d\ud55c \uc778\ud130\ud398\uc774\uc2a4\ub97c \ud1b5\ud574 \ub178\ucd9c\ub418\uc5b4 \uc5ec\ub7ec \uc5f0\uc0b0\uc744 \ucd94\uac00\ud55c \ub2e4\uc74c \ubb38\uc11c\uc5d0 \ub300\ud574 \uc6d0\uc790\uc801\uc73c\ub85c \uc2e4\ud589\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ubcc0\uc774 \uc5f0\uc0b0\uc744 \uc704\ud55c \ube4c\ub354\uc640 \uc77d\uae30 \ub610\ub294 '\uc870\ud68c'\ub97c \uc704\ud55c \ube4c\ub354, \uc8fc\uc5b4\uc9c4 \uacbd\ub85c\uc5d0 \uc694\uc18c\uac00 \uc874\uc7ac\ud558\ub294\uc9c0 \ud655\uc778\ud558\uae30 \uc704\ud55c \ube4c\ub354 \ub4f1 \ub450 \uac00\uc9c0 '\ube4c\ub354'\uac00 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n

\uc911\uc694: \ud558\uc704 \ubb38\uc11c API\ub294 \uac1c\ubc1c\uc790 \ud504\ub9ac\ubdf0\uc785\ub2c8\ub2e4!!!<\/h2>\n

\uc774\uac83\uc740 \ud558\uc704 \ubb38\uc11c API\uc758 \ucd08\uae30 DP\uc774\uba70 \uc77c\ubc18\uc801\uc778 API\uac00 \ub9b4\ub9ac\uc2a4 \uc804\uc5d0 \uac70\uce58\ub294 \uc77c\ubc18\uc801\uc778 \uc810\uac80\uacfc \uade0\ud615\uc744 \uac70\uce58\uc9c0 \uc54a\uc558\ub2e4\ub294 \uc810\uc5d0 \uc720\uc758\ud558\uc138\uc694. \ub610\ud55c \uc0ac\uc6a9\uc790 \ud53c\ub4dc\ubc31\uc5d0 \ub530\ub77c \uacf5\uac1c \uc778\ud130\ud398\uc774\uc2a4\ub294 \ud6c4\uc18d \ub9b4\ub9ac\uc2a4\uc5d0\uc11c \ubcc0\uacbd\ub420 \uc218 \uc788\uc73c\ubbc0\ub85c \uc544\uc9c1\uc740 \ud504\ub85c\ub355\uc158 \ud658\uacbd\uc5d0\uc11c \ud558\uc704 \ubb38\uc11c API\ub97c \uc0ac\uc6a9\ud558\uc9c0 \uc54a\ub294 \uac83\uc774 \uc88b\uc2b5\ub2c8\ub2e4. \uadf8\ub7ec\ub098 2.2.6\uc758 \ub098\uba38\uc9c0 \ubd80\ubd84\uc740 \ud14c\uc2a4\ud2b8\ub97c \ub9c8\ucce4\uc73c\uba70 \ud504\ub85c\ub355\uc158 \ud658\uacbd\uc5d0\uc11c \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/em><\/strong><\/p>\n

\uc804\uc81c \uc870\uac74: Couchbase Server 4.5.0 \uac1c\ubc1c\uc790 \ud504\ub9ac\ubdf0<\/h3>\n

\uc544\ub798 \uc608\uc2dc\ub97c \ub530\ub974\ub824\uba74 \ub2e4\uc74c\uc744 \ub2e4\uc6b4\ub85c\ub4dc\ud558\uc5ec \uc124\uce58\ud574\uc57c \ud569\ub2c8\ub2e4. Couchbase Server 4.5 \uac1c\ubc1c\uc790 \ubbf8\ub9ac \ubcf4\uae30<\/a>. \uc9c0\uae08 \ubc14\ub85c \ud574\ubcf4\uc138\uc694!<\/p>\n

\ud558\uc704 \ubb38\uc11c API DP \uac1c\uc694<\/h2>\n

\ub2e4\uc74c \uc608\uc81c\uc5d0\uc11c\ub294 ID\uac00 'puppy'\uc778 \ubb38\uc11c\ub97c \uc0ac\uc6a9\ud558\uba70 \ub2e4\uc74c\uacfc \uac19\uc774 \ud45c\uc2dc\ub429\ub2c8\ub2e4:<\/p>\n

  {\r\n  \"type\": \"\uac1c\",\r\n  \"\ud488\uc885\": \"\ud54f\ubd88\/\uce58\uc640\uc640\",\r\n  \"name\": \"\uac15\uc544\uc9c0\",\r\n  \"toys\": [\r\n    \"squeaker\",\r\n    \"\uacf5\",\r\n    \"shoe\"\r\n  ],\r\n  \"owner\": {\r\n    \"type\": \"\uc11c\ubc88\ud2b8\",\r\n    \"name\": \"\ub3c8 \ub178\ud2b8\",\r\n    \"age\": 63\r\n  },\r\n  \"attributes\": {\r\n    \"fleas\": true,\r\n    \"color\": \"white\",\r\n    \"eyeColor\": \"\uac08\uc0c9\",\r\n    \"age\": 5,\r\n    \"dirty\": true,\r\n    \"sex\": \"female\"\r\n  }\r\n}\r\n<\/code><\/pre>\n
\ubaa8\ub4e0 \uc608\uc81c\ub294 \ub2e4\uc74c\uc5d0\uc11c \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. Github <\/a>\ub97c \uc0ac\uc6a9\ud558\uc5ec \ud504\ub85c\uc81d\ud2b8\ub97c \ubcf5\uc81c\ud558\uace0 API\ub97c \uc0ac\uc6a9\ud574 \ubcfc \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n
MutateInBuilder \ubc0f \ub8e9\uc5c5\uc778\ube4c\ub354<\/h3>\n
\uc55e\uc11c \uc5b8\uae09\ud588\ub4ef\uc774 \ud558\uc704 \ubb38\uc11c API\ub294 \ubb38\uc11c\uc5d0\uc11c \uc5ec\ub7ec \uc791\uc5c5\uc744 \uc5f0\uacb0\ud558\uae30 \uc704\ud574 \uc720\ucc3d\ud55c \uc778\ud130\ud398\uc774\uc2a4\ub97c \ud1b5\ud574 \ube4c\ub354 \ud328\ud134\uc744 \ud65c\uc6a9\ud558\ub294 \ub450 \uac00\uc9c0 \uc0c8\ub85c\uc6b4 \uc720\ud615\uc744 \uc81c\uacf5\ud569\ub2c8\ub2e4. \ub450 \uac1c\uccb4 \ubaa8\ub450 MutateIn<\/code> \ub610\ub294 \ub8e9\uc5c5\uc778<\/code> \uc5d0 \uce74\uc6b0\uce58\ubca0\uc774\uc2a4\ubc84\ud0b7<\/code> \uac1d\uccb4\ub97c \uc0dd\uc131\ud558\uace0 \uc791\uc5c5 \uc911\uc778 \ubb38\uc11c\uc758 \ud0a4 \ub610\ub294 ID\ub97c \uc804\ub2ec\ud569\ub2c8\ub2e4:<\/p>\n
\/\/\uae30\ubcf8 \uc124\uc815\uc73c\ub85c \ud074\ub7ec\uc2a4\ud130 \ub3c4\uc6b0\ubbf8\ub97c \ucd08\uae30\ud654\ud569\ub2c8\ub2e4(\uc608: localhost).\r\nClusterHelper.Initialize();\r\nvar bucket = ClusterHelper.GetBucket(\"default\");\r\n\r\n\/\/ \"thekey\" \ubb38\uc11c\uc5d0 \ub300\ud55c \ub3cc\uc5f0\ubcc0\uc774 \ube4c\ub354\ub97c \uc0dd\uc131\ud569\ub2c8\ub2e4.\r\nvar mutate = bucket.MutateIn(\"thekey\");\r\n\r\n\/\/\"thekey2\" \ubb38\uc11c\uc5d0 \ub300\ud55c \uc870\ud68c \ube4c\ub354\ub97c \uc0dd\uc131\ud569\ub2c8\ub2e4.\r\nvar lookup = bucket.LookupIn(\"thekey2\");\r\n\r\nClusterHelper.Close();\r\n<\/code><\/pre>\n
\ube4c\ub354 \uac1d\uccb4\uac00 \uc788\uc73c\uba74 \uc608\ub97c \ub4e4\uc5b4 \ubb38\uc11c\uc5d0 \ub300\ud574 \uc2e4\ud589\ud560 \uc5ec\ub7ec \uc791\uc5c5\uc744 \uccb4\uc778\uc73c\ub85c \uc5f0\uacb0\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4:<\/p>\n
var builder = bucket.LookupIn(id).\r\n            Get(\"type\").\r\n            Get(\"name\").\r\n            Get(\"owner\").\r\n            Exists(\"notfound\");\r\n<\/code><\/pre>\n
\uadf8\ub7f0 \ub2e4\uc74c \ubaa8\ub4e0 \uc791\uc5c5\uc744 \ud55c \ubc88\uc5d0 \uc11c\ubc84\ub85c \uc804\uc1a1\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4:<\/p>\n
var fragment = builder.Execute();\r\n<\/code><\/pre>\n
\uadf8\ub7f0 \ub2e4\uc74c \uacbd\ub85c\uc5d0 \ub300\ud55c \ud55c \uac00\uc9c0 \uc791\uc5c5\uc758 \uacb0\uacfc\ub97c \ud655\uc778\ud569\ub2c8\ub2e4. \uc720\ud615<\/code>:<\/p>\n
if (fragment.OpStatus(\"type\") == ResponseStatus.Success)\r\n{\r\n    \ubb38\uc790\uc5f4 \ud615\uc2dd = \"Path='{0}' Value='{1}'\";\r\n    Console.WriteLine(format, \"type\", fragment.Content(\"type\"));\r\n}\r\n<\/code><\/pre>\n
IDocumentFragment<\/p>\n\n\n\n\n\n\n\n\n\n\n
\uc774\ub984<\/th>\n\uc124\uba85<\/th>\n<\/tr>\n<\/thead>\n
\ucf58\ud150\uce20(...)<\/td>\n\uc9c0\uc815\ub41c \uacbd\ub85c \ub610\ub294 \uc778\ub371\uc2a4\uc758 \ucf58\ud150\uce20\ub97c \uac00\uc838\uc635\ub2c8\ub2e4.<\/td>\n<\/tr>\n
\uc874\uc7ac(...)<\/td>\n\uc9c0\uc815\ub41c \uacbd\ub85c \ub610\ub294 \uc778\ub371\uc2a4\uc5d0 \ub300\ud55c \uacb0\uacfc\uac00 \uc788\ub294 \uacbd\uc6b0 true\ub97c \ubc18\ud658\ud569\ub2c8\ub2e4.<\/td>\n<\/tr>\n
Count()<\/td>\n\ube4c\ub354\uac00 \uc720\uc9c0 \uad00\ub9ac\ud558\ub294 \ud604\uc7ac \uc791\uc5c5\uc758 \uac1c\uc218\uc785\ub2c8\ub2e4.<\/td>\n<\/tr>\n
OpStatus(...)<\/td>\n\uadf8\ub9ac\uace0 \uc751\ub2f5 \uc0c1\ud0dc<\/code> \uc778\ub371\uc2a4 \ub610\ub294 \uacbd\ub85c\uc5d0\uc11c \uc791\uc5c5\uc744 \uc218\ud589\ud569\ub2c8\ub2e4.<\/td>\n<\/tr>\n
\uc0c1\ud0dc<\/td>\n\uadf8\ub9ac\uace0 \uc751\ub2f5 \uc0c1\ud0dc<\/code> \ub97c \uc0ac\uc6a9\ud558\uc5ec \uc804\uccb4 \ub2e4\uc911 \uc791\uc5c5\uc744 \uc218\ud589\ud569\ub2c8\ub2e4.<\/td>\n<\/tr>\n
\uc131\uacf5<\/td>\n\uc804\uccb4 \ub2e4\uc911 \uc791\uc5c5\uc774 \uc131\uacf5\ud558\uba74 \ucc38\uc785\ub2c8\ub2e4.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\uc774\ub7ec\ud55c \ud504\ub85c\ud37c\ud2f0 \ub610\ub294 \uba54\uc11c\ub4dc \uc678\uc5d0\ub3c4 \ub2e4\uc74c\uc5d0\uc11c \uc0c1\uc18d\ub41c \ub2e4\ub978 \ubaa8\ub4e0 \ud504\ub85c\ud37c\ud2f0\uac00 \uc788\uc2b5\ub2c8\ub2e4. \uc791\uc5c5 \uacb0\uacfc<\/code> \ub294 K\/V \uc791\uc5c5\uc758 \ud45c\uc900 \uc751\ub2f5\uc785\ub2c8\ub2e4: \uc5c5\uc11c\ud2b8, \uc81c\uac70, \uad50\uccb4 \ub4f1\uc785\ub2c8\ub2e4.<\/p>\n
\uc624\ub958 \ucc98\ub9ac<\/h3>\n
\uc5ec\ub7ec \uac1c\uc758 \uc870\ud68c\ub97c \uc804\uc1a1\ud560 \ub54c \uadf8 \uc911 \ud558\ub098\uac00 \uc2e4\ud328\ud558\uba74 \uc804\uccb4 \ub2e4\uc911 \uc791\uc5c5 \uc694\uccad\uc774 \uc2e4\ud328\ud558\ubbc0\ub85c \ub2e8\uc77c \ubb38\uc11c \ub0b4\uc5d0\uc11c \uc870\ud68c\ub97c \uc218\ud589\ud560 \ub54c \ud2b8\ub79c\uc7ad\uc158\uc758 \uc804\ubd80 \uc544\ub2c8\uba74 \uc804\ubb34\uc758 \uc758\ubbf8\uac00 \ud5c8\uc6a9\ub429\ub2c8\ub2e4. \uc5ec\ub7ec \uc870\ud68c\ub97c \uc804\uc1a1\ud560 \ub54c \uc11c\ubc84\ub294 \uc694\uccad\ub41c \ub9cc\ud07c\uc758 \ud56d\ubaa9\uc744 \ubc18\ud658\ud558\ub824\uace0 \uc2dc\ub3c4\ud558\uba74\uc11c \uc77c\ubd80 \uc791\uc5c5\uc774 \uc131\uacf5\ud558\uace0 \uc77c\ubd80 \uc791\uc5c5\uc774 \uc2e4\ud328\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uc791\uc5c5\uc774 \uc2e4\ud328\ud558\uba74 Status \uc18d\uc131\uc5d0\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \ucd5c\uc0c1\uc704 \uc624\ub958 \uc751\ub2f5\uc774 \ud3ec\ud568\ub429\ub2c8\ub2e4. \ud558\uc704 \ubb38\uc11c \ub2e4\uc911 \uacbd\ub85c \uc2e4\ud328,<\/code>\u00a0\ub294 \ud2b9\uc815 \uc624\ub958\ub97c \uc5bb\uae30 \uc704\ud574 \uc791\uc5c5 \uacb0\uacfc\ub97c \ub354 \uc790\uc138\ud788 \uc870\uc0ac\ud558\ub77c\ub294 \ud45c\uc2dc\uc785\ub2c8\ub2e4. OpStatus \uba54\uc11c\ub4dc\ub97c \ud638\ucd9c\ud558\uace0 \uc778\ub371\uc2a4 \ub610\ub294 \uacbd\ub85c\ub97c \uc804\ub2ec\ud558\uc5ec \ubc18\ubcf5\ud558\uba74 \uc774 \uc791\uc5c5\uc744 \uc218\ud589\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4:<\/p>\n
var builder = bucket.LookupIn(id).\r\n            Get(\"type\").\r\n            Get(\"\uc77c\ubd80 \uacbd\ub85c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc74c\").\r\n            Get(\"owner\");\r\n\r\nvar fragment = builder.Execute();\r\nConsole.WriteLine(\"\uc77c\ubc18 \uc624\ub958: {0}{1}\ud2b9\uc815 \uc624\ub958: {2}\",\r\n    fragment.Status, Environment.NewLine, fragment.OpStatus(1));\r\n\r\nConsole.WriteLine(\"\uc77c\ubc18 \uc624\ub958: {0}{1}\ud2b9\uc815 \uc624\ub958: {2}\",\r\n    fragment.Status, Environment.NewLine, fragment.OpStatus(\"\uc77c\ubd80 \uacbd\ub85c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc74c\"));\r\n<\/code><\/pre>\n
\uc774 \uacbd\uc6b0 \ubb38\uc11c \ub0b4\uc5d0 \uacbd\ub85c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc73c\ubbc0\ub85c \ubc18\ud658\ub41c \ud2b9\uc815 \uc624\ub958\ub294 \ub2e4\uc74c\uacfc \uac19\uc2b5\ub2c8\ub2e4. \ud558\uc704 \ubb38\uc11c \uacbd\ub85c\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc74c<\/code>. \ube4c\ub354 \uc720\ud615\uacfc \uc624\ub958 \uc870\uac74\uc5d0 \ub530\ub77c \ub2e4\uc591\ud55c \uc624\ub958 \uc870\ud569\uc774 \uc788\uc73c\uba70, \uc774\ub294 \uac04\ub7b5\ud558\uac8c \uc18c\uac1c\ud55c \uac83\uc73c\ub85c API\ub97c \uc2dc\uc791\ud558\ub294 \ub370 \uc801\ud569\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n
\ub8e9\uc5c5\uc778\ube4c\ub354 \uc608\uc81c<\/h2>\n
\ub8e9\uc5c5\uc778\ube4c\ub354\ub294 \uacbd\ub85c\ubcc4 \uac12 \uac00\uc838\uc624\uae30\uc640 \uc9c0\uc815\ub41c \uacbd\ub85c\uc5d0\uc11c \uac12\uc758 \uc874\uc7ac \uc5ec\ubd80 \ud655\uc778\uc774\ub77c\ub294 \ub450 \uac00\uc9c0 \uc791\uc5c5\uc744 \uc9c0\uc6d0\ud569\ub2c8\ub2e4.<\/p>\n
Get:<\/h3>\n
\uc870\ud68c\ud574 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4. \uc18c\uc720\uc790<\/code> \uc870\uac01 \uae30\uc900 \uacbd\ub85c<\/code>:<\/p>\n
var builder = bucket.LookupIn(id).\r\n            Get(\"owner\").\r\n            Execute();\r\n\r\nvar owner = builder.Content(\"owner\");\r\n<\/code><\/pre>\n
\ucd9c\ub825\uc740 \ub2e4\uc74c\uacfc \uac19\uc2b5\ub2c8\ub2e4:<\/p>\n
{\r\n    \"type\": \"\uc11c\ubc88\ud2b8\",\r\n    \"name\": \"\ub3c8 \ub178\ud2b8\",\r\n    \"age\": 63\r\n}\r\n<\/code><\/pre>\n
\uc874\uc7ac\ud569\ub2c8\ub2e4:<\/h3>\n
\ub2e4\uc74c \uc0ac\ud56d\uc744 \ud655\uc778\ud574 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4. \uc18c\uc720\uc790<\/code> \uacbd\ub85c\uac00 \uc874\uc7ac\ud569\ub2c8\ub2e4:<\/p>\n
var builder = bucket.LookupIn(id).\r\n            Exists(\"owner\").\r\n            Execute();\r\n\r\nvar found = builder.Content(\"owner\");\r\n<\/code><\/pre>\n
\ucd9c\ub825\uc740 \ub2e4\uc74c\uacfc \uac19\uc2b5\ub2c8\ub2e4. true<\/code>\uacbd\ub85c \uc18c\uc720\uc790<\/code> \uac00 \ubb38\uc11c \ub0b4\uc5d0 \uc2e4\uc81c\ub85c \uc874\uc7ac\ud569\ub2c8\ub2e4.<\/p>\n
\ubba4\ud14c\uc774\ud2b8\uc778\ube4c\ub354<\/h2>\n
MutateInBuilder\ub294 \uc2a4\uce7c\ub77c \uac12, \ub515\uc154\ub108\ub9ac \ubc0f \ubc30\uc5f4\uc758 \ubcc0\ud615\uc744 \uc9c0\uc6d0\ud558\ub294 \ub2e4\uc591\ud55c \uba54\uc11c\ub4dc\uc640 \uc6d0\uc790 \uce74\uc6b4\ud130 \uc5f0\uc0b0\uc744 \uc9c0\uc6d0\ud569\ub2c8\ub2e4.<\/p>\n
\uc0bd\uc785\ud569\ub2c8\ub2e4:<\/h3>\n
\uc0bd\uc785\uc740 \ud3ec\ud568 \uc694\uc18c(\uc0ac\uc804 \uc790\uccb4)\ub97c \ucd94\uac00\ud560 \uc218 \uc788\ub3c4\ub85d \uc120\ud0dd\uc801\uc73c\ub85c \ub515\uc154\ub108\ub9ac\uc5d0 \uac12\uc744 \ucd94\uac00\ud569\ub2c8\ub2e4:<\/p>\n
var builder = bucket.MutateIn(id).\r\n            \uc0bd\uc785(\"attributes.hairLength\", \"short\").\r\n            Execute();\r\n<\/code><\/pre>\n
\uc774\uc81c \ubb38\uc11c\uc758 \uc18d\uc131 \uc0ac\uc804\uc740 \ub2e4\uc74c\uacfc \uac19\uc774 \ud45c\uc2dc\ub429\ub2c8\ub2e4:<\/p>\n
...\r\n\"\uc18d\uc131\":\r\n{\r\n    \"fleas\": true,\r\n    \"color\": \"white\",\r\n    \"eyeColor\": \"\uac08\uc0c9\",\r\n    \"age\": 5,\r\n    \"dirty\": true,\r\n    \"sex\": \"\uc5ec\uc131\",\r\n    \"hairLength\": \"short\"\r\n}\r\n...\r\n<\/code><\/pre>\n
\uc774\uc81c \ubd80\ubaa8 \uc694\uc18c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc73c\uba74 createParents<\/code> \ub9e4\uac1c\ubcc0\uc218\ub97c \uc0ac\uc6a9\ud558\uc5ec \ubd80\ubaa8 \uc694\uc18c\ub97c \ub9cc\ub4e4 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ubd80\ubaa8 \uc694\uc18c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\ub294 \uacbd\uc6b0 \uc2e4\ud328\ud558\ub824\uba74 false\ub97c \uc804\ub2ec\ud558\uace0, \ubd80\ubaa8 \uc694\uc18c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\ub294 \uacbd\uc6b0 \uc2e4\ud328\ud558\ub824\uba74 true\ub97c \uc804\ub2ec\ud558\uba74 \ub429\ub2c8\ub2e4:<\/p>\n
var builder = bucket.MutateIn(id).\r\n            \uc0bd\uc785(\"anewattribute.withakey\", \"somevalue\").\r\n            Execute();\r\n<\/code><\/pre>\n
\uadf8\ub7ec\uba74 \ub2e4\uc74c\uacfc \uac19\uc740 \uc0c8 \uc18d\uc131\uc774 \uc0dd\uc131\ub429\ub2c8\ub2e4. \uc0c8\ub85c\uc6b4 \uc18d\uc131<\/code> \ub77c\ub294 \ub2e8\uc77c \ud0a4\ub97c \ubb38\uc11c\uc5d0 \ucd94\uac00\ud558\uace0 withakey<\/code> \uac12\uc73c\ub85c \uc77c\ubd80\uac12<\/code>.<\/p>\n
...\r\n\"anewattribute\":\r\n{\r\n    \"withakey\": \"\uc77c\ubd80\uac12\"\r\n}\r\n...\r\n<\/code><\/pre>\n
\uc774\uc81c false<\/code> \uc5d0 \ub300\ud55c createParents<\/code> \ub85c \uc124\uc815\ub418\uc5b4 \uc788\uace0 \ubd80\ubaa8 \uc18d\uc131\uc774 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc73c\uba74 \ub2e4\uc911 \ubcc0\uc774\uac00 \uc2e4\ud328\ud558\uace0 \ucd5c\uc0c1\uc704 \uc751\ub2f5 \uc0c1\ud0dc\ub294 \ud558\uc704 \ubb38\uc11c \ub2e4\uc911 \uacbd\ub85c \uc2e4\ud328<\/code> \uad6c\uccb4\uc801\uc778 \uc624\ub958\ub294 \ub2e4\uc74c\uacfc \uac19\uc2b5\ub2c8\ub2e4. \ud558\uc704 \ubb38\uc11c \uacbd\ub85c\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc74c<\/code>.<\/p>\n
Upsert<\/h3>\n
\uc5c5\uc11c\ud2b8\ub294 \uae30\uc874 \uc0ac\uc804 \ud56d\ubaa9\uc744 \ucd94\uac00\ud558\uac70\ub098 \ubc14\uafc9\ub2c8\ub2e4. \uc0ac\uc6a9\ubc95\uc740 \uc0bd\uc785<\/code> \uba54\uc11c\ub4dc \uc774\ub984\uc774 Upsert<\/code>.<\/p>\n
\uc81c\uac70<\/h3>\n
\uc81c\uac70<\/code> \ub294 \uc9c0\uc815\ub41c \uacbd\ub85c\uc5d0\uc11c \uc694\uc18c\ub97c \uc81c\uac70\ud569\ub2c8\ub2e4. \uc608\ub97c \ub4e4\uc5b4 \uc704 \ubb38\uc11c\uc5d0\uc11c \uc18c\uc720\uc790\uc758 \uc774\ub984\uc744 \uc81c\uac70\ud558\uaca0\uc2b5\ub2c8\ub2e4:<\/p>\n
 var fragment = bucket.MutateIn(id).\r\n            Remove(\"owner.name\").\r\n            Execute();\r\n<\/code><\/pre>\n
\uadf8\ub9ac\uace0 \ud638\ucd9c \ud6c4 \ubb38\uc11c \uc81c\uac70<\/code>:<\/p>\n
...\r\n\"\uc18c\uc720\uc790\":\r\n{\r\n    \"type\": \"servant\",\r\n    \"age\": 63\r\n},\r\n...\r\n<\/code><\/pre>\n
\uad50\uccb4<\/h3>\n
\ubc14\uafb8\uae30\ub294 \uc9c0\uc815\ub41c \uacbd\ub85c\uc5d0\uc11c \uc694\uc18c\uc758 \uac12\uc744 \ubc14\uafb8\uba70, \uacbd\ub85c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc73c\uba74 \uc2e4\ud328\ud569\ub2c8\ub2e4:<\/p>\n
var fragment = bucket.MutateIn(id).\r\n            Replace(\"owner\", new { CatLover=true, CatName=\"celia\"}).\r\n            Execute();\r\n<\/code><\/pre>\n
\uc774\uc81c \ubb38\uc11c\uc758 '\uc18c\uc720\uc790' \uac12\uc774 \ub2ec\ub77c\uc9d1\ub2c8\ub2e4:<\/p>\n
...\r\n\"\uc18c\uc720\uc790\":\r\n{\r\n    \"catLover\": true,\r\n    \"catName\": \"celia\"\r\n},\r\n...\r\n<\/code><\/pre>\n
\ud478\uc2dc\ubc31<\/h3>\n
\ubc30\uc5f4\uc758 \ub4b7\ubd80\ubd84\uc5d0 \uac12\uc744 \ucd94\uac00\ud558\uace0, \ubd80\ubaa8 \uc694\uc18c(\ubc30\uc5f4 \uc694\uc18c \uc790\uccb4)\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\ub294 \uacbd\uc6b0 \uc120\ud0dd\uc801\uc73c\ub85c \ucd94\uac00\ud569\ub2c8\ub2e4.<\/p>\n
var fragment = bucket.MutateIn(id).\r\n            PushBack(\uacbd\ub85c, \uac12, \uac70\uc9d3).\r\n            Execute();\r\n<\/code><\/pre>\n
\uadf8\ub9ac\uace0 \uc7a5\ub09c\uac10<\/code> \ubc30\uc5f4\uc740 \uc774\uc81c \ub9c8\uc9c0\ub9c9 \uc11c\uc218\uc5d0 \"slipper\" \uac12\uc744 \uac16\uc2b5\ub2c8\ub2e4:<\/p>\n
...\r\n\"\uc7a5\ub09c\uac10\":\r\n[\r\n    \"\uc2a4\ud034\ucee4\",\r\n    \"\uacf5\",\r\n    \"\uc2e0\ubc1c\",\r\n    \"\uc2ac\ub9ac\ud37c\"\r\n],\r\n...\r\n<\/code><\/pre>\n
\ud478\uc2dc\ud504\ub860\ud2b8<\/h3>\n
\ubc30\uc5f4 \uc55e\uc5d0 \uac12\uc744 \ucd94\uac00\ud558\uace0 \ubd80\ubaa8 \uc694\uc18c(\ubc30\uc5f4 \uc790\uccb4)\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\ub294 \uacbd\uc6b0 \uc120\ud0dd\uc801\uc73c\ub85c \ucd94\uac00\ud569\ub2c8\ub2e4:<\/p>\n
var fragment = bucket.MutateIn(id).\r\n            PushFront(\uacbd\ub85c, \uac12, \uac70\uc9d3).\r\n            Execute();\r\n<\/code><\/pre>\n
\uadf8\ub9ac\uace0 \uc7a5\ub09c\uac10<\/code> \ubc30\uc5f4\uc740 \uc774\uc81c \uccab \ubc88\uc9f8 \uc11c\uc218\uc5d0 \"slipper\" \uac12\uc744 \uac16\uc2b5\ub2c8\ub2e4:<\/p>\n
...\r\n\"\uc7a5\ub09c\uac10\":\r\n[\r\n    \"\uc2ac\ub9ac\ud37c\",\r\n    \"\ub07d\ub07d\uc774\",\r\n    \"ball\",\r\n    \"shoe\"\r\n],\r\n...\r\n<\/code><\/pre>\n
ArrayInsert<\/h3>\n
\uc8fc\uc5b4\uc9c4 \uc778\ub371\uc2a4\uc758 \ubc30\uc5f4\uc5d0 \uac12\uc744 \uc0bd\uc785\ud569\ub2c8\ub2e4:<\/p>\n
 var fragment = bucket.MutateIn(id).\r\n            ArrayInsert(\"toys[2]\", \"slipper\").\r\n            Execute();\r\n<\/code><\/pre>\n
\uadf8\ub9ac\uace0 \uc7a5\ub09c\uac10<\/code> \ubc30\uc5f4\uc740 \uc774\uc81c \uc138 \ubc88\uc9f8 \uc11c\uc218(\uc778\ub371\uc2a4 2)\uc5d0 \"slipper\" \uac12\uc744 \uac16\uc2b5\ub2c8\ub2e4:<\/p>\n
\"\uc7a5\ub09c\uac10\":\r\n[\r\n    \"squeaker\",\r\n    \"\uacf5\",\r\n    \"\uc2ac\ub9ac\ud37c\",\r\n    \"shoe\"\r\n ],\r\n<\/code><\/pre>\n
\ucd94\uac00 \uace0\uc720<\/h3>\n
\ubc30\uc5f4\uc5d0 \uac12\uc744 \uc0bd\uc785\ud558\uba70, \uac12\uc774 \uc874\uc7ac\ud558\uba74 \uc2e4\ud328\ud569\ub2c8\ub2e4(\uac12\uc740 \ubc30\uc5f4 \ub0b4\uc5d0\uc11c \uace0\uc720\ud574\uc57c \ud569\ub2c8\ub2e4):<\/p>\n
 var fragment = bucket.MutateIn(id).\r\n            AddUnique(\"toys\", \"shoe\").\r\n            Execute();\r\n<\/code><\/pre>\n
\"shoe\" \uac12\uc740 \uc6d0\ubcf8 \ubb38\uc11c\uc758 \uc7a5\ub09c\uac10<\/code> \ubc30\uc5f4\uc744 \uc0ac\uc6a9\ud558\uba74 \ub2e4\uc74c\uacfc \uac19\uc740 \uc0c1\ud0dc\ub85c \uc2e4\ud328\ud569\ub2c8\ub2e4:<\/p>\n
\ud558\uc704 \ubb38\uc11c \uacbd\ub85c \uc874\uc7ac\r\n<\/code><\/pre>\n
\uc774 \uba54\uc11c\ub4dc\uc5d0\uc11c\ub294 \ubb38\uc790\uc5f4, \uc22b\uc790, \ucc38, \uac70\uc9d3 \ub610\ub294 null\uc758 \ud2b9\uc218 \uac12\uacfc \uac19\uc740 JSON \uae30\ubcf8 \uc694\uc18c\ub9cc \uc0bd\uc785\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uadf8 \uc774\uc720\ub294 \uac01 JSON \uac1d\uccb4\ub85c \ub0b4\ub824\uac00\uc11c \ud56d\ubaa9\ubcc4\ub85c \uc694\uc18c\ub97c \ube44\uad50\ud558\uc9c0 \uc54a\uace0\ub294 \uace0\uc720\uc131\uc744 \ube44\uad50\ud560 \uc218 \uc788\ub294 \ubc29\ubc95\uc774 \uc5c6\uae30 \ub54c\ubb38\uc785\ub2c8\ub2e4.<\/p>\n
\uce74\uc6b4\ud130<\/h3>\n
\uae30\uc874 \uac12\uc5d0 \uc9c0\uc815\ub41c \ub378\ud0c0\ub97c \ucd94\uac00\ud558\uc5ec \uc694\uc18c\uac00 \uc5c6\ub294 \uacbd\uc6b0 \uc694\uc18c\ub97c \uc0dd\uc131\ud558\uace0 \uac12\uacfc \ub378\ud0c0\ub97c 0\uc73c\ub85c \uae30\ubcf8 \uc124\uc815\ud569\ub2c8\ub2e4. \ub378\ud0c0\uac00 \uc74c\uc218\uc774\uba74 \uc694\uc18c\uc758 \uac12\uc740 \uc9c0\uc815\ub41c \ub378\ud0c0\ub9cc\ud07c \uac10\uc18c\ud569\ub2c8\ub2e4.<\/p>\n
var fragment = bucket.MutateIn(id).\r\n            Counter(\"likes\", 1).\r\n            Execute();\r\n<\/code><\/pre>\n
\uc694\uc18c\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc73c\ubbc0\ub85c \uc0dd\uc131\ub41c \ub2e4\uc74c \ud558\ub098(1)\ub85c \uc124\uc815\ub429\ub2c8\ub2e4. \uc774\uc81c \ubb38\uc11c\uac00 \ub2e4\uc74c\uacfc \uac19\uc774 \ud45c\uc2dc\ub429\ub2c8\ub2e4:<\/p>\n
...\r\n    ],\r\n    \"\uc88b\uc544\uc694\": 1\r\n}\r\n<\/code><\/pre>\n
\uc74c\uc218(-1)\ub97c \uc804\ub2ec\ud558\uba74 \ub2e4\uc74c \uce74\uc6b4\ud130\ub294 \uc88b\uc544\uc694<\/code> \uc740 \ub2e4\uc2dc 0(0)\uc73c\ub85c \uac10\uc18c\ud569\ub2c8\ub2e4:<\/p>\n
var fragment = bucket.MutateIn(id).\r\n            Counter(\"likes\", -1).\r\n            Execute();\r\n<\/code><\/pre>\n
\uc774\uc81c JSON \ubb38\uc11c\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \ud45c\uc2dc\ub429\ub2c8\ub2e4:<\/p>\n
...\r\n    ],\r\n    \"\uc88b\uc544\uc694\": 0\r\n}\r\n<\/code><\/pre>\n
v2.2.6 \ub9b4\ub9ac\uc2a4 \ub178\ud2b8<\/h2>\n
\ubc84\uadf8<\/h3>\n