mongosync
바이너리는 정품이 아닌 MongoDB 배포서버에서의 사용에 대해 지원되거나 테스트되지 않습니다. 도구는 이러한 배포에서 작동할 수 있지만 호환성이 보장되지는 않습니다.정의
mongosync
바이너리는 Mongosync에서 사용되는 프라이머리 프로세스 입니다. mongosync
는 동기화 완료할 때까지 소스 클러스터 에서 대상 클러스터 로 데이터를 마이그레이션합니다.
mongosync
프로세스 개요는 mongosync
정보를 참조하세요.
mongosync
사용을 시작하려면 퀵 스타트 가이드를 참조하세요.
자주 묻는 질문(FAQ) 페이지에서는 사용자가 mongosync
에 대해 자주 묻는 질문에 대한 답변을 제공합니다.
호환성
버전 호환성 요구 사항에 대한 자세한 내용은 MongoDB Server 버전 호환성을 참조하세요.
mongosync
복제본 세트와 샤딩된 클러스터를 지원합니다.독립형 MongoDB 인스턴스는 지원되지 않습니다. Mongosync를사용하기 전에 독립형 인스턴스 복제본 세트 로 변환합니다.
mongosync
Atlas 샤딩된 클러스터 또는 서버리스 인스턴스를 지원하지 않습니다.전체 제한 사항 목록은 Mongosync 제한 사항을 참조하세요.
구문
아래의 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
재구성을 참조하세요.자세한 내용은 구성 파일을 참조하세요.
--disableMetricsLogging
버전 1.16.0에 추가 되었습니다.
Mongosync 바이너리를 실행 때 지표 로깅을 비활성화합니다.
경고: 효과적인 문제 해결 및 지원 용이하게 하려면 지표 로깅을 활성화된 상태로 유지하는 것이 좋습니다.
자세한 내용은 Mongosync 지표를 참조하세요.
구성 파일에서
--disableMetricsLogging
옵션을 설정하려면disableMetricsLogging
설정을 참조하십시오.
--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>
로그 디렉토리 경로를 설정합니다. Mongosync는 이 디렉토리 의 파일에 로그를 씁니다.
자세한 내용은 로깅을 참조하세요.
구성 파일에서
--logPath
옵션을 설정하려면logPath
설정을 참조하십시오.마이그레이션 중 로그 디렉토리 경로를 변경하려면 동기화 중
mongosync
재구성을 참조하세요.참고
--logPath
옵션으로mongosync
를 시작하는 경우mongosync
프로세스에USR1
신호를 보내 로그 파일을 회전할 수 있습니다.kill -s USR1 $mongosync_pid $mongosync_pid
mongosync
프로세스 ID입니다.
--metricsLoggingFilepath <directory>
버전 1.16.0에 추가 되었습니다.
지표 로그 디렉토리 경로를 설정합니다. Mongosync는 이 디렉토리 의 파일에 지표 로그를 기록합니다.
자세한 내용은 Mongosync 지표를 참조하세요.
구성 파일에서
--metricsLoggingFilepath
옵션을 설정하려면metricsLoggingFilepath
설정을 참조하십시오.
--port
기본값:
27182
Mongosync HTTP API 에 HTTP 서버 가 사용하는 포트를 설정합니다.
구성 파일에서
--port
옵션을 설정하려면port
설정을 참조하십시오.마이그레이션 중 포트를 변경하려면 동기화 중
mongosync
재구성을 참조하세요.
--verbosity <level>
기본값:
DEBUG
로그 메시지에 사용할 상세도 수준을 설정합니다. Mongosync는 지정된 수준의 모든 메시지와 하위 수준의 모든 메시지를 기록합니다.
--verbosity
옵션은 다음 값을 지원합니다.TRACE
DEBUG
INFO
WARN
ERROR
FATAL
PANIC
구성 파일에서
--verbosity
옵션을 설정하려면verbosity
설정을 참조하십시오.마이그레이션 중 상세 수준을 변경하려면 동기화 중
mongosync
재구성을 참조하세요.
행동
자세한 내용은 mongosync
동작을 참조하세요.