start

상태

start 엔드포인트를 사용하려면 mongosync 이 IDLE 상태에 있어야 합니다.

사용자 쓰기 차단

enableUserWriteBlocking 을 설정하려면 mongosync 사용자에게 setUserWriteBlockMode 및 bypassWriteBlockingMode 작업 유형을 포함하는 역할이 있어야 합니다.

mongosync 사용자에 대한 사용자 지정 역할을 설정하려면 다음을 수행합니다.

1. 사용자 지정 역할을 만들려면 createRole 명령을 사용합니다.

   db.adminCommand( {
      createRole: "reverseSync",
      privileges: [ {
          resource: { db: "", collection: "" },
          actions: [ "setUserWriteBlockMode", "bypassWriteBlockingMode" ]
      } ],
      roles: []
   } )

2. mongosync 사용자에게 사용자 지정 역할을 부여하려면 grantRolesToUser 명령을 사용합니다.

   db.adminCommand( {
      grantRolesToUser: "mongosync-user",
      roles: [ { role: "reverseSync", db: "admin" } ]
   } )

mongosync 을(를) 시작할 때 cluster0 또는 cluster1 설정에 대한 연결 문자열에서 구성된 이 mongosync 사용자를 사용해야 합니다.

요청 본문 매개변수

샤딩 매개변수

복제본 세트에서 shard cluster로 동기화하려면 대상 cluster에서 collection을 샤딩하는 sharding 옵션을 설정합니다.

sharding 옵션에는 다음과 같은 매개 변수가 있습니다.

mongosync 복제본 세트에서 샤드 클러스터로 동기화할 때 sharding 옵션이 설정되어 있지 않으면 오류가 발생합니다. 옵션이 다른 구성과 함께 설정된 경우mongosync 에서도 오류가 발생합니다.sharding

요청

curl localhost:27182/api/v1/start -XPOST \
--data '
   {
      "source": "cluster0",
      "destination": "cluster1"
   } '

응답

{"success":true}

요청

curl localhost:27182/api/v1/start -XPOST \
--data '
   {
      "source": "cluster0",
      "destination": "cluster1",
      "reversible": true,
      "enableUserWriteBlocking": true
   } '

응답

{"success":true}

요청

curl -X POST "http://localhost:27182/api/v1/start" --data '
   {
      "source": "cluster0",
      "destination": "cluster1",
      "includeNamespaces": [
         {
             "database": "sales",
             "collectionsRegex": {
                "pattern": "^accounts_.+$",
                "options": "i"
             }
         }, {
            "database": "marketing"
         }
      ]
   } '

응답

{"success":true}

요청

curl localhost:27182/api/v1/start -XPOST \
--data '
   {
      "source": "cluster0",
      "destination": "cluster1",
      "sharding": {
         "createSupportingIndexes": true,
         "shardingEntries": [
            {
                "database": "accounts",
                "collection": "us_east",
                "shardCollection": {
                   "key": [
                      { "location": 1 },
                      { "region": 1 },
                   ]
                }
            }
         ]
      }
   } '

응답

{"success":true}

상태

start 요청이 성공하면 mongosync 은(는) RUNNING 상태가 됩니다.

사전 분할 청크

mongosync 가 cluster와 동기화되면 대상 cluster에서 sharded collection에 대한 청크를 미리 분할합니다. 이는 다음 구성에서 지원됩니다:

• 복제본 세트에서 샤드 cluster로 동기화합니다.

• 샤드 수가 다른 샤드 클러스터를 동기화합니다.

샤드 복제본 세트

복제본 세트에서 샤드 클러스터로 동기화하려면 sharding 옵션이 필요합니다. 이 옵션은 mongosync 가 collection을 샤딩하는 방법을 구성합니다.

sharding.shardEntries 배열은 샤딩할 collection을 지정합니다. 이 배열에 나열되지 않은 컬렉션은 비샤드 컬렉션으로 복제됩니다.

지원 인덱스

mongosync 소스 클러스터의 인덱스를 대상 클러스터로 동기화합니다. 그러나 복제본 세트에서 샤드 cluster로 동기화할 때 mongosync 에는 소스 클러스터에 존재하지 않을 수 있는 샤드 키를 지원하기 위해 추가 인덱스가 필요할 수 있습니다.

mongosync 동기화 중에 샤드 collection에 대한 지원 인덱스를 생성할 수 있습니다. 이 작업은 sharding.createSupportingIndexes 옵션을 설정하면 됩니다.

sharding.createSupportingIndexes 이 false 인 경우(기본값):

• sharding.shardEntries 옵션에 제공하는 각 샤드 키에는 소스 cluster에 기존 인덱스가 있어야 합니다.

• collection에서 다른 데이터 정렬을 사용하는 경우 샤드 키에 사용되는 인덱스 중 하나에 단순 데이터 정렬이 있어야 합니다.

• 샤드 키의 고유 인덱스를 사용하려면 소스 클러스터에 인덱스를 생성할 때 고유성을 지정해야 합니다.

• 소스 클러스터의 고유 인덱스가 대상 cluster에서 요청된 샤드 키와 호환되지 않는 경우, 예를 들어 요청된 샤드 키가 대상의 접두사로 포함되지 않은 소스 클러스터의 고유 인덱스로 인해 mongosync 오류가 발생할 수 있습니다.

sharding.createSupportingIndexes 이 true 인 경우:

• 소스 클러스터에 지원 인덱스가 있는 경우 mongosync 는 인덱스를 대상 클러스터에 동기화하고 샤드 키로 사용합니다.

• 지원 인덱스가 없는 경우 mongosync 가 대상 cluster에 인덱스를 생성합니다.

sharding.createSupportingIndexes 옵션은 모든 샤드 collection에 영향을 줍니다.

동기화 중 이름 변경

복제본 세트에서 cluster로 동기화할 때 sharding.shardEntries 배열에 나열된 collection은 대상 cluster에서 샤드 collection이 됩니다.

start 를 호출한 후 mongosync 가 컬렉션 복사를 시작하기 전에 소스 클러스터에서 컬렉션 이름을 변경(예: renameCollection 명령 사용)하면 대상에서 컬렉션 샤딩을 차단할 수 있습니다.

collection 이름을 변경하는 것이 progress 안전한지 확인하려면 엔드포인트를 호출하고 collectionCopy.estimatedCopiedBytes 반환 문서에서 필드 값을 확인합니다.

• 값이 0이면 mongosync 이 collection 복사를 시작하지 않았음을 나타냅니다.

  이 점에서 collection 이름을 변경하면 소스에 이름 변경이 적용되기 전에 복사로의 전환이 발생할 수 있으므로 대상 cluster에 collection이 샤딩되지 않은 상태로 남을 수 있습니다.

• 0보다 큰 값은 mongosync 에서 복사를 시작했음을 나타냅니다. 이 점부터 collection의 이름을 변경해도 이벤트가 발생한 경우에도 대상 cluster에서 해당 샤딩을 차단하지 않습니다.

필수 인덱스

buildIndexes 옵션을 never 로 설정하여 /start 를 호출하면 mongosync 가 불필요한 인덱스 작성을 건너뜁니다.

항상 빌드되는 인덱스는 다음과 같습니다.

• mongosync 복사하는 모든 collection의 _id 필드에 인덱스를 빌드합니다.

• mongosync 커밋 후 제거되는 각 샤드 collection의 샤드 키를 지원하는더미 인덱스를 빌드합니다. buildIndexes 을 never 로 설정하면 mongosync 는 커밋 후에도 이 인덱스를 유지합니다.

엔드포인트 보호

mongosync start 엔드포인트를 보호하지 않습니다. 그러나 기본적으로 API는 로컬 호스트에만 바인딩되며 다른 소스의 호출은 허용하지 않습니다. 또한 start 호출은 연결 자격 증명이나 사용자 데이터를 노출하지 않습니다.