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

정의

cursor.hint(index)

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

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

쿼리에서 이 메서드를 호출하여 MongoDB의 기본 인덱스 선택 및 쿼리 최적화 프로세스를 재정의합니다. collection의 현재 인덱스 목록을 반환하려면 db.collection.getIndexes()를 사용합니다.

The cursor.hint() method has the following parameter:

Parameter	유형	설명
`index`	문자열 또는 문서	쿼리를 수행할 때 MongoDB가 '힌트' 또는 강제로 사용하는 인덱스입니다. 인덱스 이름이나 인덱스 사양 문서로 인덱스를 지정합니다. 또한 `{ $natural : 1 }`을 지정하여 쿼리가 정방향 컬렉션 스캔을 수행하도록 하거나 `{ $natural : -1 }`을 지정하여 역방향 컬렉션 스캔을 수행하도록 할 수 있습니다.

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

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하세요.

When an index filter exists for the query shape, MongoDB ignores the hint().
If a query includes a $text expression, you cannot use hint() to specify which index to use for the query.
If you use hint() on a hidden index or an index that doesn't exist, the operation returns an error.
Time Series 컬렉션에서는 인덱스 이름 또는 인덱스 키 패턴을 사용하여 힌트를 지정할 수 있습니다.
클러스터 쿼리 설정은 명령 필드 로 전달된 쿼리 설정 또는 인덱스 힌트보다 우선합니다. 일치하는 쿼리 설정에 이미 인덱스 힌트가 포함된 경우 MongoDB 명령 필드 인덱스 힌트를 무시합니다.

인덱스 힌트는 쿼리 형태에 영향을 주지 않습니다.

힌트 및 쿼리 설정에 대한 자세한 내용은 쿼리 설정 구문을 참조하세요.

$natural 을 cursor.hint() 와 함께 사용하여 컬렉션 스캔 수행하여 문서를 기본 순서로 반환합니다.

사용법은 강제 컬렉션 스캔을 참조하세요.

MongoDB 이전 7.0 $natural 버전에서는 0 NaN가,, "X", 와 같은 잘못된 유형 값을 -0.01 허용합니다. MongoDB.7 0다음에 및 이외의 값을 1 에 -1 $natural전달하면 MongoDB 오류를 반환합니다.

다음 예시에서는 age 필드의 인덱스를 사용하여 이름이 users인 collection의 모든 문서를 반환합니다.

db.users.find().hint( { age: 1 } )

인덱스 이름을 사용하여 인덱스를 지정할 수도 있습니다.

db.users.find().hint( "age_1" )

{ $natural : 1 }을 지정하여 쿼리가 정방향 컬렉션 스캔을 수행하도록 할 수 있습니다.

db.users.find().hint( { $natural : 1 } )

또한 { $natural : -1 }을 지정하여 쿼리가 역방향 컬렉션 스캔을 수행하도록 할 수도 있습니다.

db.users.find().hint( { $natural : -1 } )