KSCOLD LogoKSCOLD
Blog
Feed
Product
Admin Night
Vault
Guestbook
Info

Vault 목록

MongoDB insertOne() insertMany()

연결된 노트와 함께 읽기

MongoDB insertOne() insertMany()

2026년 8월 28일

MongoDB insertOne() insertMany()

새 문서를 넣는다. 이미 있으면 갱신하지 않는다 — 그건 updateOne이나 upsert의 일이다.

JavaScript

셸

JavaScript

파이썬

Python

_id는 자동으로 붙는다

MERMAID

_id를 직접 줄 수도 있다. 의미 있는 키가 이미 있으면 그걸 _id로 쓰면 인덱스 하나를 아낀다 (MongoDB 문서 모델과 BSON).

ordered — 중간에 실패하면

Python
옵션동작
ordered=True (기본)순서대로 넣다가 하나 실패하면 거기서 중단. 뒤는 안 넣음
ordered=False실패한 것만 건너뛰고 나머지는 전부 시도
TEXT

로그·trace처럼 일부가 중복이어도 나머지는 들어가야 하는 경우 ordered=False가 맞다. 병렬 처리라 더 빠르기도 하다.

부분 실패는 예외로 온다

Python

예외가 났다고 아무것도 안 들어간 게 아니다. ordered=False에서는 일부가 이미 저장돼 있다 (MongoDB 예외 처리).

왜 우리 코드에는 insert가 거의 없나

시딩·원장은 전부 upsert 계열을 쓴다. insert는 두 번 돌리면 중복이 되어 멱등하지 않기 때문이다. insert가 맞는 자리는 한 번만 일어나는 사건 기록이다.

한 줄 정리

insert는 "새로 넣기"뿐이다. 재실행 가능성이 있으면 upsert를, 대량 삽입에는 ordered=False를 쓴다.

관련

  • upsert
  • MongoDB updateOne()
  • MongoDB bulkWrite()
  • MongoDB 쓰기 결과 객체
  • MongoDB 예외 처리
  • 유니크 인덱스
  • MongoDB CRUD 메서드

Synapse Map Insight

db.<컬렉션>.insertOne( <문서> ) db.<컬렉션>.insertMany( [<문서>, <문서>, ...], { ordered: true|false } )
db.blocks.insertOne({ block_id: "TSM0004", name: "선형 회귀", category: "model" }) db.blocks.insertMany([ { block_id: "TSM0004", name: "선형 회귀" }, { block_id: "TSM0005", name: "로지스틱 회귀" } ])
res = await db.blocks.insert_one({"block_id": "TSM0004", "name": "선형 회귀"}) res.inserted_id # 새로 생긴 _id res = await db.blocks.insert_many(docs, ordered=False) res.inserted_ids # _id 리스트
await db.blocks.insert_many(docs, ordered=False)
ordered=True [ok] [ok] [FAIL] [ ] [ ] ← 3번째에서 멈춤 ordered=False [ok] [ok] [FAIL] [ok] [ok] ← 계속 진행
from pymongo.errors import BulkWriteError try: await db.blocks.insert_many(docs, ordered=False) except BulkWriteError as e: e.details["nInserted"] # 성공 개수 e.details["writeErrors"] # 실패 내역