복제본 세트에서 CRUD 작업을 실행하는 방법 지정
이 페이지의 내용
개요
이 가이드에서는 쓰기 고려 (write concern), 읽기 고려 (read concern), 읽기 설정 (read preference) 구성을 사용하여 MongoDB가 복제본 세트에서 생성, 읽기, 업데이트 및 삭제(CRUD) 작업을 실행하는 방식을 수정하는 방법에 대해 설명합니다.
다음 수준에서 쓰기 고려, 읽기 고려, 읽기 설정 옵션을 설정할 수 있습니다.
재정의되지 않는 한 모든 작업 실행에 대한 기본값을 설정하는 클라이언트
Session
트랜잭션
Database
컬렉션
이 목록은 옵션 설정의 우선 순위가 높아지는 순서도 표시됩니다. 예를 들어, 트랜잭션에 읽기 고려 (read concern) 수준을 설정하면 클라이언트에 설정된 읽기 고려 (read concern) 수준이 재정의됩니다.
이러한 옵션을 사용하면 복제본 세트에 있는 데이터의 인과적 일관성과 가용성을 사용자 지정할 수 있습니다.
쓰기 고려
쓰기 고려 (write concern)는 작업이 성공적으로 반환되기 전에 삽입 또는 업데이트와 같은 쓰기 작업에 대해 MongoDB에서 요청하는 승인 수준을 지정합니다. 명시적인 쓰기 고려 (write concern)를 지정하지 않은 작업에는 글로벌 기본 쓰기 고려 (write concern) 설정이 적용됩니다.
자세한 내용은 서버 매뉴얼에서 쓰기고려를 참조하세요. 자세한 API 설명서는 WriteConcern API 설명서를 참조하세요.
다음 표에서는 WriteConcern
매개변수에 대해 설명합니다.
Parameter | 유형 | 설명 |
---|---|---|
| 쓰기 작업이 지정된 수의 | |
| 숫자 | 쓰기 작업이 무기한 차단되지 않도록 시간 제한을 지정합니다. |
| 부울 | 쓰기 작업이 온디스크 저널에 기록되었음을 확인 요청합니다. |
예제: 단일 쓰기 작업에 대한 쓰기 고려 (write concern) 설정하기
이 코드는 새 문서를 만드는 동안 사용자 지정 WriteConcern
설정을 사용합니다.
myDB.myCollection.insertOne( { name: "anotherDocumentName" }, { writeConcern: { w: 2, wtimeoutMS: 5000 } } );
예시: 기존 쓰기 고려 (write concern) 조회 및 적용
이 코드는 fromOptions()
메서드를 사용하여 기존 데이터베이스 참고 myDB
의 옵션에서 WriteConcern
를 구성합니다. myDB
는 쓰기 고려 (write concern) 옵션을 허용하는 모든 엔터티에 대한 참고로 대체될 수 있습니다. 그런 다음 새 쓰기 고려 (write concern)가 문서에 적용됩니다 myDoc
.
const newWriteConcern = WriteConcern.fromOptions(myDB); const myDoc = { name: "New Document" }; WriteConcern.apply(myDoc,newWriteConcern);
readConcern
읽기 고려 (read concern)는 다음과 같은 동작을 지정합니다.
level
매개변수를 사용하여 읽기 고려 (read concern) 설정을 지정할 수 있습니다. 기본 읽기 고려 (read concern) 수준은 local
입니다. 즉, 클라이언트는 클라이언트가 연결된 복제본 세트 멤버의 데이터를 반환하며 데이터가 모든 복제본 세트 멤버에 기록되었다는 보장은 없습니다. 읽기 고려 (read concern) 수준 요구 사항이 낮을수록 지연 시간이 줄어들 수 있습니다.
읽기 고려 또는 읽기 고려 수준에 대한 자세한 내용은 MongoDB Server 매뉴얼의 읽기 고려를 참조하세요. 읽기 고려 수준의 유형 및 정의에 대한 자세한 내용은 ReadConcern
ReadConcern 을 참조하세요. API 문서에서 확인할 수 있습니다.
예제: 애그리게이션의 읽기 고려 (read concern) 수준 설정
이 코드는 애그리게이션의 읽기 고려 (read concern) 수준을 "majority"
로 설정합니다.
const pipeline = [ {"$match": { category: "KITCHENWARE", }}, {"$unset": [ "_id", "category", ]} ]; result = await myDB.collection("mycollection") .aggregate( pipeline, { readConcern: { level: "available" } } );
애그리게이션에 대한 자세한 내용은 애그리게이션 페이지를 참조하세요.
예제: 데이터베이스의 읽기 고려 변경
이 코드는 읽기 고려 (read concern) 수준을 "local"
로 변경합니다.
const options = { readConcern: { level: "local" } }; const myDB = client.db("mydb", options);
읽기 설정
읽기 설정 (read preference)은 MongoDB가 쿼리를 실행할 때 읽을 복제본 세트의 멤버를 결정합니다. 서버가 멤버를 평가하는 방법을 사용자 지정할 수도 있습니다.
자세한 API 설명서는 ReadPreference API 설명서를 참조하세요.
다음 표에서는 ReadPreference
매개 변수에 대해 설명합니다.
Parameter | 유형 | 설명 |
---|---|---|
| 서버가 읽는 복제본 세트 노드에 대한 요구 사항 또는 기본 설정을 지정합니다. 기본 모드인 | |
| 보조 복제본 세트 구성원에 태그를 할당하여 서버가 이를 평가하는 방식을 사용자 지정합니다. 태그는 | |
| 읽기 설정에 적용할 수 있는 헤지 및 maxStalenessSeconds 를 포함한 다양한 옵션을 설정합니다. |
예시: 트랜잭션에 대한 읽기 설정 및 고려 설정
이 코드는 트랜잭션의 작업에 대한 읽기 설정, 읽기 고려 및 쓰기 고려를 설정합니다.
const transactionOptions = { readPreference: "primary", readConcern: { level: "local" }, writeConcern: { w: "majority" }, }; const session = client.startSession(); session.startTransaction(transactionOptions); // ... await session.commitTransaction(); await session.endSession();
트랜잭션에 대한 자세한 내용은 트랜잭션을 참조하세요 .
예시: 연결 문자열에서 cluster의 읽기 설정 (read preference) 지정
이 코드 예시에서는 cluster에서 쿼리를 수행할 때 '세컨더리' 읽기 설정 (read preference) 모드를 사용하는 MongoClient를 만듭니다.
const uri = "mongodb+srv://<user>:<password>@<cluster-url>?readPreference=secondary&maxStalenessSeconds=120"; const client = new MongoClient(uri);
이 예에서는 maxStalenessSeconds
옵션도 설정합니다. 연결 string 옵션에 대한 자세한 내용은 매뉴얼의 연결 string 옵션 섹션을 참조하세요.
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.