mongosync 유틸리티는 MongoDB 클러스터 간에 연결을 생성합니다. mongosync 는 다음 클러스터 중 하나에 연결할 수 있습니다.
MongoDB Atlas 호스팅 클러스터
자체 관리형 클러스터 및 Atlas 호스팅 클러스터
이 페이지에서는 MongoDB Mongosync를 사용하여 자체 관리 클러스터 Atlas cluster 에 연결하는 방법에 대해 설명합니다.
Atlas 클러스터 연결에 대한 자세한 내용은 데이터베이스 배포서버에 연결참조하세요.
참고
최상의 성능을 위해 자체 관리형 클러스터 에서 마이그레이션 하기 전에 최신 MongoDB Server 패치 출시하다 로 업그레이드 하세요. 자세한 내용 은 MongoDB 의 최신 자체 관리 패치 릴리스로 업그레이드를 참조하세요.
연결 문자열
mongosync MongoDB URI 연결 string 을 사용하여 자체 관리형 클러스터를 연결합니다.
SRV 연결 체계의 형식은 다음과 같습니다.
mongodb+srv://[username:password@][host.domain.TLD][/defaultauthdb][?options] 표준 URI 연결 체계의 형식은 다음과 같습니다.
mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
복제본 세트 구성에 나열된 것과 동일한 방식으로 mongod 인스턴스의 호스트 이름을 지정합니다.
샤딩된 클러스터 의 경우 mongod 인스턴스 대신 인스턴스의 호스트 이름을 지정합니다.mongos
참고
mongosync replicaSet 옵션이 필요하지 않습니다.
mongosync 소스 및 대상 클러스터에 연결하려면 primary 읽기 설정이 필요합니다. 자세한 내용은 읽기 기본 설정 옵션을 참조하세요.
mongosync MongoDB URI 연결 string 을 사용하여 Atlas 클러스터를 연결합니다.
SRV 연결 체계의 형식은 다음과 같습니다.
mongodb+srv://[username:password]@[clusterName].[host].mongodb.net/ 에서 SRV 연결 을 찾는 방법에 대한 자세한 string Atlas 내용은 클러스터에 연결을 참조하세요.
표준 URI 연결 체계의 형식은 다음과 같습니다.
mongodb://[username:password]@[clusterName].[host].mongodb.net/
mongosync 소스 및 대상 클러스터에 연결하려면 primary 읽기 설정이 필요합니다. 자세한 내용은 읽기 기본 설정 옵션을 참조하세요.
인증
유효한 인증 을 제공하여 MongoDB Atlas 클러스터 에 연결합니다. 아직 Atlas 데이터베이스 사용자가 없는 경우 사용자를 만들어야 합니다.
소스 또는 대상 cluster에 인증이 필요한 경우 mongosync 호출할 때 올바른 자격 증명을 제공해야 합니다.
역할
mongosync 연결 문자열 에 지정된 사용자에게는 소스 및 대상 클러스터에 대한 필수 권한이 있어야 합니다. 권한은 환경과 쓰기 차단 설정을 수정하려는지 또는 역 동기화 사용하려는지 여부에 따라 달라집니다.
소스 클러스터 에 대한 자체 관리형 권한은 다음과 같습니다.
동기화 유형 | 필수 소스 권한 |
|---|---|
기본값 | |
이중 쓰기 차단 | |
반전 | |
다중 반전 |
서버 역할에 대한 자세한 내용 은 자체 관리 배포서버의 역할 기반 액세스 제어를 참조하세요.
사용자 권한을 업데이트 하려면 grantRolesToUser 를 참조하세요.
대상 클러스터 에 대한 Atlas 권한은 다음과 같습니다.
동기화 유형 | 필수 대상 권한 |
|---|---|
기본값 |
|
이중 쓰기 차단, 반전 또는 다중 반전 |
|
Atlas 역할에 대한 자세한 내용은 기본 제공 역할 및 권한을 참조하세요.
Atlas user 권한을 업데이트 하려면 프로젝트에 대한 액세스 관리를 참조하세요.
행동
호스팅
mongosync 유틸리티는 소스 또는 대상 클러스터 에 가까운 자체 hardware 에서 호스팅할 수 있습니다. 클러스터 의 mongod 또는 mongos 인스턴스 중 하나와 동일한 서버 에서 호스팅될 필요는 없습니다. 이러한 유연성 덕분에 대상 클러스터에서 실행 mongod 또는 mongos 인스턴스에 영향 을 최소화하면서 데이터를 대상 클러스터 로 푸시하거나 풀링할 수 있습니다.
초기 상태
mongosync 가 연결되면 IDLE 상태가 됩니다. 동기화를 시작하려면 시작 명령을 실행해야 합니다.
제한 사항
M10+ Atlas 클러스터를 사용하여 mongosync를 실행하기 전에 Require Indexes for All Queries 옵션을 비활성화합니다.
예시
연결 정보 수집
소스 클러스터cluster0 은(는) 다음 서버 및 포트에서 호스팅됩니다.
clusterOne01.fancyCorp.com:20020clusterOne02.fancyCorp.com:20020clusterOne03.fancyCorp.com:20020
대상 Atlas 클러스터 cluster1 는 다음 서버 및 포트에서 호스팅됩니다.
cluster2Name-01.abc123.com:27017cluster2Name-02.abc123.com:27017cluster2Name-03.abc123.com:27017
관리 사용자 clusterAdmin 가 각 cluster에 superSecret 비밀번호로 구성되어 있습니다.
소스 및 대상 cluster 연결 mongosync
자체 관리형 클러스터 의 일반 연결 string 형식은 다음과 같습니다.
mongodb://<user>:<password>@<ip-address>:<port>,<ip-address>:<port>,<ip-address>:<port>
클러스터 의 일반 연결 string 형식은 Atlas 다음과 같습니다.
mongodb://<user>:<password>@<clusterName>.<hostname>.mongodb.net/
자체 관리형 클러스터에 대해 수집한 연결 정보를 사용하여 cluster0 에 대한 연결 문자열을 만듭니다.
cluster0: mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020
클러스터 에 대한 연결 은 string Atlas Atlas UI 에서 가져올 수 있습니다. 학습 내용 은 데이터베이스 배포에 연결을 참조하세요.
아래의 mongosync 명령 레이아웃은 표시되도록 수정되었습니다. mongosync 을 사용하여 cluster0 를 cluster1 에 연결하려면 다음 명령을 한 줄에 입력합니다.
mongosync \ --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020" \ --cluster1 "mongodb://clusterAdmin:superSecret@cluster2Name.abc123.mongodb.net"
Atlas 클러스터에는 TLS 연결이 필요합니다. Atlas 클러스터에서 mongosync를 사용하려면 tls=true 옵션을 추가합니다. 예를 들어, cluster0 및 cluster1의 admin 데이터베이스에 연결하려면 다음을 수행하세요.
mongosync \ --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020/admin?tls=true" \ --cluster1 "mongodb://clusterAdmin:superSecret@cluster2Name.abc123.mongodb.net/admin?tls=true"
mongodb+srv 연결 문자열을 mongosync 와 함께 사용할 수도 있습니다. 연결 에 옵션을 tls=true 추가할 필요가 mongodb+srv string 없습니다. 예를 예시 다음과 같습니다.
mongosync \ --cluster0 "mongodb+srv://clusterAdmin:superSecret@clusterOne01.fancyCorp.com/" \ --cluster1 "mongodb+srv://clusterAdmin:superSecret@cluster2Name.abc123.mongodb.net/"
mongodb+srv 연결 문자열에 대한 자세한 내용은 SRV 연결 형식을 참조하세요.