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

정의

cursor.addOption(flag)

중요

Mongo쉬 방법

This page documents a mongosh method. This is not the documentation for a language-specific driver, such as Node.js.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

참고

v3.2부터 지원이 중단되었습니다

v3.2부터 cursor.addOption() 연산자는 mongo 에서 더 이상 사용되지 않습니다. 대신 사용 가능한 커서 메서드 를 사용합니다.

아래 나열된 플래그를 설정하여 쿼리 동작을 변경하는 데 사용됩니다.

cursor.addOption() 메서드에는 다음과 같은 매개 변수가 있습니다.

Parameter	유형	설명
`flag`	flag	For `mongosh`, you can use the cursor flags listed below. For the driver-specific list, see your driver documentation.

호환성

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

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

중요

이 명령은 모든 MongoDB Atlas 클러스터에서 제한적으로 지원 됩니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

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

Flags

mongosh 커서 동작을 수정하기 위해 몇 가지 추가 커서 플래그를 제공합니다.

플래그	설명
`DBQuery.Option.tailable`	마지막 데이터가 수신되면 커서가 닫히지 않도록 설정하여, 초기 결과가 소진된 후에도 쿼리가 추가된 데이터를 계속 반환할 수 있도록 합니다.
`DBQuery.Option.slaveOk`	복제본 세컨더리의 쿼리를 허용합니다.
`DBQuery.Option.noTimeout`	서버가 유휴 커서의 시간 초과를 방지합니다.
`DBQuery.Option.awaitData`	For use with `DBQuery.Option.tailable`. Sets the cursor to block the query thread when no data is available and await data for a set time instead of immediately returning no data. The cursor returns no data only if the timeout expires.
`DBQuery.Option.exhaust`	결과를 배치로 분할하지 않고 쿼리에서 반환된 모든 데이터를 한 번에 반환하도록 커서를 설정합니다.
`DBQuery.Option.partial`	일부 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)

경고

잘못된 유선 프로토콜 플래그를 추가하면 문제 및/또는 추가 서버 부하가 발생할 수 있습니다.

돌아가기

db.collection.watch

커서.allowDiskUse