MongoDB 제한 및 임계값

MongoDB Atlas 한계

다음 한도는 MongoDB Atlas에서 호스팅되는 배포에만 적용됩니다. 이러한 한도 중 하나라도 사용자의 조직에 문제가 된다면 Atlas 지원팀에 문의하세요.

BSON 문서

BSON 문서 크기

최대 BSON 문서 크기는 16메가바이트입니다.

최대 문서 크기는 단일 문서가 과도한 양의 RAM을 사용하거나, 전송 중에 과도한 대역폭을 사용하지 않도록 하는 데 도움이 됩니다. 최대 크기보다 큰 문서를 저장하기 위해 MongoDB는 GridFS API를 제공합니다. GridFS에 대한 자세한 내용은 mongofiles 및 드라이버 설명서를 참조하십시오.

BSON 문서의 중첩 깊이

MongoDB는 BSON 문서에 대해 100개 이하의 중첩 수준을 지원합니다. 각 객체 또는 배열은 수준을 추가합니다.

이름 지정 제한 사항

데이터베이스 이름의 대/소문자 사용

데이터베이스를 구분하기 위해 대/소문자를 사용하지 않도록 합니다. 예를 들어 salesData 및 SalesData와 같은 이름의 두 데이터베이스를 사용할 수 없습니다.

MongoDB에서 데이터베이스를 만든 후에는 데이터베이스를 참조할 때 일관된 대/소문자를 사용해야 합니다. 예를 들어, salesData 데이터베이스를 만드는 경우 salesdata 또는 SalesData와 같이 대/소문자를 번갈아 사용하여 참조하지 않도록 합니다.

Windows용 데이터베이스 이름에 대한 제한 사항

Windows에서 실행되는 MongoDB deployment의 경우 데이터베이스 이름에 다음 문자를 포함할 수 없습니다.

/\. "$*<>:|?

또한 데이터베이스 이름에는 null 문자를 포함할 수 없습니다.

Unix 및 Linux 시스템의 데이터베이스 이름에 대한 제한 사항

Unix 및 Linux 시스템에서 실행되는 MongoDB deployment의 경우 데이터베이스 이름에 다음 문자를 포함할 수 없습니다.

/\. "$

또한 데이터베이스 이름에는 null 문자를 포함할 수 없습니다.

데이터베이스 이름 길이

데이터베이스 이름은 비워둘 수 없으며 64바이트 미만이어야 합니다.

컬렉션 이름 제한

컬렉션 이름은 밑줄 또는 문자로 시작해야 하며 다음은 불가능합니다.

• $가 포함되어 있습니다.

• 빈 문자열입니다(예: "").

• null 문자를 포함합니다.

• system. 접두사로 시작합니다 (내부용으로만 사용됨).

• .system.이 포함되어 있습니다.

컬렉션 이름에 밑줄 문자와 같은 특수 문자가 포함되어 있거나 숫자로 시작하는 경우 컬렉션에 액세스하려면 mongosh의 db.getCollection() 메서드 또는 드라이버의 유사한 메서드를 사용합니다.

네임스페이스 길이:

샤딩되지 않은 컬렉션 및 뷰에 대한 네임스페이스 길이 제한은 255바이트이고 샤딩된 컬렉션의 경우 235바이트입니다. 컬렉션 또는 뷰의 경우 네임스페이스에는 데이터베이스 이름, 점(.) 구분 기호 및 컬렉션/뷰 이름(예: <database>.<collection>)이 포함됩니다.

필드 이름에 대한 제한 사항

• 필드 이름에는 null 문자를 포함 할 수 없습니다.

• 서버는 점(.)과 달러 기호($)가 포함된 필드 이름의 저장을 허용합니다.

• MongoDB 5.0은 필드 이름에 ($) 및 (.)를 사용에 대한 지원을 개선했습니다.몇 가지 제한 사항이 있습니다. 자세한 내용은 필드 이름 고려 사항을 참조하십시오.

_id에 대한 제한 사항

필드 이름 _id는 프라이머리 키로 사용하기 위해 예약되어 있으며, 이 값은 컬렉션에서 고유해야 하고 변경할 수 없으며 배열이나 정규 표현식 이외의 모든 유형이 될 수 있습니다. _id가 하위 필드를 포함하는 경우, 하위 필드 이름은 ($) 기호로 시작할 수 없습니다.

이름 지정 경고

네임스페이스

네임스페이스 길이

샤딩되지 않은 컬렉션 및 뷰에 대한 네임스페이스 길이 제한은 255바이트이고 샤딩된 컬렉션의 경우 235바이트입니다. 컬렉션 또는 뷰의 경우 네임스페이스에는 데이터베이스 이름, 점(.) 구분 기호 및 컬렉션/뷰 이름(예: <database>.<collection>)이 포함됩니다.

팁

다음도 참조하세요.

이름 지정 제한 사항

Indexes

컬렉션당 인덱스 수

단일 컬렉션에는 64개 이하의 인덱스가 있을 수 있습니다.

복합 인덱스의 인덱싱된 필드 수

복합 인덱스에는 32개 이하의 필드가 포함될 수 있습니다.

쿼리는 텍스트 및 지리 공간적 인덱스를 모두 사용할 수 없습니다.

특수 텍스트 인덱스가 필요한 $text 쿼리를 다른 유형의 특수 인덱스가 필요한 쿼리 연산자와 결합할 수 없습니다. 예를 들어 $text 쿼리와 $near 연산자를 결합할 수 없습니다.

2dsphere 인덱스가 있는 필드는 도형만 보유할 수 있습니다.

2dsphere 인덱스가 있는 필드는 좌표 쌍 또는 GeoJSON 데이터 형식의 도형 데이터를 보유해야 합니다. 도형이 아닌 데이터가 있는 문서를 2dsphere 인덱스 필드에 삽입하거나 인덱스 필드에 도형이 아닌 데이터가 있는 컬렉션에 2dsphere 인덱스를 빌드하려고 하면 작업이 실패합니다.

팁

다음도 참조하세요.

샤드 작업 제한의 고유 인덱스 한도입니다.

제한된 수의 2dsphere 인덱스 키

2dsphere 인덱스에 대한 키를 생성하기 위해 mongod는 GeoJSON 도형을 내부 표현에 매핑합니다. 결과적인 내부 표현은 큰 값 배열일 수 있습니다.

mongod가 배열을 포함하는 필드에 인덱스 키를 생성하면 mongod은 각 배열 요소에 대한 인덱스 키를 생성합니다. 복합 인덱스의 경우, mongod은 각 필드에 대해 생성된 키 세트의 데카르트 곱 을 계산합니다. 두 세트가 모두 큰 경우 데카르트 곱을 계산하면 작업이 메모리 제한을 초과할 수 있습니다.

indexMaxNumGeneratedKeysPerDocument는 메모리 부족 오류를 방지하기 위해 단일 문서에 대해 생성되는 최대 키 수를 제한합니다. 기본값은 문서당 100,000개의 인덱스 키입니다. 제한을 올릴 수는 있지만 indexMaxNumGeneratedKeysPerDocument 매개 변수가 지정한 것보다 더 많은 키가 필요한 경우 작업이 실패합니다.

WiredTiger 스토리지 엔진의 Covered Queries에서 반환된 NaN 값은 항상 double 형식입니다

인덱스에 포함되는 쿼리에서 반환된 필드 값이 NaN인 경우 해당 NaN 값의 유형은 항상 double입니다.

Multikey Index

멀티키 인덱스 는 배열 필드에 대한 커버 쿼리를 할 수 없습니다.

지리 공간적 인덱스

지리 공간적 인덱스 는 쿼리를 포함할 수 없습니다.

인덱스 빌드의 메모리 사용량

createIndexes는 컬렉션에 하나 이상의 인덱스 빌드를 지원합니다. createIndexes는 메모리와 디스크의 임시 파일 조합을 사용하여 인덱스 빌드를 완료합니다. createIndexes의 메모리 사용량에 대한 기본 제한은 200MB이며 단일 createIndexes 명령을 사용하여 빌드된 모든 인덱스 간에 공유됩니다. 메모리 제한에 도달하면 createIndexes는 --dbpath 디렉토리 내의 _tmp 라는 하위 디렉토리에 있는 임시 디스크 파일을 사용하여 빌드를 완료합니다.

maxIndexBuildMemoryUsageMegabytes 서버 매개변수를 설정하여 메모리 제한을 덮어쓸 수 있습니다. 메모리 제한을 높게 설정하면 인덱스 빌드가 더 빨리 완료될 수 있습니다. 하지만 이 제한을 시스템의 미사용 RAM에 비해 너무 높게 설정하면 메모리가 고갈되고 서버가 종료될 수 있습니다.

• 기능 호환성 버전(fcv) "4.2" 이상에서는 인덱스 빌드 메모리 제한이 모든 인덱스 빌드에 적용됩니다.

인덱스 빌드는 인덱스 생성 과 같은 사용자 명령이나 초기 동기화 와 같은 관리 프로세스를 통해 시작할 수 있습니다. 둘 다 maxIndexBuildMemoryUsageMegabytes 에서 설정한 한도의 적용을 받습니다.

초기 동기화 은 한 번에 하나의 collection만 채우며 메모리 제한을 초과할 위험이 없습니다. 그러나 사용자가 여러 데이터베이스의 여러 collection에 대한 인덱스 빌드를 동시에 시작하면 maxIndexBuildMemoryUsageMegabytes 에 설정된 제한보다 많은 양의 메모리를 사용할 수 있습니다.

팁

인덱스 빌드가 복제본 세트와 복제본 세트 샤드가 포함된 샤딩된 클러스터에 미치는 영향을 최소화하려면 복제본 세트의 롤링 인덱스 빌드에 설명된 롤링 인덱스 빌드 절차를 사용합니다.

데이터 정렬 및 인덱스 유형

다음 인덱스 유형은 단순 이진 비교만 지원하며 데이터 정렬은 지원하지 않습니다:

• 텍스트 인덱스,

• 2D 인덱스 및

• geoHaystack 인덱스.

팁

단순 데이터 정렬이 아닌 collection에 text, 2d 또는 geoHaystack 인덱스를 만들려면 인덱스를 만들 때 {collation: {locale: "simple"} } 을 명시적으로 지정해야 합니다.

Hidden Indexes

• _id 색인을 숨길 수 없습니다.

• 숨겨진 인덱스에는 hint()를 사용할 수 없습니다.

정렬

최대 정렬 키 수

• 최대 32개의 키를 기준으로 정렬할 수 있습니다.

• 중복 필드가 포함된 정렬 패턴을 제공하면 오류가 발생합니다.

데이터

제한된 컬렉션의 최대 문서 수

create의 max 매개 변수를 사용하여 제한 컬렉션의 최대 문서 수를 지정하는 경우 이 값은 문서 수 2 ³¹개보다 작아야 합니다.

제한된 컬렉션을 생성할 때 최대 문서 수를 지정하지 않으면 문서 수에 제한이 없습니다.

복제본 세트

복제본 세트의 멤버 수입니다.

복제본 세트에는 최대 50명의 구성원이 포함될 수 있습니다.

복제본 세트의 투표 구성원 수

복제본 세트에는 최대 7명의 투표 멤버가 있을 수 있습니다. 총 복제본 세트가 7명을 초과하는 멤버로 구성된 경우 투표권이 없는 멤버를 참조하세요.

자동 생성되는 Oplog의 최대 크기

oplog 크기를 명시적으로 지정하지 않으면(예: oplogSizeMB 또는 --oplogSize로) MongoDB는 50기가바이트 이하의 oplog를 생성합니다. [4]

[4]	2}가 삭제되는 것을 방지하기 위해 oplog가 구성된 크기 제한을 초과하여 커질 수 majority commit point 있습니다.

샤딩된 클러스터

샤딩된 클러스터에는 여기에 설명된 제한 사항과 임계값이 있습니다.

운영

정렬 작업

MongoDB가 인덱스 또는 인덱스를 사용하여 정렬을 순서대로 가져올 수 없는 경우, MongoDB는 데이터에 대해 차단 정렬 작업을 수행해야 합니다. 이름은 SORT 단계에서 출력 문서를 반환하기 전에 모든 입력 문서를 읽고 해당 쿼리에 대한 데이터 흐름을 차단해야 한다는 요구 사항을 나타냅니다.

MongoDB에서 차단 정렬 작업에 100메가바이트 이상의 시스템 메모리를 사용해야 하는 경우 쿼리에서 cursor.allowDiskUse()를 지정하지 않는 한 MongoDB는 오류를 반환합니다. allowDiskUse()는 MongoDB가 차단 정렬 작업을 처리하는 동안 디스크의 임시 파일을 사용하여 100메가바이트 시스템 메모리 제한을 초과하는 데이터를 저장하도록 허용합니다.

정렬 및 인덱스 사용에 대한 자세한 내용은 정렬 및 인덱스 사용을 참조하세요.

집계 파이프라인 단계

MongoDB는 단일 파이프라인에서 허용되는 집계 파이프라인 단계 수를 1000 로 제한합니다.

집계 파이프라인이 구문 분석 전후에 단계 제한을 초과하면 오류가 발생합니다.

집계 파이프라인 메모리

MongoDB 6.0부터 allowDiskUseByDefault 매개변수는 실행에 100메가바이트 이상의 메모리가 필요한 파이프라인 단계에서 기본적으로 디스크에 임시 파일 쓰기를 수행할지 여부를 제어합니다.

• allowDiskUseByDefault를 true로 설정하면 실행하는 데 100메가바이트 이상의 메모리가 필요한 파이프라인 단계에서는 기본적으로 임시 파일을 디스크에 씁니다. { allowDiskUse: false } 옵션을 사용하여 특정 find 또는 aggregate 명령에 대해 디스크에 임시 파일 쓰기를 비활성화할 수 있습니다.

• allowDiskUseByDefault를 false로 설정하면 실행하는 데 100메가바이트 이상의 메모리가 필요한 파이프라인 단계는 기본적으로 오류가 발생합니다. { allowDiskUse: true } 옵션을 사용하여 특정 find 또는 aggregate에 대한 임시 파일을 디스크에 쓸 수 있도록 설정할 수 있습니다.

$search 집계 단계는 별도의 프로세스에서 실행되므로 100 메가바이트의 RAM으로 제한되지 않습니다.

허용 디스크 사용이 true일 때 디스크에 임시 파일을 쓸 수 있는 단계의 예시는 다음과 같습니다.

• $bucket

• $bucketAuto

• $group

• $setWindowFields

• $sort 인덱스에서 정렬 작업을 지원하지 않는 경우

• $sortByCount

참고

파이프라인 단계는 각 파이프라인 단계가 문서를 가져와 처리한 다음 결과 문서를 출력하는 문서 스트림에서 작동합니다.

일부 단계에서는 들어오는 문서를 모두 처리할 때까지 문서를 출력할 수 없습니다. 이러한 파이프라인 단계는 들어오는 모든 문서가 처리될 때까지 단계 출력을 RAM에 보관해야 합니다. 따라서 이러한 파이프라인 단계에는 100MB 제한보다 더 많은 공간이 필요할 수 있습니다.

$sort 파이프라인 단계 중 하나의 결과가 한도를 초과하는 경우 $limit 단계를 추가하는 것을 고려하세요.

프로파일러 로그 메시지 및 진단 로그 메시지에는 메모리 제한으로 인해 집계 단계에서 임시 파일에 데이터를 쓴 경우 usedDisk 표시기가 포함됩니다.

집계 및 읽기 관심사

• $out 단계는 읽기 고려 "linearizable"와 함께 사용할 수 없습니다. 즉, db.collection.aggregate()에서 "linearizable" 읽기 고려를 지정할 경우 파이프라인에 $out 단계를 포함할 수 없습니다.

• $merge 단계는 읽기 고려 "linearizable"와 함께 사용할 수 없습니다. 즉, db.collection.aggregate()에 대해 "linearizable"의 읽기 고려를 지정하면 파이프라인에 $merge 단계를 포함할 수 없습니다.

2D 지리 공간적 쿼리에서는 $or 연산자를 사용할 수 없습니다.

팁

참조:

• $or

• 2d 인덱스 내부

지리공간 쿼리

구형 쿼리의 경우 2dsphere 인덱스 결과를 사용합니다.

구형 쿼리에 2d 인덱스를 사용하면 극점을 감싸는 구형 쿼리에 2d 인덱스를 사용하는 것처럼 잘못된 결과가 발생할 수 있습니다.

지리 공간적 좌표

• 유효한 경도 값은 -180~180입니다(둘 모두 포함).

• 유효한 위도 값은 -90~90입니다(둘 모두 포함).

GeoJSON 다각형의 면적

$geoIntersects 또는 $geoWithin 의 경우, 면적이 단일 반구보다 큰 단일 고리 다각형을 지정하는 경우 the custom MongoDB coordinate reference system in the $geometry 표현식을 포함하십시오. 그렇지 않으면 $geoIntersects 또는 $geoWithin 가 보완 도형을 쿼리합니다. 반구보다 큰 면적을 가진 다른 모든 GeoJSON 다각형의 경우 $geoIntersects 또는 $geoWithin 이 보완 도형을 쿼리합니다.

다중 문서 트랜잭션

다중 문서 트랜잭션의 경우:

• 트랜잭션에서 컬렉션과 인덱스를 생성할 수 있습니다. 자세한 내용은 트랜잭션에서 컬렉션 및 인덱스 생성하기를 참조하세요

• 트랜잭션에 사용되는 컬렉션은 서로 다른 데이터베이스에 있을 수 있습니다.

  참고

  샤드 간 쓰기 트랜잭션에서는 새 컬렉션을 생성할 수 없습니다. 예를 들어, 하나의 샤드에서 기존 컬렉션에 쓰고 다른 샤드에서 암시적으로 새 컬렉션을 생성하는 경우, MongoDB는 동일한 트랜잭션에서 두 작업을 모두 수행할 수 없습니다.

• 제한된 컬렉션에는 쓸 (write) 수 없습니다.

• 고정 사이즈 컬렉션에서 읽을 때는 읽기 고려 "snapshot"을 사용할 수 없습니다. (MongoDB 5.0부터 도입됨)

• config, admin 또는 local 데이터베이스의 컬렉션을 읽고 쓸 수 없습니다.

• system.* 컬렉션에 쓸 수 없습니다.

• explain 또는 이와 유사한 명령을 사용하여 지원되는 작업의 쿼리 계획을 반환할 수 없습니다.

• 트랜잭션 외부에서 생성된 커서의 경우 트랜잭션 내부에서 getMore을(를) 호출할 수 없습니다.

• 트랜잭션에서 생성된 커서의 경우 트랜잭션 외부에서 getMore를 호출할 수 없습니다.

• 명령을 트랜잭션 의 killCursors 첫 번째 작업으로 지정할 수 없습니다.

  또한 트랜잭션 내에서 killCursors 명령을 실행 하면 서버 가 지정된 커서를 즉시 중지합니다. 트랜잭션 이 커밋 될 때까지 기다리지 않습니다.

트랜잭션에서 허용되지 않는 작업은 다음과 같습니다.

• 다중 샤드 쓰기 트랜잭션에서 새로운 컬렉션을 생성하기. 예를 들어 하나의 샤드에서 기존 컬렉션에 쓰고 다른 샤드에 암시적으로 컬렉션을 생성하는 경우 MongoDB는 동일한 트랜잭션에서 두 작업을 모두 수행할 수 없습니다.

• 컬렉션(예: db.createCollection() 메서드) 및 인덱스(예: db.collection.createIndexes() 및 db.collection.createIndex() 메서드)의 생성을 "local" 이외의 읽기 고려 수준을 사용하는 경우 명시합니다.

• listCollections 2} 및 명령과 해당 도우미 메서드.listIndexes

• createUser, getParameter, count 등과 해당 헬퍼와 같은 기타 비 CRUD 및 비 정보 작업입니다.

거래에는 transactionLifetimeLimitSeconds에 명시된 바와 같이 평생 제한이 있습니다. 기본값은 60초입니다.

쓰기 명령 배치 제한 크기

100,000 서버에 대한 단일 요청으로 정의된 단일 배치 작업에서 쓰기가 허용됩니다.

mongosh의 Bulk() 작업과 드라이버의 유사한 메서드에는 이러한 제한이 없습니다.

조회수

보기 정의 pipeline에는 $out 또는 $merge 단계를 포함할 수 없습니다. 이 제한은 $lookup 단계 또는 $facet 단계에서 사용되는 파이프라인과 같은 임베디드 파이프라인에도 적용됩니다.

보기에는 다음과 같은 작업 제한이 있습니다.

• 보기는 읽기 전용입니다.

• 뷰의 이름은 바꿀 수 없습니다.

• 뷰에 대한 find() 작업은 다음 프로젝션 연산자를 지원하지 않습니다.

  • $

  • $elemMatch

  • $slice

  • $meta

• 보기는 $text을(를) 지원하지 않습니다.

• 뷰는 맵 축소 작업을 지원하지 않습니다.

프로젝션 제한 사항

$-접두사 필드 경로 제한

find() 및 findAndModify() 프로젝션은 DBRef 필드를 제외하고 $(으)로 시작하는 필드를 프로젝션할 수 없습니다. 예를 들어 다음 작업은 유효하지 않습니다.

db.inventory.find( {}, { "$instock.warehouse": 0, "$item": 0, "detail.$price": 1 } )

$ 위치 연산자 배치 제한

$ 프로젝션 연산자는 필드 경로 끝에만 나타날 수 있습니다(예: "field.$" 또는 "fieldA.fieldB.$"). 예를 들어 다음 작업은 유효하지 않습니다.

db.inventory.find( { }, { "instock.$.qty": 1 } )

이 문제를 해결하려면 $ 투영 연산자 뒤에 오는 필드 경로의 구성요소를 제거합니다.

빈 필드 이름 프로젝션 제한

find() 및 findAndModify() 프로젝션에는 빈 필드 이름의 프로젝션이 포함될 수 없습니다. 예를 들어 다음 작업은 유효하지 않습니다.

db.inventory.find( { }, { "": 0 } )

이전 버전에서 MongoDB는 빈 필드의 포함/제외를 존재하지 않는 필드의 프로젝션과 동일하게 처리합니다.

경로 충돌: 내장된 문서 및 해당 필드

내장된 문서의 어떤 필드로도 내장된 문서를 프로젝션할 수 없습니다. 예를 들어, size 필드가 내장된 문서가 있는 컬렉션 inventory를 생각해 보세요.

{ ..., size: { h: 10, w: 15.25, uom: "cm" }, ... }

다음 작업은 size 문서와 size.uom 필드를 모두 프로젝트하려고 하기 때문에 실패하며 Path collision 오류를 반환합니다.

db.inventory.find( {}, { size: 1, "size.uom": 1 } )

이전 버전에서는 내장된 문서와 해당 필드 사이의 마지막 프로젝션이 프로젝션을 결정합니다.

• 내장된 문서의 프로젝션이 해당 필드의 모든 프로젝션 다음에 오는 경우 MongoDB는 내장된 문서를 프로젝트합니다. 예를 들어 프로젝션 문서 { "size.uom": 1, size: 1 }은 프로젝션 문서 { size: 1 }과 동일한 결과를 생성합니다.

• 내장된 문서의 프로젝션이 해당 필드의 프로젝션보다 먼저 오면 MongoDB는 지정된 필드를 프로젝트합니다. 예를 들어 프로젝션 문서 { "size.uom": 1, size: 1, "size.h": 1 }은 프로젝션 문서 { "size.uom": 1, "size.h": 1 }과 동일한 결과를 생성합니다.

경로 충돌: 배열 및 포함된 필드의 $slice 충돌

find() 및 findAndModify() 프로젝션은 배열의 $slice 및 배열에 포함된 필드를 모두 포함할 수 없습니다. 예를 들어 배열 필드 instock을 포함하는 컬렉션 inventory를 생각해 보겠습니다.

{ ..., instock: [ { warehouse: "A", qty: 35 }, { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ], ... }

Path collision 오류와 함께 다음 작업이 실패합니다.

db.inventory.find( {}, { "instock": { $slice: 1 }, "instock.warehouse": 0 } )

이전 버전에서 프로젝션은 두 프로젝션을 모두 적용하고 instock 배열의 첫 번째 요소($slice: 1)를 반환하지만 프로젝션된 요소에서 warehouse 필드를 억제합니다. MongoDB 4.4부터는 동일한 결과를 얻으려면 $project 로 구성된 db.collection.aggregate() 메서드를 사용하십시오.

$ 위치 연산자 및 $slice 제한

find() 및 findAndModify() 프로젝션은 $ 프로젝션 표현식의 일부로 $slice 프로젝션 표현식을 포함할 수 없습니다. 예를 들어 다음 연산은 유효하지 않습니다.

db.inventory.find( { "instock.qty": { $gt: 25 } }, { "instock.$": { $slice: 1 } } )

이전 버전에서 MongoDB는 쿼리 조건과 일치하는 instock 배열의 첫 번째 요소 (instock.$)를 반환합니다. 즉, 위치 프로젝션 "instock.$" 이(가) 우선하고 $slice:1 은(는) 작동하지 않습니다. "instock.$": { $slice: 1 } 은(는) 다른 문서 필드를 제외하지 않습니다.

세션

세션 및 $external 사용자 이름 제한

2} 인증 사용자(Kerberos, LDAP 또는 x.509 사용자)와 함께 클라이언트 세션 및 인과적 일관성 보장을 사용하려면 사용자 이름이 10KB보다 클 수 없습니다. $external

세션 유휴 시간 초과

30분 동안 읽기 또는 쓰기 작업이 없거나 이 임계값 내에서 refreshSessions를 사용하여 새로 고쳐지지 않는 세션은 만료된 것으로 표시되며 언제든지 MongoDB 서버에서 닫을 수 있습니다. 세션을 닫으면 진행 중인 모든 작업이 종료되고 세션과 연결된 커서가 열립니다. 여기에는 noCursorTimeout() 또는 30분보다 큰 maxTimeMS()로 구성된 커서가 포함됩니다.

db.collection.find()를 발행하는 애플리케이션을 고려하십시오. 서버는 find()의 cursor.batchSize()로 정의된 문서 일괄 처리와 함께 커서를 반환합니다. 애플리케이션이 서버에서 새로운 문서 배치를 요청할 때마다 세션이 새로 고쳐집니다. 그러나 애플리케이션이 현재 문서 배치를 처리하는 데 30분 이상 소요되면 세션이 만료되고 닫힌 것으로 표시됩니다. 애플리케이션이 다음 문서 배치를 요청하면 세션이 닫힐 때 커서가 종료되므로 서버는 오류를 반환합니다.

커서를 반환하는 작업의 경우 커서가 30분 이상 유휴 상태일 수 있는 경우 Mongo.startSession()를 사용하여 명시적 세션 내에서 작업을 실행하고 refreshSessions 명령을 사용하여 세션을 주기적으로 새로 고칩니다. 예시:

var session = db.getMongo().startSession()
var sessionId = session
sessionId  // show the sessionId
var cursor = session.getDatabase("examples").getCollection("data").find().noCursorTimeout()
var refreshTimestamp = new Date() // take note of time at operation start
while (cursor.hasNext()) {
  // Check if more than 5 minutes have passed since the last refresh
  if ( (new Date()-refreshTimestamp)/1000 > 300 ) {
    print("refreshing session")
    db.adminCommand({"refreshSessions" : [sessionId]})
    refreshTimestamp = new Date()
  }
  // process cursor normally
}

예시 작업에서 db.collection.find() 메서드는 명시적 세션과 연결됩니다. 커서는 유휴 상태일 때 서버가 커서를 닫는 것을 방지하기 위해 noCursorTimeout()으로 구성됩니다. while 루프에는 refreshSessions를 사용하여 5분마다 세션을 새로 고치는 블록이 포함되어 있습니다. 세션은 30분의 유휴 시간 제한을 초과하지 않으므로 커서는 무기한 열린 상태로 유지될 수 있습니다.

MongoDB 드라이버의 경우, 세션 생성에 대한 지침과 구문은 드라이버 설명서를 참조하세요.