reverse

説明

コミットされた同期操作の方向を逆にします。

以下に例を挙げます。

• COMMITTED同期操作があります。

• cluster0 がソースで、 cluster1が宛先です。

• 同期操作がCOMMITTED後、新しい書込み (write) は宛先クラスターでのみ発生します。 ソースクラスターは新しい書込み (write) を受け入れません。

このシナリオでは、 reverseエンドポイントを使用して、 cluster1からcluster0への書込み（write）を同期できます。これには、 mongosyncがcanWrite=trueに達した後にcluster1で発生した書込みも含まれます。 同期中にcanWriteステータスを確認するには、 /progressエンドポイントを使用します。

reverseエンドポイントの使用に関する詳細とチュートリアルについては、「 逆同期方向 」を参照してください。

要件

reverseエンドポイントを使用するには:

• mongosync 最初の同期を開始するときに構成する必要があります。 /start API エンドポイントの呼び出しでは、以下を設定する必要があります。

  • reversible 次の行動をします: true

  • enableUserWriteBlocking "sourceAndDestination" に設定されている場合にのみ使用できます。

同期の開始後に、これらのオプションを更新することはできません。

• mongosync はCOMMITTED状態である必要があります。

• 宛先クラスターの oplog は、 mongosyncがcanWrite=trueに達してから/reverseリクエストの受信までの間、ロールオーバーされないようにする必要があります。

• ソースクラスターと宛先クラスターは同じ数のシャードを持つ必要があります。 クラスターのトポロジーまたはメジャー バージョンが異なる場合、逆同期はできません。

• mongosync接続文字列で指定されたユーザーには、ソースクラスターと宛先クラスターで必要な権限が必要です。 権限は、書込みブロック設定を変更するか、逆同期を使用するかによって、環境によって異なります。

 db.<collection>.aggregate( [
   { $collStats: { storageStats: { } } },
   { $project: { "storageStats.indexDetails.<field_name>.metadata.formatVersion": 1 } }
 ] )

[
  {
    storageStats: {
      indexDetails: { <field_name>: { metadata: { formatVersion: 14 } } }
    }
  }
]

リクエスト

POST /api/v1/reverse

応答

例

次の例では、コミットされた同期操作の方向を逆にします。

curl localhost:27182/api/v1/reverse -XPOST --data '{ }'

{"success":true}

動作

reverse エンドポイントにより REVERSING 状態が開始されます。 mongosync はソースクラスターと宛先クラスターをスワップし、変更イベントの適用を再開します。

reverseの同期が成功すると、 mongosyncはRUNNING状態になります。 同期は、元の同期ジョブとは逆方向に続行されます。 元のデータをコピーするために、同期プロセス全体を再起動する必要はありません。

ソースクラスターと宛先クラスターの同期のマッピング方向を表示するには、進行状況エンドポイントを使用し、 directionMappingオブジェクトを確認します。