MongoDB 4.4의 호환성 변경 사항

디렉토리 롤백

Mongo 4 부터 시작.4, 컬렉션의 롤백 디렉토리 이름은 컬렉션 네임스페이스가 아닌 컬렉션의 UUID를 따라 지정됩니다. 예:

<dbpath>/rollback/20f74796-d5ea-42f5-8c95-f79b39bad190/removed.2020-02-19T04-57-11.0.bson

자세한 내용은 데이터 롤백을 참조하세요.

replSetGetStatus 출력 필드 변경 사항

replSetGetStatus 명령과 해당 mongo 셸 헬퍼 rs.status() 는 출력에서 다음과 같은 더 이상 사용되지 않는 필드를 제거합니다.

복제본 구성 문서 변경 사항

MongoDB 4. 이(가)4 복제본 세트 구성 문서 term 에 필드를 추가합니다. 복제본 세트 멤버는 term 및 를 사용하여 version '최신' 복제본 구성에 대한 합의를 도출합니다.featureCompatibilityVersion (fCV) : "4.4" 를 수행하여 replSetReconfig term 구성 문서에 필드를 추가하고 새 구성이 대다수의 복제본 세트 멤버에게 전파될 때까지 차단합니다. 마찬가지로 로 fCV : "4.2" 다운그레이드하면 암시적으로 재구성을 수행하여 term 필드를 제거합니다.

작업에 대한 초기 동기화 제한

복제본 세트 멤버에서 다음 작업을 실행하려면 멤버가 PRIMARY 또는 SECONDARY 상태여야 합니다.

• listDatabases

• listCollections

• listIndexes

• distinct

• dbStats

• collStats

멤버가 다른 상태(예: STARTUP2)에 있는 경우 작업 오류가 발생합니다.

사용자 지정 getLastErrorDefaults 값이 더 이상 사용되지 않음

버전 4 부터 시작됩니다.4, MongoDB는 기본값인 { w: 1, wtimeout: 0 } 이외의 settings.getLastErrorDefaults 값을 지정하는 작업을 더 이상 지원하지 않습니다. MongoDB 4.4 은(는) 지정한 모든 쓰기 고려 값을 준수하지만, 향후 MongoDB 버전에서는 기본값 이외의 값을 적용하지 않을 수 있습니다. 대신 setDefaultRWConcern 명령을 사용하여 복제본 세트 또는 샤드 클러스터에 대한 기본 읽기 또는 쓰기 고려 구성을 설정합니다.

필드를 새 값으로 설정

MongoDB 4 부터 시작.4, find 및 findAndModify() 프로젝션은 애그리게이션 표현식과 애그리게이션 구문을 사용할 수 있습니다.

리터럴 및 애그리게이션 변수 사용을 포함한 애그리게이션 표현식 및 구문을 사용할 때 프로젝션 필드 값에 리터럴(숫자 또는 부울 제외)을 지정하면 필드가 새 값으로 프로젝션됩니다.

예를 들어 status 필드가 포함된 문서가 있는 컬렉션 인벤토리를 가정해 보겠습니다.

db.inventory.insertOne( { _id: 1, item: "postcard", status: "A", instock: [ { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ] })

MongoDB부터 4.4, 다음 작업은 status 및 instock 필드를 현재 값 대신 새 값으로 프로젝션합니다.

db.inventory.find(
   { status: "A" },
   { status: "Active", instock: ["blue", "crimson"] }
)

즉, 이 작업은 다음 문서를 반환합니다.

{ "_id" : 1, "status" : "Active", "instock" : [ "blue", "crimson" ] }

이전 버전에서는 모든 사양 값(0/거짓 값 또는 이전에 지원되지 않는 문서 값 제외)이 true 로 처리되어 현재 값과 함께 필드가 포함되었음을 나타냅니다. 즉, 이전 버전에서는 이전 작업이 status 및 instock 필드가 현재 값과 함께 포함된 문서를 반환합니다.

{ "_id" : 1, "status" : "A", "instock" : [ { "warehouse" : "B", "qty" : 15 }, { "warehouse" : "C", "qty" : 35 } ] }

$elemMatch 프로젝션 필드 순서

문서의 필드 순서에 관계없이 기존 필드의 $elemMatch 프로젝션은 다른 기존 필드 포함 이후에 필드를 반환합니다.

예를 들어 players 다음 문서가 있는 컬렉션을 생각해 보겠습니다.

db.players.insertOne( {
   name: "player1",
   games: [ { game: "abc", score: 8 }, { game: "xyz", score: 5 } ],
   joined: new Date("2020-01-01"),
   lastLogin: new Date("2020-05-01")
} )

다음 프로젝션은 문서에서 필드가 joined 및 lastLogin 필드 앞에 나열되어 있더라도 프로젝션에 포함된 다른 기존 필드 뒤에 games 필드를 반환합니다.

db.players.find( {}, { games: { $elemMatch: { score: { $gt: 5 } } }, joined: 1, lastLogin: 1 } )

즉, 이 작업은 다음 문서를 반환합니다.

{
   "_id" : ObjectId("5edef64a1c099fff6b033977"),
   "joined" : ISODate("2020-01-01T00:00:00Z"),
   "lastLogin" : ISODate("2020-05-01T00:00:00Z"),
   "games" : [ { "game" : "abc", "score" : 8 } ]
}

버전 4.2 이하에서는 기존 필드의 $elemMatch 프로젝션이 문서의 순서를 유지합니다.

{
  "_id" : ObjectId("5edef91e76ddff7d92f118e1"),
  "games" : [ { "game" : "abc", "score" : 8 } ],
  "joined" : ISODate("2020-01-01T00:00:00Z"),
  "lastLogin" : ISODate("2020-05-01T00:00:00Z")
}

$slice 임베디드 배열

중첩된 문서에서 배열의 $slice 프로젝션이 프로젝션이 포함 프로젝션의 일부인 경우 중첩된 문서의 다른 필드를 더 이상 반환하지 않습니다.

예를 들어,inventory size 필드가 포함된 문서가 있는 collection을 고려해 보십시오.

{ item: "socks", qty: 100, details: { colors: [ "blue", "red" ], sizes: [ "S", "M", "L"] } }

다음 작업은 colors 배열의 지정된 슬라이스만 사용하여 _id 필드(기본값), qty 필드 및 details 필드를 프로젝트합니다.

db.inventory.find( { }, { qty: 1, "details.colors": { $slice: 1 } } )

즉, 이 작업은 다음 문서를 반환합니다.

{ "_id" : ObjectId("5ee92a6ec644acb6d13eedb1"), "qty" : 100, "details" : { "colors" : [ "blue" ] } }

$slice 프로젝션이 제외 프로젝션의 일부인 경우 작업은 중첩된 문서의 다른 필드를 계속 반환합니다. 즉, 다음 프로젝션은 제외 프로젝션입니다. 프로젝션은 _id 필드와 지정된 슬라이스 외부에 있고 다른 모든 필드를 반환하는 colors 배열의 요소를 제외합니다.

db.inventory.find( { }, { _id: 0, "details.colors": { $slice: 1 } } )

{ "item" : "socks", "qty" : 100, "details" : { "colors" : [ "blue" ], "sizes" : [ "S", "M", "L" ] } }

$slice 프로젝션 자체는 제외로 간주됩니다.

이전 버전에서는 $slice 프로젝션이 포함 여부에 관계없이 중첩된 문서의 다른 필드도 프로젝션에 포함되었습니다.

경로 충돌 제한

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

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

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

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

$-접두사 필드 경로 제한

찾기 및 findAndModify() 프로젝트는 DBRef 필드를 제외하고 $ 로 시작하는 필드를 프로젝트할 수 없습니다.

예를 들어 다음 작업은 유효하지 않습니다.

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

$ 위치 연산자 배치 제한

$ 프로젝션 연산자는 필드 경로의 끝에만 나타날 수 있습니다(예: "field.$" 또는 "fieldA.fieldB.$".

예를 들어 다음 작업은 유효하지 않습니다.

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

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

$ 위치 연산자 및 $slice 제한

찾기 및 findAndModify() 프로젝션은 $slice 프로젝션 표현식을 $ 프로젝션 표현식의 일부로 포함할 수 없습니다.

예를 들어 다음 작업은 유효하지 않습니다.

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

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

빈 필드 이름 프로젝션 제한

찾기 및 findAndModify() 프로젝션은 빈 필드 이름의 프로젝션을 포함할 수 없습니다.

예를 들어 다음 작업은 유효하지 않습니다.

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

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

텍스트 검색 메타데이터 { $meta: "textScore" } 쿼리 요구 사항

MongoDB 부터 4 시작.4 인 경우, 프로젝션 또는 $text 정렬에서 표현식을 사용하려면 연산의 쿼리 술어에 연산자를 db.collection.find() { $meta: "textScore" } 지정해야 합니다. 예를 들면 다음과 같습니다.

db.articles.find(
   { $text: { $search: "cake" } },
   { score: { $meta: "textScore" } }
);
db.articles.find(
   { $text: { $search: "cake" } },
   { score: { $meta: "textScore" } }
).sort( { score: {  $meta: "textScore" } } );

쿼리 조건자에 $text 연산자를 지정하지 않으면 작업이 실패합니다. 예를 들어, 다음 작업은 MongoDB 4 부터 유효하지 않습니다.4:

db.articles.find(
   { },
   { score: { $meta: "textScore" } }
)
db.articles.find(
   { },
   { score: { $meta: "textScore" } }
).sort( { score: {  $meta: "textScore" } } );

단일 값을 포함하는 키 줄이기

MongoDB 4 부터 시작.4 mapReduce 명령을 실행하면 MongoDB는 연결된 키에 포함된 값의 수에 관계없이 reduce 함수를 호출합니다.

이전 버전에서는 MongoDB가 단일 값을 가진 키에 대해 reduce 함수를 호출하지 않았습니다.

자세한 내용은 사용법을 참조하세요.

맵-출력 변경 감소

MongoDB 4 부터 시작.4, mapReduce 는 출력에서 counts 필드를 제거합니다.

이전 버전에서는 명령 출력에 counts 필드가 포함되었습니다. 예를 들면 다음과 같습니다.

"counts" : {
   "input" : 4,
   "emit" : 4,
   "reduce" : 1,
   "output" : 2
},

맵 함수의 방출 제한

MongoDB 4 부터 시작.4, map 함수는 더 이상 각 emit() 출력의 크기를 MongoDB의 최대 BSON 문서 크기의 절반으로 제한하지 않습니다.

이전 버전에서는 단일 방출이 MongoDB의 최대 BSON 문서 크기의 절반만 저장할 수 있습니다.

범위가 있는 BSON 유형 JavaScript 코드에 대한 지원 제거

mapReduce 는 함수에 대해 사용되지 않는 BSON Type JavaScript 코드(BSON Type 15)를 더 이상 지원하지 않습니다. map, reduce 및 finalize 함수는 BSON type string (BSON type 2) 또는 BSON type JavaScript (BSON type 13) 중 하나여야 합니다. map, reduce 및 finalize 함수에서 액세스할 수 있는 상수 값을 전달하려면 scope 매개변수를 사용합니다.

2} 함수에 범위가 있는 JavaScript 코드를 사용하는 mapReduce 것은 버전 4.2.1부터 더 이상 사용되지 않습니다.

rs getLog 값 제거

MongoDB 부터 4 4시작. , 명령은 getLog 이 rs 메시지 유형 분류가 더 이상 사용되지 않으므로 더 이상 값을 허용하지 않습니다. 대신 이제 로그 메시지는 복제 메시지의 경우 REPL 을 포함하여 항상 해당 구성 요소 로 식별됩니다.

구성 요소 필드를 필터링하는 로그 구문 분석 예제는 구성 요소별 필터링을 참조하세요.

타임스탬프 형식

구조화된 JSON 로깅으로 전환하면서 ctime 타임스탬프 형식은 더 이상 지원되지 않습니다. 다음 구성 옵션은 더 이상 ctime 을 유효한 매개 변수로 허용하지 않습니다.

• systemLog.timeStampFormat

• mongod --timeStampFormat

• mongos --timeStampFormat

대신 iso8601-local (기본값) 또는 iso8601-utc 타임스탬프 형식을 사용합니다.

maxLogSizeKB 매개변수

구조화된 JSON 로깅으로 전환하면서 maxLogSizeKB 서버 매개변수가 지정된 제한을 초과하는 로그 항목의 개별 속성을 모두 잘라냅니다. 이전에는 이 매개변수가 전체 로그 항목을 잘라냈습니다.

또한:

• 이제 maxLogSizeKB 는 잘림을 완전히 비활성화하는 0 값을 허용합니다.

• maxLogSizeKB 더 이상 음수 값을 허용하지 않습니다.

자세한 내용은 로그 메시지 잘라내기를 참조하십시오.

db.collection.validate() 매개 변수 변경

mongo 메서드 db.collection.validate() 는 더 이상 부울 매개변수만 허용하지 않습니다.

즉, 메서드는 더 이상 db.collection.validate({full: <boolean>}) 의 약어로 db.collection.validate(<boolean>) 을 허용하지 않습니다.

다음에 대한 전체 유효성 검사 oplog

MongoDB 4 부터 시작.4, WiredTiger에 대한 oplog 에 대한 전체 유효성 검사는 더 철저한 검사를 건너뜁니다. validate.warnings 에는 동작에 대한 알림이 포함되어 있습니다.

MMAPv1 정리

• dbStats 명령이 더 이상 사용되지 않는 MMAPv1 numExtents 필드를 반환하지 않습니다.

• replSetGetStatus 명령은 더 이상 출력에 더 이상 사용되지 않는 MMAPv1 필드 replSetGetStatus.initialSyncStatus.fetchedMissingDocs 를 반환하지 않습니다.

• fsync 명령은 더 이상 사용되지 않는 MMAPv1 필드 async 를 옵션으로 허용하지 않습니다.

지원 중단