cursor.addOption()

이 페이지의 내용

정의

Flags
예시

정의

cursor.addOption(flag)

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드를 설명합니다. 이는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

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

참고

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

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

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

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

Parameter	유형	설명
`flag`	flag	`mongosh` 의 경우 아래 나열된 커서 플래그를 사용할 수 있습니다. 드라이버별 목록은 운전자 설명서를 참조하세요.

Flags

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

플래그	설명
`DBQuery.Option.tailable`	마지막 데이터가 수신되면 커서가 닫히지 않도록 설정하여, 초기 결과가 소진된 후에도 쿼리가 추가된 데이터를 계속 반환할 수 있도록 합니다.
`DBQuery.Option.slaveOk`	복제본 세컨더리의 쿼리를 허용합니다.
`DBQuery.Option.noTimeout`	서버가 유휴 커서의 시간 초과를 방지합니다.
`DBQuery.Option.awaitData`	`DBQuery.Option.tailable`과 함께 사용됩니다. 사용 가능한 데이터가 없을 때 쿼리 스레드를 차단하고, 즉시 데이터를 반환하는 대신 설정된 시간 동안 데이터를 기다리도록 커서를 설정합니다. 커서는 시간 초과가 만료된 경우에만 데이터를 반환하지 않습니다.
`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)

경고

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

돌아가기

Cursors

커서.allowDiskUse