정의
cursor.addOption(flag)중요
Mongo쉬 방법
이는
mongosh메서드입니다. 이는Node.js또는 기타 프로그래밍 언어별 드라이버 메서드에 대한 설명서가 아닙니다 .대부분의 경우
mongosh메서드는 레거시mongoshell 메서드와 동일한 방식으로 작동합니다. 그러나 일부 레거시 메서드는mongosh에서 사용할 수 없습니다.레거시
mongo셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 문서를 참조하세요.
참고
v3.2부터 지원이 중단되었습니다
v3.2 부터
cursor.addOption()연산자는mongosh에서 더 이상 사용되지 않습니다.mongosh에서는 사용 가능한 커서 메서드 를 대신 사용합니다.아래 나열된 플래그를 설정하여 쿼리 동작을 변경하는 데 사용됩니다.
cursor.addOption()메서드에는 다음과 같은 매개 변수가 있습니다.Parameter유형설명flagflag
OP_QUERY유선 프로토콜 플래그.mongosh의 경우 아래 나열된 커서 플래그를 사용할 수 있습니다. 드라이버별 목록은 운전자 설명서를 참조하세요.
호환성
이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 M0, M2, M5 및 M10클러스터에서 제한적으로 지원 됩니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
Flags
mongosh 커서 동작을 수정하기 위해 몇 가지 추가 커서 플래그를 제공합니다.
플래그 | 설명 |
|---|---|
마지막 데이터가 수신되면 커서가 닫히지 않도록 설정하여, 초기 결과가 소진된 후에도 쿼리가 추가된 데이터를 계속 반환할 수 있도록 합니다. | |
복제본 슬레이브에 대한 쿼리를 허용합니다. | |
서버가 유휴 커서의 시간 초과를 방지합니다. | |
와 함께 | |
결과를 배치로 분할하지 않고 쿼리에서 반환된 모든 데이터를 한 번에 반환하도록 커서를 설정합니다. | |
일부 cluster가 오류를 발생시키는 대신 응답하지 않는 cluster에 대한 쿼리의 부분 데이터를 반환하도록 커서를 설정합니다. |
예시
다음 예에서는 DBQuery.Option.tailable 플래그와 DBQuery.Option.awaitData 플래그를 추가하여 쿼리가 tailable cursor( tailable cursor)를 반환하도록 합니다. 이 시퀀스는 커서를 생성합니다. 전체 결과 집합을 반환한 후 쿼리 중에 추가된 추가 데이터를 캡처하고 반환할 수 있도록 기본 간격인 1000밀리초까지 기다립니다.
var t = db.myCappedCollection; var cursor = t.find().addOption(DBQuery.Option.tailable). addOption(DBQuery.Option.awaitData)
경고
잘못된 유선 프로토콜 플래그를 추가하면 문제 및/또는 추가 서버 부하가 발생할 수 있습니다.