문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
참조
/
Mongo쉬 방법
/
커서

cursor.addOption()

이 페이지의 내용

  • 정의
  • 플래그
  • 예제

정의

cursor.addOption(flag)

중요

Mongo쉬 방법

이는 mongosh 메서드입니다. 이는 Node.js 또는 기타 프로그래밍 언어별 드라이버 메서드에 대한 설명서가 아닙니다 .

대부분의 경우 mongosh 메서드는 레거시 mongo 셸 메서드와 동일한 방식으로 작동합니다. 그러나 일부 레거시 메서드는 mongosh 에서 사용할 수 없습니다.

레거시 mongo 셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.

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

참고

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

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

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

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

매개 변수
유형
설명
flag
플래그
OP_QUERY 유선 프로토콜 플래그. mongosh 의 경우 아래 나열된 커서 플래그를 사용할 수 있습니다. 드라이버별 목록은 드라이버 설명서를 참조하세요.

플래그

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)

경고

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

돌아가기

커서

다음

cursor.allowDiskUse

이 페이지의 내용