찾기

sort

선택 사항. 반환된 문서에 포함할 필드를 결정하기 위한 프로젝션 사양입니다. 투영 및 투영 연산자를참조하세요.

뷰에 대한 find() 작업은 다음 쿼리 및 투영 연산자 연산자를 지원하지 않습니다.

• $

• $elemMatch

• $slice

• $meta

선택 사항. 인덱스 사양. 인덱스 이름을 문자열로 지정하거나 인덱스 키 패턴으로 지정합니다. 이 옵션을 지정하면 쿼리 시스템은 힌트 인덱스를 사용하는 계획만 고려합니다.

다음과 같은 예외를 제외하고 명령에 min 및/또는 max 필드가 포함된 경우 hint가 필요하고, filter가 _id 필드 { _id: <value> }의 동일성 조건인 경우 min 및/또는 max와 함께 hint가 필요하지 않습니다.

선택 사항. 첫 번째 배치에서 반환할 문서 수입니다. 기본값은 101입니다. batchSize가 이면 커서가 설정되지만 첫 번째 배치에서는 문서가 반환되지 않습니다.

이전 유선 프로토콜 버전과 달리 find 명령의 batchSize가 1이면 커서가 닫히지 않습니다.

singleBatch

선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.

• mongod 로그 메시지( attr.command.cursor.comment 필드).

• 데이터베이스 프로파일러 출력의 command.comment 필드에 있습니다.

• currentOp{command.comment 5} 필드에 출력을 입력합니다.

댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다.

find 명령에 설정된 모든 주석은 find 커서에서 실행되는 후속 getMore 명령에 의해 상속됩니다.

선택 사항.

시간 제한을 밀리초 단위로 지정합니다. maxTimeMS에 값을 지정하지 않으면 작업이 시간 초과되지 않습니다. 0 값은 바인딩되지 않는 기본 동작을 명시적으로 지정합니다.

MongoDB는 db.killOp()와 동일한 메커니즘을 사용하여 할당된 시간 제한을 초과하는 작업을 종료합니다. MongoDB는 지정된 중단 지점 중 하나에서만 작업을 종료합니다.

linearizable read concern를 지정할 때는 데이터 보유 멤버의 과반수를 사용할 수 없는 경우 항상 maxTimeMS를 사용하세요. maxTimeMS는 작업이 무기한 차단되지 않도록 하며, 읽기 고려를 충족할 수 없는 경우 오류를 반환합니다.

선택 사항. 읽기 고려를 지정합니다.

readConcern 옵션의 구문은 다음과 같습니다. readConcern: { level: <value> }

가능한 읽기 고려 수준은 다음과 같습니다.

• "local"이는 프라이머리 및 보조 노드에 대한 읽기 작업의 읽기 고려 수준입니다.

• "available"입니다. 프라이머리 및 세컨더리에 대한 읽기 작업에 사용할 수 있습니다. "available"은 프라이머리 및 비 샤드형 세컨더리에 대해 "local"과 동일하게 동작합니다. 쿼리는 인스턴스의 가장 최근 데이터를 반환합니다.

• "majority". WiredTiger 스토리지 엔진을 사용하는 복제본 세트에 사용할 수 있습니다.

• "linearizable". primary의 읽기 작업에만 사용할 수 있습니다.

읽기 고려 수준에 대한 자세한 내용은 읽기 고려 수준을 참조하세요.

getMore 명령은 원래 find 명령에 지정된 readConcern 수준을 사용합니다.

선택 사항. 특정 인덱스에 대한 배타적 상한선입니다. 자세한 내용은 cursor.max() 참조하세요.

max 필드를 사용하려면 지정된 filter 가 _id 필드 { _id: <value> }의 동일성 조건이 아닌 한 명령에 hint 도 사용해야 합니다.

선택 사항. 특정 인덱스에 대한 포괄 하한입니다. 자세한 내용은 cursor.min() 참조하십시오.

min 필드를 사용하려면 지정된 filter 가 _id 필드 { _id: <value> }의 동일성 조건이 아닌 한 명령에 hint 도 사용해야 합니다.

선택 사항. 샤드된 컬렉션에 대한 쿼리의 경우, 쿼리된 하나 이상의 샤드를 사용할 수 없는 경우 명령(또는 후속 getMore 명령)이 오류 대신 부분적인 결과를 반환하도록 허용합니다.

쿼리된 샤드를 사용할 수 없기 때문에 find(또는 후속 getMore 명령)(이)가 부분 결과를 반환하는 경우 찾기 출력에는 partialResultsReturned 지표 필드가 포함됩니다. 쿼리된 샤드를 초기 find 명령에 사용할 수 있지만, 후속 getMore 명령에 하나 이상의 샤드를 사용할 수 없게 되는 경우, 샤드를 사용할 수 없는 동안 실행되는 getMore 명령만 partialResultsReturned(을)를 출력에 포함합니다.

선택 사항.

작업에 사용할 데이터 정렬을 지정합니다.

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

데이터 정렬 옵션의 구문은 다음과 같습니다:

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

데이터 정렬을 지정할 때 locale 필드는 필수이고, 다른 데이터 정렬 필드는 모두 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.

데이터 정렬이 지정되지 않았지만 컬렉션에 기본 데이터 정렬이 있는 경우( db.createCollection() 참조), 작업은 컬렉션에 지정된 데이터 정렬을 사용합니다.

컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다.

한 연산에 대해 여러 데이터 정렬을 지정할 수 없습니다. 예를 들어 필드별로 서로 다른 데이터 정렬을 지정할 수 없으며 정렬과 함께 찾기를 수행하는 경우 찾기 와 정렬에서 각각 다른 데이터 정렬을 사용하는 것은 허용되지 않습니다.

allowDiskUse

선택 사항.

이 옵션을 사용하여 특정 쿼리에 대한 allowDiskUseByDefault를 재정의할 수 있습니다. 이 옵션을 사용하여 다음 중 하나를 수행할 수 있습니다.

• 기본적으로 디스크 사용이 허용된 시스템에서는 디스크 사용을 금지합니다.

• 기본적으로 디스크 사용이 금지된 시스템에서 디스크 사용을 허용합니다.

MongoDB 6.0부터 allowDiskUseByDefault가 true로 설정되어 있고 서버의 파이프라인 실행 단계에 100메가바이트 이상의 메모리가 필요한 경우 MongoDB는 쿼리에 { allowDiskUse: false }를 지정하지 않는 한 임시 파일을 디스크에 자동으로 씁니다.

자세한 내용은 allowDiskUseByDefault를 참조하세요.

allowDiskUse MongoDB가 인덱스를 사용하여 지정된 정렬을 충족할 수 있는 경우 또는 차단 정렬에 100MB 미만의 메모리가 필요한 경우에는 효과가 없습니다.

allowDiskUse 에 대한 자세한 문서는 cursor.allowDiskUse() 참조하세요.

대용량 차단 정렬의 메모리 제한에 대한 자세한 내용은 정렬 및 인덱스 사용을참조하세요.

선택 사항.

변수 목록이 있는 문서를 지정합니다. 이를 통해 쿼리 텍스트에서 변수를 분리하여 명령 가독성을 향상시킬 수 있습니다.

문서 구문은 다음과 같습니다:

{
  <variable_name_1>: <expression_1>,
  ...,
  <variable_name_n>: <expression_n>
}

변수는 표현식에서 반환된 값으로 설정되며 이후에는 변경할 수 없습니다.

명령에서 변수 값에 액세스하려면 $$<variable_name> 형식의 이중 달러 기호 접두사 ($$) 를 변수 이름과 함께 사용하십시오.예시: $$targetTotal.

변수를 사용하여 결과를 필터링하려면 $expr 연산자 내에서 변수에 액세스해야 합니다.

let 및 변수를 사용한 전체 예시는 let에서 변수 사용을 참조하세요.