4.4의 샤딩된 클러스터를 4.2로 다운그레이드

1. 네임스페이스 길이

MongoDB 4.4부터 시작됩니다:

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

다운그레이드하기 전에 기능 호환성 버전(fCV) 4.2의 120바이트 네임스페이스 길이 제한을 초과하는 네임스페이스가 있는 모든 컬렉션 또는 뷰를 해결합니다.

네임스페이스가 120바이트 제한을 초과하는 collection이나 뷰가 있는지 확인하려면 mongo shell을 mongos 인스턴스에 연결하고 다음을 실행합니다.

db.adminCommand("listDatabases").databases.forEach(function(d){
   let mdb = db.getSiblingDB(d.name);
   mdb.getCollectionInfos( ).forEach(function(c){
      namespace = d.name + "." + c.name
      namespacelenBytes =  encodeURIComponent(namespace).length
      if (namespacelenBytes > 120) {
         print (c.type.toUpperCase() + " namespace exceeds 120 bytes:: " + namespace )
      }
   } )
})

collection 또는 뷰 네임스페이스가 120바이트를 초과하는 경우 FCV를 다운그레이드하기 전에 을(를) 사용합니다.

• 샤딩되지 않은 collection의 경우 renameCollection 명령을 사용하여 collection 이름을 변경합니다.

• 샤드 collection의 경우:

  • $merge 를 사용하여 더 짧은 이름의 새 샤드 collection에 매핑한 다음 원래 collection을 삭제합니다.

  • mongoexport 및 mongoimport 를 사용하여 더 짧은 이름의 새 컬렉션에 만든 다음 원본 컬렉션을 삭제합니다.

• 뷰의 경우 db.createView() 를 사용하여 더 짧은 이름을 사용하여 뷰를 다시 만든 다음 원래 뷰를 삭제합니다.

2. 기능 호환성 버전(fCV) 다운그레이드

샤드 cluster의 featureCompatibilityVersion 를 다운그레이드하려면 다음을 수행합니다.

1. mongo 셸을 mongos 인스턴스에 연결합니다.

2. featureCompatibilityVersion을 "4.2"로 다운그레이드합니다.

   db.adminCommand({setFeatureCompatibilityVersion: "4.2"})

   setFeatureCompatibilityVersion 명령은 내부 시스템 컬렉션에 대한 쓰기를 수행하며 멱등원입니다. 어떤 이유로든 명령이 성공적으로 완료되지 않으면 mongos 인스턴스에서 명령을 다시 시도합니다.

   참고

   setFeatureCompatibilityVersion 가 샤드 클러스터에서 실행되는 동안 청크 마이그레이션, 분할 및 병합이 ConflictingOperationInProgress 실패할 수 있습니다.

3. 샤딩된 cluster의 모든 멤버가 업데이트된 featureCompatibilityVersion 을 반영하도록 하려면 각 shard 복제본 세트 멤버와 각 config 서버 복제본 세트 멤버에 연결하여 featureCompatibilityVersion 을 확인합니다.

   팁

   액세스 제어가 활성화된 샤드 클러스터의 경우, 샤드 복제본 세트 멤버에 대해 다음 명령을 실행하려면 샤드 로컬 사용자로 멤버에 연결해야 합니다.

   db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

   모든 멤버는 다음을 포함하는 결과를 반환해야 합니다.

   "featureCompatibilityVersion" : { "version" : "4.2" }

   멤버가 "4.4" 의 featureCompatibilityVersion 를 반환하는 경우 계속하기 전에 멤버가 버전 "4.2" 를 반영할 때까지 기다립니다.

반환된 featureCompatibilityVersion 값에 대한 자세한 내용은 FeatureCompatibilityVersion 가져오기를 참조하세요.

3. fCV 4.4 영구 기능 제거

다음 단계는 fCV가 "4.4"로 설정된 적이 있는 경우에만 필요합니다.

4.2와 호환되지 않는 영구적인 4.4 기능 을 모두 제거합니다. 여기에는 다음이 포함됩니다:

복합 해시 인덱스

모든 복합 해시 인덱스를 제거합니다.

collection에서 복합 해시 인덱스를 식별하려면 db.collection.getIndexes() 를 사용하고 해당 인덱스를 제거하려면 db.collection.dropIndex() 를 사용합니다.

복합 해시 인덱스를 사용하여 collection을 샤딩하는 경우 아래 Compound Hashed Shard Keys 에 나열된 지침을 따르세요.

복합 해시 샤드 키

해시 샤드 키를 사용하여 샤딩된 모든 collection을 제거합니다.

sh.status() 를 사용하여 복합 해시 샤드 키가 있는 샤딩된 collection을 식별하고 해당 collection을 제거합니다.

• collection이 비어 있거나 collection에 보존이 필요한 데이터가 포함되어 있는 경우 db.collection.drop() 를 사용하여 collection을 삭제합니다.

• collection에 보존해야 하는 데이터가 있는 경우 를 사용하여 collection을 삭제하기 전에 db.collection.drop() 먼저 collection을 백업합니다. cluster를 다운그레이드한 후 데이터를 cluster로 복원합니다.

4. 4.4 기능 제거

4.4 기능을 사용하는 모든 영구 기능을 제거합니다. 여기에는 다음이 포함되지만 이에 국한되지는 않습니다.

• $unionWith 또는 $function 와 같이 4.4 연산자를 포함하는 뷰 정의가 있는 경우 새 애그리게이션 연산자도 참조하세요.

• Unhide 또는 drop 의 숨겨진 인덱스.

5. 누락된 샤드 키 업데이트

MongoDB 4.4에서는 샤드 컬렉션의 문서에서 샤드 키 필드가 누락 될 수 있습니다.

4.2로 다운그레이드하고 샤딩된 collection에 shard key 필드가 누락된 문서가 포함된 경우, 4.2 mongos 인스턴스는 shard key 필드가 누락된 문서를 반환하지 않습니다. 이러한 상황을 방지하려면 다운그레이드하기 전에 누락된 샤드 키 필드를 포함하도록 문서를 업데이트합니다.

샤드 키의 일부가 누락된 문서를 찾으려면 $exists 연산자를 사용합니다.

예를 들어 contacts 컬렉션에 샤드 키 { zipcode: 1 } 가 있는 경우 zipcode 필드가 없는 문서를 찾습니다.

db.contacts.find( { zipcode: { $exists: false } } )

이러한 문서에 대해 누락된 샤드 키 필드를 null 로 설정하려면 db.collection.updateMany() 메서드를 사용할 수 있습니다.

db.contacts.updateMany( { zipcode: { $exists: false } }, { $set: { zipcode: null } } )

누락된 샤드 키 필드를null 이 아닌 값으로 설정하는 경우 db.collection.updateMany() 메서드를 사용할 수 없으며 트랜잭션 내에서 또는 재시도 가능 쓰기로 업데이트를 수행해야 합니다. 자세한 내용은 누락된 샤드 키 필드 설정을 참조하세요.

6. 512바이트를 초과하는 샤드 키 업데이트

샤드 cluster 다운그레이드

sh.stopBalancer()

sh.getBalancerState()

sh.startBalancer()