커서.readPref() (mongosh 메서드)

정의

cursor.readPref(mode, tagSet): 중요
Mongo쉬 방법
이 페이지에서는 메서드를 mongosh 설명합니다. 이는 Node.js와 같은 언어별 운전자 에 대한 설명서가 아닙니다.
MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.
커서 에 를 추가하여 클라이언트 쿼리 를 복제본 세트 의 멤버로 라우팅하는 방법을 readPref() 제어합니다.
참고
readPref() 데이터베이스 에서 문서를 검색하기 전에 커서 에 를 적용 해야 합니다.

매개변수

Parameter	유형	설명
모드	문자열	다음 읽기 설정 (read preference) 모드 중 하나: `primary`, `primaryPreferred`, `secondary`, `secondaryPreferred` 또는 `nearest`
태그 세트	문서 배열	선택 사항. 지정된 태그가 있는 멤버에게 읽기 대상을 지정하는 데 사용되는 태그 세트 입니다. `tagSet` 은 사용할 수 없습니다 `primary` 자세한 내용은 읽기 설정 (read preference) 태그 세트 목록을 참조하세요.

readPref()는 읽기 설정 에 대한 읽기 설정 (read preference) 설정 옵션을 지원 하지 않습니다.maxStalenessSeconds

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

참고

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하세요.

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

예시

읽기 설정 (read preference) 모드 지정

다음 작업은 읽기 설정 모드 를 사용하여 읽기 대상을 세컨더리 멤버로 지정합니다.

db.collection.find({ }).readPref( "secondary")

읽기 설정 (read preference) 태그 세트 지정

특정 태그가 있는 세컨더리를 대상으로 하려면 mode 및 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는 적격 세컨더리를 사용합니다.

자세한 내용 은 태그 일치 순서를 참조하세요.

팁

커서.readPref() (mongosh 메서드)

정의

중요

Mongo쉬 방법

참고

매개변수

호환성

참고

예시

읽기 설정 (read preference) 모드 지정

읽기 설정 (read preference) 태그 세트 지정

팁