KSCOLD LogoKSCOLD
Blog
Feed
Product
Admin Night
Vault
Guestbook
Info

Vault 목록

MongoDB 셸 쿼리 문법

연결된 노트와 함께 읽기

MongoDB 셸 쿼리 문법

2026년 8월 28일

MongoDB 셸 쿼리 문법

SQL이 문장이라면 MongoDB는 메서드 호출 + JSON 인자다. 문법의 전부가 이 한 줄에 있다.

JavaScript

조회

JavaScript

필터 JSON 안의 규칙 두 가지가 전부다.

JavaScript

조건 연산자

JavaScript

중첩·배열은 dot notation과 $elemMatch → MongoDB 배열 쿼리.

JavaScript

삽입

JavaScript

_id를 안 주면 드라이버가 ObjectId를 만든다 (MongoDB 문서 모델과 BSON).

갱신

JavaScript

$가 없으면 전체 교체로 해석된다. updateOne(filter, {name: "x"})는 에러이거나(최신) 문서를 통째로 날린다. 갱신 연산자 전체는 MongoDB 갱신 연산자.

삭제

JavaScript

집계

JavaScript

stage 목록은 MongoDB Aggregation Pipeline, 안에서 쓰는 표현식은 MongoDB 집계 연산자.

인덱스

JavaScript

SQL 감각으로 외우는 대응

하려는 것셸 문법
SELECT *find({})
WHEREfind({조건})
SELECT 열두 번째 인자 projection
ORDER BY.sort({필드: 1|-1})
LIMIT/OFFSET.limit(n).skip(m)
GROUP BYaggregate([{$group: ...}])
INSERTinsertOne/insertMany
UPDATE ... SETupdateOne(filter, {$set: ...})
DELETEdeleteOne/deleteMany
CREATE INDEXcreateIndex

전체 대조는 SQL ↔ MongoDB 문법 대조표.

한 줄 정리

db.컬렉션.메서드(필터, 옵션) 한 줄이 문법의 전부이고, 필터는 {필드: 값} 또는 {필드: {$연산자: 값}} 두 형태뿐이다.

관련

  • MongoDB 쿼리 연산자
  • MongoDB 갱신 연산자
  • MongoDB 배열 쿼리
  • MongoDB 집계 연산자
  • MongoDB CRUD 메서드
  • mongosh 실전
  • SQL ↔ MongoDB 문법 대조표
  • MongoDB MOC

Synapse Map Insight

db.<컬렉션>.<메서드>( <필터 JSON>, <옵션 JSON> )
db.blocks.find() // 전부 db.blocks.find({ category: "model" }) // 필터 db.blocks.find({ category: "model" }, { _id: 0, block_id: 1, name: 1 }) // projection db.blocks.findOne({ block_id: "TSM0004" }) // 한 건 (없으면 null) db.blocks.find({ category: "model" }) .sort({ score: -1 }) // -1 내림차순 .skip(20).limit(10); // 페이지네이션 db.blocks.countDocuments({ category: "model" }) db.blocks.distinct("category")
{ 필드: 값 } // 같다 { 필드: { $연산자: 값 } } // 그 외 모든 조건 { 필드1: ..., 필드2: ... } // 최상위 나열 = AND
db.blocks.find({ score: { $gte: 0.5, $lt: 0.9 } }) // 0.5 <= score < 0.9 db.blocks.find({ category: { $in: ["model", "evaluate"] } }) db.blocks.find({ category: { $ne: "deprecated" } }) db.blocks.find({ alias: { $exists: false } }) // 필드 없음 db.blocks.find({ name: { $regex: "^TSM", $options: "i" } }) // 앞 고정만 인덱스 사용 db.blocks.find({ $or: [ { category: "model" }, { score: { $gte: 0.9 } } ] }) db.blocks.find({ $and: [ {...}, {...} ] }) // 같은 필드에 조건 2개일 때만 필요
db.conv.find({ "summary.turns": { $gte: 10 } }) db.conv.find({ messages: { $elemMatch: { role: "user", score: { $gte: 9 } } } })
db.blocks.insertOne({ block_id: "TSM0004", name: "선형 회귀", category: "model" }) db.blocks.insertMany([ {...}, {...} ])
// 일부 필드만 db.blocks.updateOne( { block_id: "TSM0004" }, { $set: { name: "선형 회귀", updated_at: new Date() }, $inc: { revision: 1 } } ) // 여러 건 db.blocks.updateMany({ category: "model" }, { $set: { reviewed: true } }) // upsert db.blocks.updateOne( { block_id: "TSM0004" }, { $set: { name: "선형 회귀" }, $setOnInsert: { created_at: new Date() } }, { upsert: true } ) // 문서 전체 교체 db.blocks.replaceOne({ block_id: "TSM0004" }, { block_id: "TSM0004", name: "..." }, { upsert: true })
db.blocks.deleteOne({ block_id: "TSM0004" }) db.blocks.deleteMany({ deprecated: true }) db.blocks.deleteMany({}) // 전부 — 필터 빠뜨림 사고 1순위
db.blocks.aggregate([ { $match: { deprecated: false } }, { $group: { _id: "$category", n: { $sum: 1 }, avg: { $avg: "$score" } } }, { $sort: { n: -1 } }, { $limit: 10 } ])
db.blocks.createIndex({ block_id: 1 }, { unique: true }) db.blocks.createIndex({ category: 1, score: -1 }) db.agent_trace.createIndex({ ts_start: 1 }, { expireAfterSeconds: 2592000 }) db.blocks.getIndexes() db.blocks.dropIndex("category_1_score_-1")