문서 삽입

이 페이지의 내용

개요

샘플 데이터
0}_id 필드
문서 하나 삽입
여러 문서를 삽입합니다.
삽입 동작 수정
예시
추가 정보
API 문서

개요

이 가이드에서는 PyMongo를 사용하여 삽입 작업을 수행하여 MongoDB 컬렉션에 문서를 추가하는 방법을 배울 수 있습니다.

삽입 작업은 하나 이상의 문서를 MongoDB 컬렉션에 삽입하는 작업입니다. insert_one() 또는 insert_many() 메서드를 사용하여 삽입 작업을 수행할 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants.restaurants 컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 PyMongo 시작하기 튜토리얼을 참조하세요.

필드 `_id`

MongoDB 컬렉션에서 각 문서에는 고유한 필드 값이 있는 _id 필드가 포함되어야 합니다.

MongoDB를 사용하면 이 필드를 두 가지 방법으로 관리할 수 있습니다.

각 _id 필드 값이 고유하도록 각 문서에 대해 이 필드를 직접 설정할 수 있습니다.
드라이버가 각 문서 _id 에 대해 고유한 ObjectId 값을 자동으로 생성하도록 할 수 있습니다. 문서에 대해 _id 값을 수동으로 설정하지 않으면 드라이버가 필드를 ObjectId 으로 채웁니다.

고유성을 보장할 수 없는 경우 드라이버가 _id 값을 자동으로 생성하도록 하는 것이 좋습니다.

참고

중복된 _id 값이 고유 인덱스 제약 조건을 위반하면 드라이버가 insert_one()에서 WriteError을 반환하거나 insert_many()에서 BulkWriteError을 반환합니다.

_id 필드에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 고유 인덱스 가이드를 참조하세요.

문서 구조 및 규칙에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 문서 가이드를 참조하세요.

문서 하나 삽입

MongoDB 컬렉션에 단일 문서를 추가하려면 insert_one() 메서드를 호출하고 추가하려는 문서를 전달합니다.

다음 예시에서는 restaurants 컬렉션에 문서를 삽입합니다.

sample_restaurants.restaurants.insert_one({"name" : "Mongo's Burgers"})

여러 문서를 삽입합니다.

MongoDB 컬렉션에 여러 문서를 추가하려면 insert_many() 메서드를 호출하고 추가하려는 문서 목록을 전달합니다.

다음 예에서는 restaurants 컬렉션에 문서 목록을 삽입합니다.

document_list = [
   { "name" : "Mongo's Burgers" },
   { "name" : "Mongo's Pizza" }
]
sample_restaurants.restaurants.insert_many(document_list)

삽입 동작 수정

insert_one() 메서드는 삽입 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 추가 매개 변수를 선택적으로 허용합니다. 추가 매개변수를 지정하지 않으면 드라이버는 삽입을 사용자 지정하지 않습니다.

속성	설명
`bypass_document_validation`	If set to `True`, allows the write to opt out of document-level validation. Defaults to `False`.
`session`	An instance of `ClientSession`.
`comment`	A comment to attach to the operation. For more information, see the insert command fields guide in the MongoDB Server manual for more information.

insert_many() 메서드는 앞의 선택적 매개변수와 선택적 ordered 속성을 허용합니다.

속성	설명
`ordered`	If set to `True`, the driver sends documents to the server in the order provided. If an error occurs, the driver and server cancel all remaining insert operations. Defaults to `True`.

예시

다음 코드에서는 insert_many() 메서드를 사용하여 컬렉션에 세 개의 새 문서를 삽입합니다. 두 번째 메서드 인수가 bypass_document_validation = True 이므로 이 삽입 작업은 문서 수준 유효성 검사를 우회합니다.

document_list = [
    { "name" : "Mongo's Burgers" },
    { "name" : "Mongo's Pizza" },
    { "name" : "Mongo's Tacos" }
 ]
 sample_restaurants.restaurants.insert_many(document_list, bypass_document_validation = True)

추가 정보

PyMongo 로 문서를 삽입하는 실행 가능한 코드 예제는 MongoDB 에 데이터 쓰기를 참조하세요.

API 문서

이 가이드에서 설명하는 메서드나 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

돌아가기

MongoDB에 데이터 쓰기

문서 업데이트

개요