문서 삽입

개요

이 가이드 에서는 Ruby 운전자 사용하여 삽입 작업을 수행하여 MongoDB 컬렉션 에 문서를 추가하는 방법을 학습 수 있습니다.

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

• insert_one 단일 문서 삽입

• insert_many 하나 이상의 문서를 삽입하려면

database = client.use('sample_restaurants')
collection = database[:restaurants]

_id 필드

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

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

• 각 문서 의 _id 필드 를 직접 설정하여 각 값이 고유하도록 합니다.

• 운전자 가 각 문서 _id 필드 에 대해 고유한 BSON::ObjectId 값을 자동으로 생성하도록 합니다.

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

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

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

문서 하나 삽입

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

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

document = { name: 'Neighborhood Bar & Grill', borough: 'Queens' }
collection.insert_one(document)

여러 문서를 삽입합니다.

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

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

documents = [
  { name: 'Metropolitan Cafe', borough: 'Queens' },
  { name: 'Yankee Bistro', borough: 'Bronx' }
]
collection.insert_many(documents)

삽입 동작 수정

Hash 객체 insert_one 메서드에 매개 변수로 전달하여 삽입 작업을 구성하는 옵션을 설정하다 수 있습니다. 옵션을 지정하지 않으면 운전자 기본값 설정으로 삽입 작업을 수행합니다.

다음 표에서는 insert_one 작업을 구성하기 위해 설정하다 수 있는 옵션에 대해 설명합니다.

메서드 호출에 Hash 를 매개 변수로 전달하여 insert_many 메서드에 대한 앞의 설정을 설정하다 수 있습니다. ordered 옵션을 사용하여 운전자 MongoDB 에 문서를 삽입하는 순서를 지정할 수도 있습니다.

documents = [
  { name: 'Cloudy Day', borough: 'Brooklyn' },
  { name: 'Squall or Shine', borough: 'Staten Island' }
  { name: 'Rose Field', borough: 'Queens' }
]
options = { bypass_document_validation: true }
collection.insert_many(documents, options)

API 문서

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

• insert_one

• insert_many