문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼
Mongo.setReadPref()
정의
Mongo.setReadPref(mode, tagSet, hedgeOptions)
Mongo
연결 객체에서setReadPref()
메서드를 호출하여 클라이언트가 모든 쿼리를 복제본 세트의 멤버로 라우팅하는 방법을 제어합니다. [1]참고
해당 읽기 설정을 사용하려면 해당 연결을 사용하여 문서를 검색하기 전에 연결 객체에서
Mongo.setReadPref()
를 호출해야 합니다.
[1] | 특정 쿼리(1개 또는 여러 개)에 대해 읽기 설정을 적용하려면 반복하기 전에 커서에 cursor.readPref() 를 적용하면 됩니다. 자세한 내용은 cursor.readPref() 를 참조하세요. |
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
문자열 | 다음 읽기 설정 (read preference) 모드 중 하나: | |
문서 배열 | ||
문서 | 선택 사항입니다. 헤지된 읽기 사용 허용 여부를 지정하는 문서:
헤지된 읽기(hedged read)는 샤딩된 cluster에 사용할 수 있습니다. 헤지된 읽기(hedged read)를 사용하려면 읽기 설정 (read preference) |
Mongo.setReadPref()
은(는) 읽기 설정에 대한 읽기 설정 maxStalenessSeconds
옵션을 지원하지 않습니다.
예제
읽기 설정 (read preference) 모드 지정
다음 작업은 읽기 설정 모드 를 설정하여 읽기 대상을 세컨더리 멤버로 지정합니다. 이는 암시적으로 세컨더리에서 읽기를 허용합니다.
db.getMongo().setReadPref('secondary')
그러나 mongo shell을 사용하여 프라이머리에 연결된 상태에서 호출하는 경우 위 명령은 쿼리를 세컨더리로 라우팅하지 않습니다.
읽기 설정 (read preference) 태그 세트 지정
특정 태그로 세컨더리를 타겟팅하려면 모드 와 tagSet 배열을 모두 포함합니다.
db.getMongo().setReadPref( "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.getMongo().setReadPref( "secondary", // mode null, // tag set { enabled: true } // hedge options ) 태그 세트 포함
db.getMongo().setReadPref( "secondary", // mode [ { "datacenter": "B" }, { } ], // tag set { enabled: true } // hedge options )