문서 메뉴
문서 홈
/ / /
Node.js 드라이버
/ /

복제본 세트에서 CRUD 작업을 실행하는 방법 지정

이 페이지의 내용

  • 개요
  • 쓰기 고려
  • 예제: 단일 쓰기 작업에 대한 쓰기 고려 (write concern) 설정하기
  • 예시: 기존 쓰기 고려 (write concern) 조회 및 적용
  • readConcern
  • 예제: 애그리게이션의 읽기 고려 (read concern) 수준 설정
  • 예제: 데이터베이스의 읽기 고려 변경
  • 읽기 설정
  • 예시: 트랜잭션에 대한 읽기 설정 및 고려 설정
  • 예시: 연결 문자열에서 cluster의 읽기 설정 (read preference) 지정
  • API 문서

이 가이드에서는 쓰기 고려 (write concern), 읽기 고려 (read concern), 읽기 설정 (read preference) 구성을 사용하여 MongoDB가 복제본 세트에서 생성, 읽기, 업데이트 및 삭제(CRUD) 작업을 실행하는 방식을 수정하는 방법에 대해 설명합니다.

다음 수준에서 쓰기 고려, 읽기 고려, 읽기 설정 옵션을 설정할 수 있습니다.

  • 재정의되지 않는 한 모든 작업 실행에 대한 기본값을 설정하는 클라이언트

  • Session

  • 트랜잭션

  • 데이터베이스

  • 컬렉션

이 목록은 옵션 설정의 우선 순위가 높아지는 순서도 표시됩니다. 예를 들어, 트랜잭션에 읽기 고려 (read concern) 수준을 설정하면 클라이언트에 설정된 읽기 고려 (read concern) 수준이 재정의됩니다.

이러한 옵션을 사용하면 복제본 세트에 있는 데이터의 인과적 일관성과 가용성을 사용자 지정할 수 있습니다.

쓰기 고려 (write concern)는 작업이 성공적으로 반환되기 전에 삽입 또는 업데이트와 같은 쓰기 작업에 대해 MongoDB에서 요청하는 승인 수준을 지정합니다. 명시적인 쓰기 고려 (write concern)를 지정하지 않은 작업에는 글로벌 기본 쓰기 고려 (write concern) 설정이 적용됩니다.

자세한 내용은 MongoDB Server 매뉴얼의 쓰기 고려 를 참조하세요. 자세한 API 설명서는 WriteConcern API 설명서를 참조하세요.

다음 표에서는 WriteConcern 매개변수에 대해 설명합니다.

매개 변수
유형
설명
w (선택 사항)
쓰기 작업이 지정된 수의 mongod 인스턴스 또는 지정된 태그로 레이블이 지정된 mongod 인스턴스로 전파되었음을 확인 요청합니다.
wtimeoutMS (선택 사항)
숫자
쓰기 작업이 무기한 차단되지 않도록 시간 제한을 지정합니다.
journal (선택 사항)
부울
쓰기 작업이 온디스크 저널에 기록되었음을 확인 요청합니다.

이 코드는 새 문서를 만드는 동안 사용자 지정 WriteConcern 설정을 사용합니다.

myDB.myCollection.insertOne(
{ name: "anotherDocumentName" },
{ writeConcern:
{ w: 2, wtimeoutMS: 5000 }
}
);

이 코드는 fromOptions() 메서드를 사용하여 기존 데이터베이스 참고 myDB 의 옵션에서 WriteConcern 를 구성합니다. myDB 는 쓰기 고려 (write concern) 옵션을 허용하는 모든 엔터티에 대한 참고로 대체될 수 있습니다. 그런 다음 새 쓰기 고려 (write concern)가 문서에 적용됩니다 myDoc.

const newWriteConcern = WriteConcern.fromOptions(myDB);
const myDoc = { name: "New Document" };
WriteConcern.apply(myDoc,newWriteConcern);

읽기 고려 (read concern)는 다음과 같은 동작을 지정합니다.

level 매개변수를 사용하여 읽기 고려 (read concern) 설정을 지정할 수 있습니다. 기본 읽기 고려 (read concern) 수준은 local 입니다. 즉, 클라이언트는 클라이언트가 연결된 복제본 세트 멤버의 데이터를 반환하며 데이터가 모든 복제본 세트 멤버에 기록되었다는 보장은 없습니다. 읽기 고려 (read concern) 수준 요구 사항이 낮을수록 지연 시간이 줄어들 수 있습니다.

읽기 고려 또는 읽기 고려 수준에 대한 자세한 내용은 MongoDB Server 매뉴얼의 읽기 고려를 참조하세요. 읽기 고려 수준의 유형 및 정의에 대한 자세한 내용은 ReadConcern ReadConcern 을 참조하세요. API 문서에서 확인할 수 있습니다.

이 코드는 애그리게이션의 읽기 고려 (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 매개 변수에 대해 설명합니다.

매개 변수
유형
설명
mode
서버가 읽는 복제본 세트 노드에 대한 요구 사항 또는 기본 설정을 지정합니다. 기본 모드인 primary 은 작업이 복제본 세트의 프라이머리 멤버에서 읽도록 지정합니다.
tags (선택 사항)
보조 복제본 세트 구성원에 태그를 할당하여 서버가 이를 평가하는 방식을 사용자 지정합니다. 태그는 primary 읽기 설정 (read preference) 모드 설정과 함께 사용할 수 없습니다.
options (선택 사항)
읽기 설정에 적용할 수 있는 헤지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) 모드를 사용하는 MongoClient를 만듭니다.

const uri = "mongodb+srv://<user>:<password>@<cluster-url>?readPreference=secondary&maxStalenessSeconds=120";
const client = new MongoClient(uri);

이 예에서는 maxStalenessSeconds 옵션도 설정합니다. 연결 string 옵션에 대한 자세한 내용은 매뉴얼의 연결 string 옵션 섹션을 참조하세요.

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.

← 복합 작업