Mongo DB #5_ update() 메소드, 제한자에 대해서

안녕하세요. 문범우입니다.

이번 포스트에서는 몽고db에서 사용되는 update() 메소드와 제한자에 대해서 알아보도록 하겠습니다.

---

먼저 오늘 알아볼 내용에 앞서, 필요한 mock-up 데이터는 아래와 같습니다.

위의 데이터를 만드는 쿼리문은 아래와 같습니다.

db.gameUser.insert([
{"_id":"u0001","name":"홍길동","job":"마법사","level":15,"item":["i001","i002"]},
{"_id":"u0002","name":"장사꾼","job":"성직자","level":77,"item":["i001","i002","i003","i004","i101","i201","i110","i998"]},
{"_id":"u0005","name":"초보자","job":"마법사","level":3,"item":["i002"]},
{"_id":"u0091","name":"사냥꾼","job":"전사","level":89,"item":["i999","i501","i005"]},
{"_id":"u0103","name":"천사","job":"도적","level":92,"item":["i777"]}])

db.gameItem.insert([{
    "_id":"i001",
    "name":"마법사 지팡이",
    "price":2000,
    "power":["힘,1","지력,3"]
},{
    "_id":"i002",
    "name":"초보자 갑옷",
    "price":500,
    "power":["방어,1","민첩,1"]
},{    "_id":"i003",
    "name":"도적의 칼",
    "price":1000,
    "power":["민첩,3"]
},{    "_id":"i004",
    "name":"초보자의 분노",
    "price":50000,
    "power":["민첩,30","힘,30","지력,45","회피,30"]
},{    "_id":"i005",
    "name":"괴력의 반지",
    "price":1000000,
    "power":["힘,700","회피,350","민첩,50","지능,1"]
},{    "_id":"i101",
    "name":"숙련자의 신발",
    "price":25000,
    "power":["민첩,35","회피,35"]
},{    "_id":"i110",
    "name":"숙련자의 장갑",
    "price":28000,
    "power":["힘,40","방어,20","지력,20"]
},{    "_id":"i201",
    "name":"고급 지팡이",
    "price":95000,
    "power":["지력,100"]
},{    "_id":"501",
    "name":"단단한 갑옷",
    "price":100000,
    "power":["방어,150","힘,50"]
},{    "_id":"i998",
    "name":"금간 용의 목걸이",
    "price":5000000,
    "power":["민첩,500","힘,500","지력,500","방어,250","회피,1000"]
},{    "_id":"i999",
    "name":"용의 목걸이",
    "price":37000000,
    "power":["회피,3000","민첩,600","힘,3000","지력,1000","방어,500"]
},{    "_id":"i777",
    "name":"어둠의 단도",
    "price":980000000,
    "power":["민첩,50000","힘,50000","회피,1000000","지력,30000","방어,100000"]
}])

1. 업데이트(Update)

특정 다큐먼트(document)를 수정하는 업데이트에 대해서 알아보도록 하겠습니다.

userItem에 있는 어둠의 단도라는 항목의 price를 수정해보도록 할게요.

현재 어둠의 단도의 가격은 980,000,000입니다. 해당 가격을 1,000,000,000 으로 바꿔볼게요!

mongoDB의 공식문서를 살펴보면 update메소드는 다음과 같은 구조를 가지고 있습니다.

db.COLLECTION.update(

<query>,<update>,

{

upsert: <boolean>,

multi: <boolean>,

writeConcern: <document>,

collation: <document>

}

)

구조에 있는 각각의 인자에 대한 설명은 아래와 같습니다.

Parameter	Type	Description
query	document	업데이트를 할 항목을 선택합니다. find() 함수에서 사용되는 것과 동일합니다.
update	document	선택된 document에 적용할 수정사항을 입력합니다.
upsert	boolean	Optional. (기본값: false) 만약 해당 값을 true로 설정하면, query한 document가 없을 경우 새로운 document를 추가합니다.
multi	boolean	Optional. (기본값: false) 만약 해당 값을 true로 설정하면, query에 해당하는 다수의 document를 수정합니다.
writeConcern	document	Optional. document의 write concern을 표현합니다. 기본으로 사용할 때는 생략합니다. 자세한 설명을 위해서는 메뉴얼을 참고하세요.
collation	document	Optional. Collation을 통해 사용자는 대문자 및 악센트 부호와 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다. collation은 기본적으로 다음과 같은 사항을 가지고 있습니다. collation: { locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean> }

위의 공식문서를 확인하여 어둠의 단도라는 item의 가격을 수정합니다.

쿼리문은 다음과 같습니다.

db.gameItem.update({name:"어둠의 단도"},{$set:{price:1000000000}});

<query>는 {name:"어둠의 단도"}로 하였습니다.

{_id:"i777"}로 해도 동일합니다.

<update>는 {$set:{price:1000000000}}으로 함으로써 price를 수정하도록 하였습니다.

$set은 제한자라고 불리는 것인데 제한자에 대한 자세한 것은 아래에서 더 살펴보도록 할게요.

아래 사진과 같이 올바른 결과를 나타냅니다.

2. 배열 데이터 추가, 삭제하기

mock-up data를 살펴보면 gameUser의 item 항목에는 배열로써 각 아이템의 _id값을 가지고 있습니다.

그렇다면 특정 유저가 아이템을 얻게되면 어떻게 표현할까요?

그리고 아이템을 잃게되면 어떻게 표현할까요?

위를 표현하기위해 배열항목에 데이터를 추가하거나 삭제하는 방법을 알아보도록 하겠습니다.

2-1. 추가하기

먼저 배열에 데이터를 추가해보도록 하겠습니다. 이 또한, 위에서 사용된 update() 함수를 사용합니다.

초보자라는 user에게 "초보자의 분노" 아이템을 추가해볼게요.

위의 document 수정에서는 $set이라는 제한자가 사용되었는데, 이번에는 $push라는 제한자를 사용합니다.

쿼리를 확인하면 다음과 같습니다.

db.gameUser.update({name:"초보자"},{$push:{item:"i004"}});

아래와 같이 올바른 결과를 나타냅니다.

2-2. 삭제하기

삭제또한, update() 함수를 사용하지만 제한자가 바뀌게 됩니다.

추가를 할땐 $push를 사용하였는데, 삭제에서는 $pull 제한자가 사용됩니다.

이번에는 장사꾼 user가 초보자의 갑옷을 버린 상황입니다.

즉, 장사꾼 user가 가진 item중 초보자의 갑옷을 삭제하도록 하겠습니다.

쿼리문은 다음과 같습니다.

db.gameUser.update({name:"장사꾼"},{$pull:{item:"i002"}});

이 또한 아래와 같이 올바른 결과를 나타냅니다.

3. 제한자

지금까지 document를 수정하고, document의 배열 항목에 데이터를 추가, 삭제하는 것을 알아보았습니다.

그런데 중간중간 '제한자'라는 개념이 등장했죠. 조금 더 구체적으로 말하면 이는 '갱신 제한자'입니다.

이번에는 갱신 제한자에 대해서 더 구체적으로 알아보도록 하겠습니다.

MongoDB에서 갱신 제한자라는 것은, 문서의 부분 갱신을 할때 매우 효율적으로 수행할 수 있도록 하는 개념입니다. document를 변경하거나 추가 또는 삭제하고, 배열과 같은 항목에 대한 연산을 하는데 사용될 수 있습니다.

그렇다면 갱신 제한자의 종류와 그 사용법에 대해서 알아보도록 하겠습니다.

갱신 제한자	설명
$set	document에서 특정 키의 값을 수정합니다. 특정 키가 존재하지 않다면 새롭게 생성합니다. 특정 키의 데이터형도 수정할 수 있습니다.
$unset	document에서 특정 키와 값을 모두 제거합니다.
$nc	배열에 사용되는 제한자로써, 지정된 키가 존재하는지 확인할 수 있습니다.
$inc	이미 존재하는 키의 값을 수정하거나, 새로운 키를 생성합니다. $set과 비슷하지만 주로 값이 자주 변경되는 값을 수정하는데 사용됩니다. int, long, double 의 자료형에만 사용이 가능합니다.
$push	배열에 사용되는 제한자로써, 지정된 키가 존재할 때 해당 키(배열)의 끝에 요소를 추가하며 지정된 키가 존재 하지 않으면 새로운 배열을 추가합니다.
$pull	배열에 사용되는 제한자로써, 지정된 키에 대한 요소를 삭제합니다.
$addToSet	배열에 사용되는 제한자로써, 중복을 피해서 요소를 배열에 추가할 때 사용합니다. 즉, $nc와 $push를 함께 수행하는 기능과 같습니다.
$each	$addToSet과 함께 사용되는 제한자로써, 여러 개의 값을 중복되지 않게 배열에 추가합니다.
$pop	배열을 스택이나 큐처럼 활용할 수 있습니다.

---