전체 치트시트데이터베이스

mongodb

MongoDB 6.0+ / mongosh 1.6+

mongosh 빠른 참조: 연결, CRUD, 쿼리 연산자, aggregation 파이프라인, 인덱스, replica set, 사용자, dump/restore — 가장 흔한 셸 패턴과 실전 예시까지 정리했습니다.

명령어 30개

연결 & 메타

mongosh "<uri>"

표준 연결 URI 로 MongoDB 에 연결합니다.

--quiet; --eval 'cmd'; --file script.js; --apiVersion 1/2

mongosh "mongodb://app:[email protected]:27017/app_production?authSource=admin"

show dbs / use <db> / show collections

DB 목록; DB 전환; 현재 DB 의 컬렉션 목록.

show dbs | use app | show collections

db.serverStatus() / db.stats()

서버 정보: 연결, opcounters, 복제 상태; db stats: 크기와 컬렉션.

.pretty() 로 보기 좋게; .verbose(); .json; --eval 결과

db.serverStatus().connections && db.stats().dataSize

CRUD: Read

db.<coll>.find()

컬렉션을 쿼리; .pretty() .limit() .skip() .sort() 를 체인해 결과를 다룹니다.

.projection({name:1, email:1, _id:0}); .sort({createdAt:-1}); .limit(20); .skip(20); .count(); .allowDiskUse()

db.orders.find({status:'paid', amount:{$gte:10}}).sort({createdAt:-1}).limit(20).pretty()

db.<coll>.findOne({...}) / db.<coll>.countDocuments({...})

단일 문서를 읽거나, 필터에 매치되는 문서 개수를 셉니다.

findOne 필터 유무; estimatedDocumentCount 는 O(1)

db.users.findOne({email:'[email protected]'}, {pwd:0, _id:0}) && db.orders.countDocuments({status:'paid'})

CRUD: Create

db.<coll>.insertOne({...}) / insertMany([...])

문서 한 개/여러 개 삽입; 옵션: ordered:false 는 일부 실패해도 유효한 문서는 모두 기록합니다.

db.logs.insertMany([{k:'api', t:new Date()}, {k:'worker', t:new Date()}], {ordered:false})

CRUD: Update

db.<coll>.updateOne(filter, update, opts)

문서 하나를 업데이트. $set $inc $push $pull $addToSet $rename $unset 같은 연산자 사용.

upsert:true; arrayFilters:[] 중첩 배열용; returnDocument:'after' (findOneAndUpdate)

db.users.updateOne({email:'[email protected]'}, {$inc:{loginCount:1}, $set:{lastSeen:new Date()}}, {upsert:true})

db.<coll>.updateMany(filter, update) / findOneAndUpdate

여러 문서를 업데이트(쓰기는 bulk); findOneAndUpdate 는 업데이트 전/후 문서를 원자적으로 반환.

db.orders.updateMany({status:'pending', createdAt:{$lt:new Date(Date.now()-864e5)}}, {$set:{status:'cancelled'}})

CRUD: Replace

db.<coll>.replaceOne(filter, replacement)

_id 를 제외한 문서 전체를 교체(replacement 에 _id 허용 안 함).

db.users.replaceOne({email:'[email protected]'}, {name:'Alice', email:'[email protected]', role:'admin', tags:['vip']})

CRUD: Delete

db.<coll>.deleteOne / deleteMany(filter)

필터에 매치되는 문서를 제거. deleteMany({}) 는 모든 것을 삭제(주의해서 사용).

db.sessions.deleteMany({lastSeen:{$lt:new Date(Date.now()-7*864e5)}}) && db.orders.deleteOne({_id:ObjectId('...')})

쿼리 연산자

Comparison: $eq / $ne / $gt / $gte / $lt / $lte / $in / $nin

표준 비교 연산자; $in 은 값 목록과 매치됩니다.

db.orders.find({amount:{$gte:10,$lt:100}, status:{$in:['paid','shipped']}})

Logical: $and / $or / $not / $nor

조건 결합; $not 은 regex/메타데이터만, regex 는 명시적 regex 필요.

db.products.find({$or:[{sale:true,price:{$lt:50}},{tags:'vip'}]})

$exists / $type / $regex / $expr / $mod

필드 단위 조건: 존재, BSON 타입, regex 매치, 집계 비교($expr), $mod.

db.users.find({email:{$exists:true, $regex:'@example.com$', $options:'i'}})

db.<coll>.distinct(field, filter)

필드의 고유 값을 가져옵니다(필터 옵션).

db.orders.distinct('userId', {status:'paid'}).length

Aggregation

.aggregate([...])

스테이지 파이프라인 구성: $match → $group → $project → $sort → $limit → $lookup → $unwind → $facet.

.explain('executionStats'); allowDiskUse:true; collation 문서

db.orders.aggregate([ { $match:{status:'paid'} }, { $group:{_id:'$userId', gmv:{$sum:'$amount'}, n:{$sum:1}} }, { $sort:{gmv:-1} }, { $limit:50} ])

$lookup / $graphLookup

컬렉션 간 조인($lookup)과 재귀 트리 탐색($graphLookup).

db.orders.aggregate([{$lookup:{from:'users', localField:'userId', foreignField:'_id', as:'user'}}, {$unwind:'$user'}, {$project:{total:1, 'user.name':1}}])

$bucket / $bucketAuto / $sample / $sortByCount

유용한 집계 연산자: 버킷팅, 샘플링, top-N 카운팅.

db.events.aggregate([{$sample:{size:100}}, {$group:{_id:'$kind', n:{$sum:1}}}])

인덱스

db.<coll>.createIndex(spec, opts)

단일/복합/지오/텍스트/TTL 인덱스를 만듭니다.

{unique:true, partialFilterExpression, sparse, expireAfterSeconds, weights, name}

db.users.createIndex({email:1}, {unique:true}) && db.events.createIndex({ts:1}, {expireAfterSeconds:7*86400}) && db.shops.createIndex({loc:'2dsphere'})

db.<coll>.getIndexes() / dropIndex / dropIndexes

인덱스 목록; 한 개/전체 삭제(운영에서는 함부로 호출하지 말 것).

db.users.getIndexes().forEach(i=>print(i.name, JSON.stringify(i.key)))

db.<coll>.explain('executionStats').find(filter)

승리한 플랜과 실제 실행 통계 조회. COLLSCAN, IXSCAN, FETCH, sort stage 를 살펴보세요.

executionStats / queryPlanner / allPlansExecution; verbosity

db.orders.find({userId:42,createdAt:{$gte:new Date('2026-01-01')}}).sort({createdAt:-1}).explain('executionStats').queryPlanner.winningPlan

db.<coll>.hint({...})

플래너가 특정 인덱스를 사용하도록 강제 — 잘못된 플랜, 회귀 디버깅용.

db.users.find({email:'[email protected]'}).hint({email:1}).explain()

유지 보수

db.runCommand({...}) / db.adminCommand / db.command

MongoDB 명령을 직접 실행. 셸 헬퍼에 없는 연산을 위한 탈출구.

db.runCommand({listCollections:1, name:'app'}) && db.adminCommand({listDatabases:1}).databases.length

db.revokeRolesFromUser / grantRolesToUser

역할 관리(admin DB 에서 실행).

use admin; db.createUser({user:'audit',pwd:'...',roles:[{role:'readAnyDatabase',db:'admin'}]})

Replica Set

rs.initiate() / rs.status()

단일 노드 replica set 부트스트랩; 헬스 표시.

rs.initiate({_id:'rs0',members:[{_id:0,host:'m1:27017'}]}); rs.status().myState

rs.initiate({_id:'rs0',members:[{_id:0,host:'m1:27017'},{_id:1,host:'m2:27017'},{_id:2,host:'m3:27017'}]})

rs.add / rs.remove / rs.stepDown

멤버 추가/제거; 페일오버 테스트를 위한 선출 강제.

rs.add('m4:27017'); rs.remove('m3:27017'); rs.stepDown(60)

rs.add('m4.internal:27017') && rs.stepDown(60) && sh.status() on the next member

Sharded Cluster

sh.status() / sh.enableSharding

클러스터 토폴로지 조회 / 데이터베이스에 sharding 활성화.

use admin; sh.enableSharding('analytics'); sh.shardCollection('analytics.events', {userId:1, ts:1})

백업 & 마이그레이션

mongodump / mongorestore

논리 백업/복원. --uri, --db, --archive 로 스트리밍; --gzip 으로 압축.

--gzip; --archive=file.archive; --oplog point-in-time; --nsInclude/Exclude

mongodump --uri="mongodb://user:pw@m1:27017/?authSource=admin" --gzip --archive=/backup/app-2026-07-23.archive && mongorestore --gzip --archive=/backup/app.archive --nsInclude='app.*' --drop

mongoexport / mongoimport

JSON/CSV 로 export/import. Mongo 와 다른 시스템 사이에 파이프하는 엔진 역할.

--type=json|csv; --fields=a,b,c; --headerline; -q filter; --jsonArray (단일 최상위 배열)

mongoexport --uri="..." -d app -c orders --type=json -q '{"status":"paid"}' --out=orders.json && mongoimport --drop --jsonArray orders.json -d copy -c orders

mongotop / mongostat

실시간 모니터링: 지난 1초 동안 각 컬렉션이 읽기/쓰기에 사용한 시간과 통계.

간격(초); --host

mongostat --host=m1.internal --authdb=admin --username=ops -i 5

db.shutdownServer()

admin DB 에서 실행해 mongod 를 깔끔히 종료 — rm/poweroff 후 복구에도 유용.

use admin; db.shutdownServer({force:true}? No; clean shutdown waits for oplog replication)

use admin; db.shutdownServer()

상표 및 사용 안내

본 명령줄 도구 치트시트 모음은 오픈 커뮤니티 참고 자료입니다. 본 문서에서 언급되는 도구의 명칭, 로고, 상표(예: Git™, Docker™, Kubernetes®, kubectl, PostgreSQL®, MySQL®, Redis™, MongoDB®, Linux™, PowerShell™, Vim™ 등)는 각 권리자의 자산이며, 본 문서에서는 식별 및 참고 목적のみで 사용됩니다.

본 치트시트의 모든 내용은 독립적으로 작성된 단순화된 자체 완결형 참고 자료이며, 어떠한 공식 문서와도 계열·인정·출처 관계가 없습니다. 명령 목록, 플래그 설명, 예제는 모두 저자의 원본 단순화이며, 권위 있는 정보가 필요한 경우 각 도구의 공식 문서를 참조하시기 바랍니다.

명령 구문 및 옵션 플래그는 도구 버전에 따라 다를 수 있습니다. 표시되는 버전 태그는 안정 릴리스를 반영하며, 다른 버전에서는 동작이 다를 수 있습니다. 본 치트시트는 상표권자의 어떠한 선호나 권장도 의미하지 않습니다.

본 사이트는 사이트 정보의 이용으로 인해 발생하는 어떠한 직접적 또는 간접적 손해에 대해서도 법적 책임을 지지 않습니다.

MongoDB 소개

MongoDB는 Dwight Merriman, Eliot Horowitz, Kevin Ryan이 2007년에 만들고 2009년에 첫 릴리스한 오픈 소스 문서 데이터베이스입니다. 현재 안정 버전은 MongoDB 7.0+, 새 셸은 `mongosh` 2.x(레거시 `mongo`는 2022년에 더 이상 사용되지 않음)입니다. MongoDB는 레코드를 BSON 문서(확장 타입 `Decimal128`, `Date`, `ObjectId` 등을 가진 바이너리 JSON)로 저장하고 컬렉션에 묶지만 스키마를 강제하지 않습니다 — 스키마 설계는 애플리케이션의 몫이며, 일반적으로 드라이버 쪽에서 Mongoose나 Prisma가 보조합니다. 핵심 기능에는 보조 인덱스(단일 필드, 복합, 멀티키, 지리 공간, 텍스트, 와일드카드), `$match` / `$group` / `$lookup` / `$facet` 파이프라인의 aggregation 프레임워크, 4.0부터의 문서 간 트랜잭션, 반응형 워크로드용 change streams, 5.0부터의 시계열 컬렉션이 있습니다. 레플리카 셋은 고가용성을 제공하며(프라이머리에서 자동 페일오버), 샤디드 클러스터는 데이터를 여러 머신에 분산해 수평 확장을 합니다. 데이터가 자연스럽게 문서 모양(카탈로그, 콘텐츠 관리, 사용자 프로필, 이벤트 로그)이라면 MongoDB를, 다중 행 조인이나 애그리게이트에 걸친 엄격한 ACID가 필요하면 PostgreSQL을 선택하세요. 운영 환경에서는 반드시 인증을 활성화하고(`--auth`), 사설 네트워크에만 바인드하세요 — 기본 설치는 인증 없이 `0.0.0.0`에서 리슨합니다.

치트시트 버전 1.0.0