Docs Menu

Docs Home애플리케이션 개발Python 드라이버PyMongo

문서 삽입

이 페이지의 내용

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

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

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

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

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.

InsertMany() 메서드는 앞의 선택적 매개변수와 선택적 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 설명서를 참조하세요.

← MongoDB에 데이터 쓰기