경고
과거 릴리스 제한 사항
아래의 중요 경고는 일부 이전 mongosync
버전에 영향을 미칩니다. 사용 가능한 최신 패치 출시하다 로 업그레이드합니다.
이슈 | 영향을 받는 버전 |
---|---|
| 1.5.0 - 1.7.1 |
| 1.1.0 - 1.7.1 |
패치 릴리스
1.7.3 릴리스
6월 4, 2024
수정된 문제:
v1.0.0 에 도입된 버그 수정 mongosync가 커밋된 후 대상에 누락되거나 추가 인덱스가 있을 수 있습니다. 이는 드문 경우입니다.
v1.0.0 에 도입된 버그 수정 여기서 mongosync는 문서의 변경 이벤트를 놓칠 수 있습니다. 이는 대상 서버 버전이 MongoDB 5.0 이하인 경우에만 발생할 수 있는 드문 경우입니다.
v1.7.0 에 도입된 버그가 수정되었으며, 이로 인해 소스 및 대상 고정 사이즈 컬렉션 간에 크기 불일치가 발생할 수 있습니다. 이는 다음 조건이 모두 충족되는 경우에만 마이그레이션에 영향을 줄 수 있습니다.
소스 클러스터가 MongoDB 6.0 이전 버전입니다.
대상 클러스터는 MongoDB 7.0 이상입니다.
마이그레이션 중에 고정 사이즈 컬렉션의 크기가 수정되었습니다.
v1.0.0 에 도입된 버그 수정 여기서 mongosync는
modify
변경 이벤트에서changeStreamPreAndPostImages
필드를 무시했습니다. 이로 인해 대상 컬렉션이 소스 컬렉션과 비교하여 이 필드에 대해 다른 값을 가질 수 있습니다. 이제 mongosync가 이 필드를 올바르게 처리합니다.v1.0.0 에 도입된 버그로, mongosync가 중단되었다가 재개될 때 변경 이벤트가 누락될 수 있습니다. 이는 드문 경우입니다.
기타 변경 사항:
동기화 작업을 다시 시작하고 다시 시작할 때 2분 지연이 추가됩니다.
제한 사항:
마이그레이션의 전체 수명 동안 소스 및 대상 샤드 클러스터 모두에서 밸런서를 중지해야 합니다. 밸런서가 아직 실행 중인 상태에서 mongosync를 시작하려고 하면 오류가 발생합니다.
대상 클러스터에서
moveChunk
또는moveRange
명령을 실행하지 않아야 합니다. 소스 클러스터에서 이러한 명령을 실행하려고 하면 mongosync에서 오류가 발생합니다.mongosync는
primary
읽기 설정을 사용하여 대상 클러스터에서 읽습니다. 다른 읽기 설정으로 mongosync를 시작하려고 하면 오류가 발생합니다.
1.7.2 릴리스
4월 4, 2024
수정된 문제:
v1.5.0 에 도입된 버그 수정 여기서 mongosync는 oplog 롤오버 복원력 메커니즘을 비활성화하여 지연된 세컨더리 노드 에서 문서를 읽을 때 변경 이벤트를 놓칠 수 있습니다.
v1.1.0 에 도입된 버그 수정 소스 클러스터 가 샤딩되고 소스 밸런서 가 활성화된 경우 샤딩된 는 초기 복사 단계에서 실행 읽기 읽기 중에 문서 복사를 놓칠 수 있습니다.
v1.5.0 에 도입된 버그가 수정되었으며, 이로 인해 초기 컬렉션 복사 단계에서 mongosync가 종료되거나 일시 중지된 후 다시 시작될 때 데이터 불일치가 발생할 수 있습니다.
이는 다음과 같은 경우에만 마이그레이션에 영향을 줄 수 있습니다.
마이그레이션에 혼합 _id 유형이 포함되며 대상 클러스터는 MongoDB 4.4 이하 버전을 실행합니다.
마이그레이션에는 고정 사이즈 컬렉션이 포함되며 대상 클러스터는 MongoDB 6.0 이상을 실행합니다.
v1.0.0 에 도입된 버그 수정 여기서 인덱스는 마이그레이션 중에 소스 클러스터 에서 삭제된 대상 클러스터 에 생성될 수 있습니다.
이는 mongosync가 실행 동안 지정된 인덱스 가 생성되고 삭제되는 마이그레이션에만 영향을 미칠 수 있습니다.
v1.0.0 에 도입된 버그가 수정되었으며, 이로 인해 대상 클러스터 에 잘못된 유형, 옵션 또는 인덱스로 컬렉션이 생성될 수 있습니다.
이는 mongosync가 실행 중이고 소스 또는 대상 클러스터가 MongoDB 6.0.0 을 6.0.12 또는 MongoDB 7.0.0 또는 7 로 실행하는 동안 컬렉션이 삭제되거나 이름이 변경된 마이그레이션에만 영향을 미칠 수 있습니다.0.3.
소스 클러스터 의 샤드 키 인덱스가 " 배경" 인덱스 빌드 옵션에 대해 샤드 간에 일관되지 않은 값을 가질 경우 mongosync 충돌을 일으킬 수 있는 v1.1.0 에 도입된 버그를 수정했습니다.
이는 MongoDB 6.0 보다 오래된 샤딩된 컬렉션 및 소스 클러스터를 포함하는 마이그레이션에만 영향을 미칠 수 있습니다.
기타 변경 사항:
oplog 롤오버 복원력 메커니즘을 비활성화합니다.
mongosync 1.7.2 으로의 실시간 업그레이드 는 허용되지 않습니다.
mongosync API 의 지연 시간 을 줄입니다.
제한 사항:
mongosync는
primary
읽기 설정 (read preference) 을 사용하여 소스 클러스터 에서 읽어야 합니다. 다른 읽기 설정 (read preference) 으로 mongosync를 시작하려고 하면 오류가 발생합니다.샤딩된 가 컬렉션 복사 단계를 완료할 때까지 샤드 소스 클러스터 에서 밸런서 를 중지해야 합니다. 밸런서 가 아직 실행 상태에서 mongosync를 시작하려고 하면 오류가 발생합니다.
소스 클러스터 에서
moveChunk
또는moveRange
명령을 실행 하지 않아야 합니다. 이러한 항목이 소스 클러스터 에서 실행 되면 mongosync에서 오류가 발생합니다.
1.7.1 릴리스
2023년 11월 9일
수정된 문제:
버전 1.6에서 실시간 업그레이드를 시도할 때 mongosync가 충돌하는 버그를 수정했습니다. 이 버그로 인해 사용자 데이터가 수정되지 않으며 버전 1.7.1을 사용하여 동기화가 계속되는 것을 방지하지 않습니다.
1.7.0 릴리스
2023년 10월 18일
라이브 업그레이드
mongosync
1.7.0 부터 시작, 데이터 동기화 작업을 처음부터 다시 시작하지 않고도 mongosync
를 업그레이드 할 수 있습니다. mongosync
1 에서는 mongosync
1.7.3 이상으로만 실시간 업그레이드 할 수 있습니다.7.2 또는 그 이후 버전.
자세한 내용은 라이브 업그레이드를 참조하세요.
서로 다른 MongoDB Server cluster 간 데이터 동기화
1.7.0 부터 시작, mongosync
는 특정 하위 버전 소스 클러스터에서 상위 버전 대상 클러스터로 버전 마이그레이션을 수행할 수 있습니다.
버전 간 마이그레이션은6.0 이전 버전에서 마이그레이션할 때 추가 준비와 구성이 필요합니다. 릴리스. 6.0 이전 버전에서 버전 간 마이그레이션을 수행하려면 mongosync
을(를) 사용하는 MongoDB Server 버전인 경우, 전문 서비스에 대해 문의 하려면 계정 팀에 문의하세요.
기타 참고 사항
새로운 기능:
mongosync
이제 1,024자를 초과하는 기록된 필드를 잘라냅니다.
수정된 문제:
ORR이 고정 사이즈 컬렉션 문서를 순서대로 삽입하지 못하게 할 수 있는
mongosync
1.5.0에 도입된 버그를 수정했습니다. 즉, 소스 클러스터와 대상 클러스터의 문서는 고정 사이즈 컬렉션에서 동일한 순서로 삭제될 수 없습니다. 이 버그는 마이그레이션 중, 컬렉션 복사 단계가 동일한 고정 사이즈 컬렉션에서 작업하는 동안 또는 그 이전에 문서가 고정 사이즈 컬렉션에 삽입되는 경우에만 발생합니다.사용자가 제외 필터만 지정하고 완전히 제외된 데이터베이스가 없는 경우 초기화 중에
mongosync
가 실패하는 1.6에 도입된 버그가 수정되었습니다.
최소 지원 버전
1.7.3 에서 지원되는 최소 MongoDB 버전은 6.0.13 및 7.0.6 입니다.
최상의 성능을 위해 마이그레이션 하기 전에 소스 및 대상 클러스터를 최신 MongoDB Server 패치 출시하다 로 업그레이드 하세요. 자세한 내용 은 MongoDB 의 최신 자체 관리 패치 릴리스로 업그레이드를 참조하세요.