Copy & Run

MongoDB 시작하기: 컨테이너로 띄우고 첫 컬렉션에 문서 넣기

MongoDB 7 컨테이너를 127.0.0.1에만 열어 띄우고, mongosh로 데이터베이스와 컬렉션을 만든 뒤 문서를 넣고 찾고 고치고 인덱스를 겁니다. 모든 명령과 출력은 이 실습 컨테이너에서 실행한 결과입니다.

실습 노트 · 2026-11-14 발행 · 5분 · 2026-11 확인

MongoDB는 데이터를 표의 행 대신 JSON과 비슷한 문서(document)로 저장합니다. 문서가 모인 곳이 컬렉션(collection)이고, 컬렉션이 모인 곳이 데이터베이스입니다. 이 글에서는 컨테이너로 MongoDB 7을 띄우고, 상품 문서를 넣어 찾고 고치는 기본 순서를 실행합니다.

준비물

항목 내용
Docker Docker Desktop 29.5.3
이미지 mongo:7 (MongoDB 7.0.48)
셸 컨테이너 안의 mongosh
포트 127.0.0.1:27018에만 연결 (외부 노출 없음)
예상 소요 시간 약 20분

1. 컨테이너 띄우기

컨테이너 포트를 호스트의 루프백 주소에만 연결합니다. 기본 설치처럼 인증 없이 띄우는 실습이므로 이 주소 밖으로는 열지 않습니다.

docker run -d --name cr-mongo -p 127.0.0.1:27018:27017 mongo:7
docker exec cr-mongo mongod --version | head -1
db version v7.0.48

2. 기본 데이터베이스 확인

docker exec cr-mongo mongosh --quiet --eval 'db.version()'
docker exec cr-mongo mongosh --quiet --eval 'db.adminCommand({listDatabases:1}).databases.map(d=>d.name)'
7.0.48
[ 'admin', 'config', 'local' ]

MongoDB에는 처음에 시스템 데이터베이스 세 개만 있습니다. 데이터베이스는 첫 문서를 넣을 때 만들어지므로, 다음 단계에서 shopdb가 생깁니다.

3. 문서 넣기

shopdb의 products 컬렉션에 문서 한 개를 넣은 다음 여러 개를 한꺼번에 넣습니다.

docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.insertOne({name:"keyboard", price:39000, tags:["usb"], stock:12})'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.insertMany([{name:"mouse", price:19000, tags:["usb","wireless"], stock:0},{name:"monitor", price:189000, tags:["hdmi"], stock:4}])'
{ acknowledged: true, insertedId: ObjectId('6af81df3054c99755ba635de') }
{ acknowledged: true, insertedIds: { '0': ObjectId(...), '1': ObjectId(...) } }

_id 값은 넣을 때 자동으로 만들어집니다. tags처럼 문서마다 값의 개수가 다른 배열도 그대로 넣을 수 있습니다.

4. 찾기와 조건

docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.find({}, {_id:0, name:1, price:1, stock:1}).toArray()'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.find({stock:{$gt:0}, price:{$lt:100000}}, {_id:0,name:1}).toArray()'
[
  { name: 'keyboard', price: 39000, stock: 12 },
  { name: 'mouse', price: 19000, stock: 0 },
  { name: 'monitor', price: 189000, stock: 4 }
]
[ { name: 'keyboard' } ]

두 번째 명령은 재고가 0보다 크고 가격이 10만 원 미만인 상품을 찾습니다. 마우스는 재고가 0이라 빠지고, 모니터는 10만 원을 넘어 빠집니다. {_id:0, ...}는 결과에서 _id를 숨기는 옵션입니다.

5. 고치기와 세기

docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.updateOne({name:"mouse"},{$set:{stock:7}}).modifiedCount'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.countDocuments({stock:{$gt:0}})'
1
3

$set은 지정한 필드만 바꿉니다. 마우스 재고를 7로 고친 뒤 재고가 있는 상품은 3개가 됩니다.

6. 인덱스 만들기

이름으로 자주 찾는다면 인덱스를 만듭니다.

docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.createIndex({name:1})'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.getIndexes().map(i=>i.name)'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.getCollectionNames()'
name_1
[ '_id_', 'name_1' ]
[ 'products' ]

_id_는 MongoDB가 기본으로 만드는 인덱스이고, name_1이 방금 만든 인덱스입니다. 1은 오름차순을 뜻합니다.

7. 확인 체크리스트

  • 컨테이너를 127.0.0.1:27018에만 연결해 띄우고 MongoDB 7.0.48을 확인했습니다.
  • 첫 문서를 넣기 전에는 shopdb가 없고, 넣은 뒤 products 컬렉션이 생긴 것을 확인했습니다.
  • 조건 검색으로 재고 0인 마우스와 10만 원 이상인 모니터가 빠지는 것을 확인했습니다.
  • updateOne으로 마우스 재고를 고치고 countDocuments가 3을 돌려주는 것을 확인했습니다.
  • name 인덱스가 만들어진 것을 getIndexes로 확인했습니다.

이 글의 다음 단계

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글