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/false 값 또는 이전에 지원되지 않는 문서 값 제외)이 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 } ]
}

$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 프로젝션이 포함인지 제외인지에 관계없이 중첩된 문서의 다른 필드도 프로젝션에 포함되었습니다.

경로 콜리전 제한(Path Collision Restrictions)

{ ..., 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 연산자 및 제한

find 및 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부터 프로젝션 또는 정렬에서 { $meta: "textScore" } 표현식을 사용하려면 db.collection.find() 작업의 쿼리 조건자에 $text 연산자를 지정해야 합니다. 예를 들면 다음과 같습니다.

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 명령을 실행하면 연결된 키에 포함된 값의 수에 관계없이 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 유형 JavaScript 코드(BSON 유형 15)를 지원하지 않습니다. map, reduce, finalize 함수는 BSON types 문자열(BSON Type 2) 또는 BSON types JavaScript(BSON Type 13) 중 하나여야 합니다. map, reduce, finalize 함수에서 액세스할 수 있는 상수 값을 전달하려면 scope 매개 변수를 사용합니다.

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

getLog 값제거 rs

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에는 동작에 대한 알림이 포함되어 있습니다.

MapV1 정리

• dbStats 명령은 더는 사용하지 않는 MMAPv1 필드 numExtents를 출력에 반환하지 않습니다.

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

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

지원 중단