mongosync
mongosync
바이너리는 정품이 아닌 MongoDB 배포서버에서의 사용에 대해 지원되거나 테스트되지 않습니다. 도구는 이러한 배포에서 작동할 수 있지만 호환성이 보장되지는 않습니다.정의
mongosync
바이너리는 Cluster-to-Cluster Sync에 사용되는 프라이머리 프로세스입니다. mongosync
는 소스 클러스터에서 대상 클러스터로 데이터를 마이그레이션하고 사용자가 동기화를 완료할 때까지 클러스터를 지속적으로 동기화합니다. 지속적인 데이터 동기화 외에도 mongosync
를 사용하면 클러스터 간 일회성 데이터 마이그레이션을 수행할 수 있습니다.
mongosync
프로세스 개요는 mongosync
정보를 참조하세요.
mongosync
사용을 시작하려면 퀵 스타트 가이드를 참조하세요.
자주 묻는 질문(FAQ) 페이지에서는 사용자가 mongosync
에 대해 자주 묻는 질문에 대한 답변을 제공합니다.
호환성
MongoDB의 지원되는 최소 서버 버전은 6.0.17 및 7.0.13입니다.
MongoDB 버전이 6.0 미만인 클러스터(소스)의 데이터를 Atlas 클러스터(대상)로 마이그레이션할 수 있습니다. 하위 버전의 클러스터에서 마이그레이션하려면 하위 버전의 클러스터에서 추가 준비 및 구성이 필요합니다. 전문 서비스에 대해 문의하려면 계정 팀에 문의하세요.
mongosync
복제본 세트와 샤딩된 클러스터를 지원합니다.독립형 MongoDB 인스턴스는 지원되지 않습니다. Cluster-to-Cluster Sync를 사용하기 전에 독립형 인스턴스를 복제본 세트로 변환합니다.
mongosync
Atlas 샤딩된 클러스터 또는 서버리스 인스턴스를 지원하지 않습니다.제한 사항 전체 목록은 Cluster-to-Cluster Sync 제한 사항을 참조하세요.
구문
아래의 mongosync
명령 레이아웃은 표시되도록 수정되었습니다. mongosync
을 사용하여 cluster0
를 cluster1
에 연결하려면 다음 명령을 한 줄에 입력합니다.
mongosync \ --cluster0 "<cluster0_connection_string>" \ --cluster1 "<cluster1_connection_string>"
연결 문자열의 형식을 지정하는 방법에 대한 자세한 내용은 mongosync
연결을 참조하세요.
명령줄 옵션
명령줄을 사용하여 다음 mongosync
옵션을 구성할 수 있습니다.
설정 파일에서 mongosync
를 구성하려면 설정 파일을 참조하세요.
글로벌 옵션
--acceptDisclaimer
내장된검증자에 대한 면책조항에 동의합니다.
이 옵션 없이
mongosync
프로세스 시작되면 각 고지 사항을 수락하라는 메시지가 표시됩니다.이 옵션을 사용하면 이미 고지 사항을 읽고 수락한 사용자가 고지 사항을 수락하고
mongosync
프로세스 시작할 수 있습니다.구성 파일에서
--acceptDisclaimer
옵션을 설정하려면acceptDisclaimer
설정을 참조하십시오.버전 1.9에 새로 추가되었습니다.
--cluster0 <uri>
첫 번째 클러스터에 대한 연결 URI를 설정합니다. 첫 번째 클러스터는 동기화 프로세스에서 소스 또는 대상 역할을 할 수 있습니다.
start
API 엔드포인트에 대한 호출에서 소스 및 대상 클러스터를 지정합니다.mongosync
연결에 대한 자세한 내용은 연결을 참조하세요.구성 파일에서
--cluster0
옵션을 설정하려면cluster0
설정을 참조하십시오.경고
일부 시스템에서는 연결 문자열에
--cluster0
또는--cluster1
옵션과 함께 비밀번호를 제공하면 다른 사용자가 호출할 수 있는ps
등의 시스템 상태 프로그램에 비밀번호가 표시될 수 있습니다.대신
--config
옵션을 사용하여 비밀번호가 포함된 구성 파일을 지정하는 것이 좋습니다.
--cluster1 <uri>
두 번째 클러스터에 대한 연결 URI를 설정합니다. 두 번째 클러스터는 동기화 프로세스에서 소스 또는 대상 역할을 할 수 있습니다.
start
API 엔드포인트에 대한 호출에서 소스 및 대상 클러스터를 지정합니다.mongosync
연결에 대한 자세한 내용은 연결을 참조하세요.구성 파일에서
--cluster1
옵션을 설정하려면cluster1
설정을 참조하십시오.경고
일부 시스템에서는 연결 문자열에
--cluster0
또는--cluster1
옵션과 함께 비밀번호를 제공하면 다른 사용자가 호출할 수 있는ps
등의 시스템 상태 프로그램에 비밀번호가 표시될 수 있습니다.대신
--config
옵션을 사용하여 비밀번호가 포함된 구성 파일을 지정하는 것이 좋습니다.
--config <filename>
구성 파일의 경로를 설정합니다.
마이그레이션 중 설정 파일 경로를 설정하려면 동기화 중
mongosync
재구성을 참조하세요.자세한 내용은 구성 파일을 참조하세요.
--disableTelemetry
버전 1.4.0에 추가되었습니다.
mongosync
에 대한 원격 분석 데이터 수집을 비활성화합니다.기본적으로
mongosync
는 MongoDB 제품을 개선하기 위해 익명의 애그리게이션된 사용 데이터를 수집합니다.mongosync
를 실행하면 이 원격 분석 데이터 수집을 사용하지 않도록 설정할 수 있습니다.구성 파일에서
--disableTelemetry
옵션을 설정하려면disableTelemetry
설정을 참조하십시오.마이그레이션 중 원격 분석 데이터 수집을 비활성화하려면 동기화 중
mongosync
재구성을 참조하세요.자세한 내용은 사용자 데이터 컬렉션을 참고하세요.
--disableVerification
내장된 검증 도구를 비활성화합니다. 비활성화하면
mongosync
는 마이그레이션 확인하지 않습니다. 다른 확인 방법은 데이터 전송 확인을 참조하세요.이 옵션은 확인과 함께
mongosync
를 실행 때 OOM 종료를 경험하고 더 많은 리소스를 할당할 수 없거나 확인 재시작을 허용하지 않는 고객을 위한 해결 방법을 제공합니다. 확인을 비활성화한 상태에서 마이그레이션 완료할 수 있습니다. 후속 재시작 및 되돌리기를 위해 인증은 비활성화된 상태로 유지됩니다.mongosync
이 처음 시작될 때는 이 옵션을 사용하면 안 됩니다. 대신 기본값 으로 확인이 활성화되어 있으므로 /start 요청 매개변수verification.enabled: false
을(를) 사용하여 확인을 비활성화합니다.설정 파일에서 검증을 비활성화하려면
disableVerification
설정을 참조하세요.버전 1.10에 추가 되었습니다.
--id <id>
mongosync
인스턴스의 식별자를 설정합니다샤딩된 클러스터에서 여러
mongosync
인스턴스를 실행할 때 이 옵션을 사용하여 샤드를 개별적으로 동기화합니다.이 옵션의 식별자 값은 동기화하는 샤드의 샤드 ID와 일치해야 합니다. 샤드 ID를 찾으려면
listShards
명령을 사용하세요.구성 파일에서
--id
옵션을 설정하려면id
설정을 참조하십시오.
--loadLevel <level>
유형: integer
기본값:
3
소스 클러스터와 대상 클러스터 간의 데이터 동기화를 위한 클러스터 워크로드 수준을 설정합니다.
4
가장 높은 설정, 클러스터 워크로드를 최대화하고 데이터를 가장 빠르게 동기화합니다.1
로 설정하면 클러스터 워크로드가 최소화되고 데이터 동기화 속도가 가장 느려집니다.
구성 파일에서
--loadLevel
옵션을 설정하려면loadLevel
설정을 참조하십시오.마이그레이션 중 로드 수준을 변경하려면 동기화 중
mongosync
재구성을 참조하세요.경고
loadLevel
을 기본값인3
보다 높게 설정하면 대상 클러스터 성능에 부정적인 영향을 줄 수 있습니다.소스 클러스터 에 읽기 병목 현상이 있거나 대상 클러스터 에 쓰기 (write) 병목 현상이 있는 경우
loadLevel
을(를) 낮추면 성능이 향상될 수 있습니다.버전 1.4에 새로 추가되었습니다.
--logPath <directory>
로그 디렉토리 경로를 설정합니다. Cluster-to-Cluster Sync는 이 디렉리의 파일에 로그를 씁니다.
자세한 내용은 로깅을 참조하세요.
구성 파일에서
--logPath
옵션을 설정하려면logPath
설정을 참조하십시오.마이그레이션 중 로그 디렉토리 경로를 변경하려면 동기화 중
mongosync
재구성을 참조하세요.참고
--logPath
옵션으로mongosync
를 시작하는 경우mongosync
프로세스에USR1
신호를 보내 로그 파일을 회전할 수 있습니다.kill -s USR1 $mongosync_pid $mongosync_pid
mongosync
프로세스 ID입니다.
--port
기본값:
27182
Cluster-to-Cluster Sync HTTP API에 HTTP 서버가 사용하는 포트를 설정합니다.
구성 파일에서
--port
옵션을 설정하려면port
설정을 참조하십시오.마이그레이션 중 포트를 변경하려면 동기화 중
mongosync
재구성을 참조하세요.
--verbosity <level>
기본값:
DEBUG
로그 메시지에 사용할 상세도 수준을 설정합니다.Cluster-to-Cluster Sync는 지정된 수준의 모든 메시지 및 더 낮은 수준의 메시지를 기록합니다.
--verbosity
옵션은 다음 값을 지원합니다.TRACE
DEBUG
INFO
WARN
ERROR
FATAL
PANIC
구성 파일에서
--verbosity
옵션을 설정하려면verbosity
설정을 참조하십시오.마이그레이션 중 상세 수준을 변경하려면 동기화 중
mongosync
재구성을 참조하세요.
행동
자세한 내용은 mongosync
동작을 참조하세요.