대량 쓰기 작업

개요

이 가이드 에서는 Ruby 운전자 사용하여 단일 데이터베이스 호출로 데이터를 여러 번 변경하는 대량 쓰기 (write) 작업을 수행하는 방법을 학습 수 있습니다.

동일한 작업 에 대해 문서를 삽입하고, 문서를 업데이트 , 문서를 삭제 해야 하는 상황을 생각해 보세요. 개별 쓰기 (write) 메서드를 사용하는 경우 각 쓰기 (write) 작업은 데이터베이스 별도로 액세스합니다. 대신 대량 쓰기 (write) 작업을 사용하여 애플리케이션 에서 서버 에 대해 수행하는 호출 수를 최적화할 수 있습니다.

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

쓰기 작업 정의

수행하려는 각 쓰기 (write) 작업에 대해 다음 작업 중 하나를 구현하는 해시를 만듭니다.

• insert_one

• update_one

• update_many

• replace_one

• delete_one

• delete_many

그런 다음 이러한 인스턴스 목록을 bulk_write 메서드에 전달합니다.

다음 섹션에서는 이전 작업의 인스턴스를 만들고 사용하는 방법을 보여줍니다. 대량 작업 수행 섹션에서는 해시 목록을 bulk_write 메서드에 전달하여 대량 작업을 수행하는 방법을 보여 줍니다.

insert_one = { insert_one: { name: 'Steve Rogers Cafe', borough: 'Brooklyn' } }

update_one = { update_one: 
  { 
    filter: { name: 'Mountain View' },
    update: { '$set': { borough: 'Queens' } }
  }
}

update_many = { update_many: 
  { 
    filter: { name: 'Starbucks' },
    update: { '$set': { cuisine: 'Cafe' } }
  }
}

replace_one = { replace_one:
  { 
    filter: { name: 'Old World Diner' },
    replacement: { '$set': { name: 'New Age Luncheonette' } }
  }
}

delete_one = { delete_one: { name: 'Old World Diner' } }

delete_many = { delete_many: { name: 'Starbucks' } }

대량 작업 수행

수행하려는 각 작업에 대한 해시를 정의한 후 이러한 객체 목록을 bulk_write 메서드에 전달합니다. 기본값 으로 이 메서드는 해시 목록에 지정된 순서대로 작업을 실행합니다.

다음 예시 에서는 bulk_write 메서드를 사용하여 여러 쓰기 (write) 작업을 수행합니다.

insert_one = { insert_one: { name: 'Nuovo Ristorante', borough: 'Brooklyn', cuisine: 'Italian' } }
update_one = { update_one: 
  { 
    filter: { name: 'Moonlit Tavern' },
    update: { '$set': { borough: 'Queens' } }
  }
}
delete_many = { delete_many: { name: 'Crepe' } }
writes = [insert_one, update_one, delete_many]
collection.bulk_write(writes)

쓰기 (write) 작업 중 하나라도 실패하면 Ruby 운전자 BulkWriteError 를 발생시키고 더 이상 작업을 수행하지 않습니다. BulkWriteError 은(는) 실패한 작업과 예외에 대한 세부 정보가 포함된 details 항목을 제공합니다.

대량 쓰기 작업 사용자 지정

bulk_write 메서드는 대량 쓰기 (write) 작업을 구성하는 데 사용할 수 있는 옵션을 지정하는 options 해시를 선택적으로 허용합니다. 옵션을 지정하지 않으면 운전자 기본값 설정으로 대량 작업을 수행합니다.

다음 표에서는 bulk_write 메서드를 구성하는 데 사용할 수 있는 옵션에 대해 설명합니다.

다음 코드는 옵션을 생성하고 ordered 옵션을 false 로 설정하여 순서가 지정되지 않은 대량 쓰기 (write) 지정합니다. 그런 다음 이 코드는 bulk_write 메서드를 사용하여 앞의 예시 와 동일한 대량 작업을 수행합니다.

options = { ordered: false }
collection.bulk_write(writes, options)

순서가 지정되지 않은 대량 쓰기 (write) 의 쓰기 (write) 작업 중 하나라도 실패하면 Ruby 운전자 모든 작업을 시도한 후에만 오류를 보고합니다.

반환 값

bulk_write 메서드는 BulkWrite::Result을 반환합니다. 다음 인스턴스 메서드를 사용하여 Result 인스턴스 의 정보 액세스 수 있습니다.

추가 정보

개별 쓰기 작업을 수행하는 방법을 알아보려면 다음 가이드를 참조하세요.

• 문서 삽입
• 문서 업데이트
• 문서 삭제
• 문서 교체