AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

mongosync 1.21릴리스 노트

이 페이지에서는 MongoDB Mongosync 1.21에 도입된 변경 사항과 새로운 기능에 대해 설명합니다.

6월 25, 2026

  • lag 객체를 /progress API 응답에 추가합니다. lag 객체는 동기화 지연을 overallLagSeconds, crudLagSeconds, ddlLagSeconds로 보고합니다. lagTimeSeconds 필드는 lag.overallLagSeconds로 대체되어 더 이상 사용되지 않습니다. 자세한 내용은 progress 를 참조하세요.
  • CEA(Change Event Application)동안 적용된 CRUD(생성, 읽기, 업데이트 및 삭제) 이벤트가 지표 및 추적 수준 로그 메시지에서 간혹 이중 계산되던 문제를 해결합니다.

  • 내장된 검증자가 정지되어 일부 컬렉션이 초기 해시잉 단계에 진입하지 못하고 커밋이 방해되는 문제를 해결합니다.

  • mongosync 이 샤딩된 클러스터의 남은 oplog 시간을 잘못되게 계산하여 estimatedOplogTimeRemaining 필드가 잘못되거나 /progress 응답에 잘못된 경고 메시지가 표시되는 문제를 해결합니다.

  • mongosync 이 시작된 후 /resume 를 너무 빠르게 호출하면 mongosync 가 충돌하는 문제가 해결됩니다. mongosyncPAUSED 상태에 도달하기 전에 /resume 를 호출하면 이제 오류가 반환됩니다.

  • canCommit mongosync 이거나 내장된 검증기가 30 초 이상의 지연을 보고할 때 false 입니다. canCommit 이(가) false 일 때 /commit 을(를) 호출하면 오류가 반환됩니다. 자세한 내용은 commitprogress 을(를) 참조하세요.

  • /progress API 응답에서 estimatedTotalBytesestimatedCopiedBytes 의 동작을 업데이트합니다. 컬렉션 복사 중 estimatedCopiedBytesestimatedTotalBytes 를 초과하면 mongosyncestimatedTotalBytesestimatedCopiedBytes과 같게 상승시킵니다. 컬렉션 복사 후 두 값은 같습니다. 자세한 내용은 progress 를 참조하세요.

  • 마이그레이션을 다시 시작할 때 mongosync 은 이제 마이그레이션이 시작된 이후 --cluster0--cluster1 연결 문자열이 변경되지 않았다는 사실을 확인합니다. 이 확인은 호스트 이름과 포트를 비교하여 소스 클러스터와 데스티네이션 클러스터가 우연히 바끼는 경우 잠재적인 데이터 손실을 방지합니다.

mongosync 1.21 로의 실시간 업그레이드는 지원되지 않습니다.

지원되는 최소 버전에 대한 자세한 내용은 MongoDB Server 버전 호환성을 참조하세요.

최상의 성능을 위해 마이그레이션 하기 전에 소스 및 대상 클러스터를 최신 MongoDB Server 패치 출시하다 로 업그레이드 하세요. 자세한 내용 은 MongoDB 의 최신 자체 관리 패치 릴리스로 업그레이드를 참조하세요.