문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼
cursor.readPref()
정의
cursor.readPref(mode, tagSet, hedgeOptions)
중요
Mongo쉬 방법
이는
mongosh
메서드입니다. 이는Node.js
또는 기타 프로그래밍 언어별 드라이버 메서드에 대한 설명서가 아닙니다 .대부분의 경우
mongosh
메서드는 레거시mongo
셸 메서드와 동일한 방식으로 작동합니다. 그러나 일부 레거시 메서드는mongosh
에서 사용할 수 없습니다.레거시
mongo
셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.
커서에
readPref()
를 추가하여 클라이언트가 쿼리를 복제본 세트의 멤버로 라우팅하는 방법을 제어합니다.참고
데이터베이스에서 문서를 검색하기 전에 커서에
readPref()
를 적용해야 합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
문자열 | 다음 읽기 설정 (read preference) 모드 중 하나: | |
문서 배열 | ||
문서 | 선택 사항. 헤지된 읽기( hedged read) 사용 여부를 지정하는 문서입니다.
헤지된 읽기(hedged read)는 샤딩된 cluster에 사용할 수 있습니다. 헤지된 읽기(hedged read)를 사용하려면 읽기 설정 (read preference) |
readPref()
은(는) 읽기 설정에 대한 읽기 설정 maxStalenessSeconds
옵션을 지원하지 않습니다.
예제
읽기 설정 (read preference) 모드 지정
다음 작업은 읽기 설정 모드 를 사용하여 읽기 대상을 세컨더리 멤버로 지정합니다.
db.collection.find({ }).readPref( "secondary")
읽기 설정 (read preference) 태그 세트 지정
특정 태그로 세컨더리를 타겟팅하려면 모드 와 tagSet 배열을 모두 포함합니다.
db.collection.find({ }).readPref( "secondary", [ { "datacenter": "B" }, // First, try matching by the datacenter tag { "region": "West"}, // If not found, then try matching by the region tag { } // If not found, then use the empty document to match all eligible members ] )
세컨더리 선택 프로세스에서 MongoDB는 datacenter: "B"
태그가 있는 세컨더리 멤버를 먼저 찾으려고 합니다.
발견되면 MongoDB는 적격 세컨더리를
datacenter: "B"
태그가 있는 세컨더리로 제한하고 나머지 태그를 무시합니다.아무것도 발견되지 않으면 MongoDB는
"region": "West"
태그를 사용하여 세컨더리 멤버를 찾으려고 시도합니다.발견되면 MongoDB는 적격 세컨더리를
"region": "West"
태그가 있는 세컨더리로 제한합니다.아무것도 발견되지 않으면 MongoDB는 적격 세컨더리를 사용합니다.
자세한 내용 은 태그 일치 순서를 참조하세요.
팁
다음도 참조하세요.
헤지된 읽기(hedged read) 지정
샤드 cluster의 경우 프라이머리가 아닌 읽기 설정 (read preference) 에 대해 헤지된 읽기( hedged read )를 활성화할 수 있습니다. 헤지된 읽기(hedged read)를 사용하려면 mongos
에 헤지된 읽기(hedged read)에 대한 enabled support
(기본값)이 있어야 하며, primary
비- 읽기 설정 (read preference) 에서 헤지된 읽기(hedged read)를 사용할 수 있어야 합니다.
헤지된 읽기(hedged read)를 사용하여 샤드 클러스터의 세컨더리를 대상으로 하려면 다음 예제에서와 같이 모드 와 헤지 옵션을 모두 포함합니다.
태그 세트 없이
db.collection.find({ }).readPref( "secondary", // mode null, // tag set { enabled: true } // hedge options ) 태그 세트 포함
db.collection.find({ }).readPref( "secondary", // mode [ { "datacenter": "B" }, { } ], // tag set { enabled: true } // hedge options )