Docs Menu
Docs Home
/
MongoDB Cluster-to-Cluster Sync
/

mongosync

項目一覧

  • 定義
  • 互換性
  • 構文
  • コマンドライン オプション
  • グローバル オプション
  • 動作
  • 詳細

mongosync バイナリーは、Cluster-to-Cluster Sync で使用されるプライマリ プロセスです。mongosync は、あるクラスターから別のクラスターにデータを移行し、クラスターを継続的に同期させることができます。

mongosync を使用すると、本番環境をミラーリングした分析、開発、またはテスト専用のクラスターを作成できます。同期されたクラスターは、監査とデータ レジデンシーに関するローカルのコンプライアンス要件もサポートできます。

データの継続的な同期に加えて、mongosync クラスター間の 1 回限りのデータ移行も容易にします。

mongosyncプロセスの概要については、「 mongosyncについて 」を参照してください。

mongosync を使い始めるには、「クイック スタート ガイド」を参照してください。

  • mongosync では、 MongoDB 8.0 を使用するクラスターへの移行と クラスターからの移行はまだサポートされていません。宛先クラスターにデータを移行する手順については、「 より前のソースクラスターから 宛先クラスターへのデータを同期する8.0 8.08.0」と「2 つの 間でデータを同期する」8 0を参照してください。 クラスター。

  • MongoDB でサポートされる最小のサーバー バージョンは 6.0.16 および 7.0.9 です。

    MongoDB のバージョンが6.0未満のクラスター(ソース)のデータを Atlas クラスター(宛先)に移行できます。 下位バージョンのクラスターから移行するには、下位バージョンのクラスターで追加の準備と構成が必要です。 プロフェッショナル サービスについては、アカウントチームに問い合わせてください。

  • mongosync は、レプリカセットとシャーディングされたクラスターをサポートします。

  • スタンドアロンの MongoDB インスタンスはサポートされていません。Cluster-to-Cluster Sync を使用する前に、スタンドアロンインスタンスをレプリカセットに変換します

  • mongosync では、Atlas 共有クラスターまたはサーバーレスインスタンスはサポートされていません。

  • 制限事項の完全なリストについては、「Cluster-to-Cluster Sync 制限事項」を参照してください。

以下のmongosyncコマンドのレイアウトは表示用に変更されています。 mongosyncを使用してcluster0cluster1に接続するには、次のコマンドを 1 行で入力します。

mongosync \
--cluster0 "<cluster0_connection_string>" \
--cluster1 "<cluster1_connection_string>"

接続文字列の形式方法の詳細については、「 mongosyncの接続 」を参照してください。

--acceptDisclaimer

埋め込み検証演算子と、 ベータを使用する場合は、mongosync ベータ機能に弁別子を受け入れます。

このオプションなしで mongosync プロセスが開始されると、ユーザーは各ディスククレームを受け入れるように求められます。

このオプションでは、すでにディスク クレームを読み取って承認したユーザーは、ディスク クレームを受け入れ、mongosync プロセスを開始できます。

構成ファイルから --acceptDisclaimer オプションを設定するには、 acceptDisclaimer 設定を参照してください。

バージョン 1.9 の新機能

--cluster0 <uri>

最初のクラスターの接続 URIを設定します。最初のクラスターは、同期プロセスのソースまたは宛先として機能できます。start API エンドポイントの呼び出しでソースクラスターと宛先クラスターを指定します。

mongosync の接続の詳細については、「 接続」を参照してください。

構成ファイルから --cluster0 オプションを設定するには、 cluster0 設定を参照してください。

警告

一部のシステムでは、--cluster0 または --cluster1 オプションを使用して接続文字列にパスワードを指定すると、他のユーザーによって呼び出される可能性のある ps などのシステム ステータス プログラムにパスワードが表示される場合があります。

代わりに--configオプションを使用して、パスワードを含む構成ファイルを指定することを検討してください。

--cluster1 <uri>

2 番目のクラスターの接続 URI を設定します。2 番目のクラスターは、同期プロセスのソースまたは宛先のいずれかとして機能します。start API エンドポイントの呼び出しでソースクラスターと宛先クラスターを指定します。

mongosync の接続の詳細については、「 接続」を参照してください。

構成ファイルから --cluster1 オプションを設定するには、 cluster1 設定を参照してください。

警告

一部のシステムでは、--cluster0 または --cluster1 オプションを使用して接続文字列にパスワードを指定すると、他のユーザーによって呼び出される可能性のある ps などのシステム ステータス プログラムにパスワードが表示される場合があります。

代わりに--configオプションを使用して、パスワードを含む構成ファイルを指定することを検討してください。

--config <filename>

構成ファイルへのパスを設定します。

詳しくは、構成ファイル を参照してください。

--disableTelemetry

バージョン 1.4.0 の新機能

mongosyncテレメトリー データの収集を無効にします。

デフォルトでは、mongosync MongoDB 製品を改善するために匿名の集約された使用状況データを収集します。mongosync を実行すると、このテレメトリー データのコレクションを無効にできます。

構成ファイルから --disableTelemetry オプションを設定するには、 disableTelemetry 設定を参照してください。

詳しくは、「 ユーザー データの収集」を参照してください。

--help, -h

使用情報を stdout に出力します。

--id <id>

mongosync インスタンスの識別子を設定します。

シャーディングされたクラスターで mongosync の複数のインスタンスを実行中の場合は、このオプションを使用して、シャードを個別に同期します。

このオプションの識別子の値は、同期するシャードのシャード ID に対応していなければなりません。シャード ID を見つけるには、listShards コマンドを使用します。

構成ファイルから --id オプションを設定するには、 id 設定を参照してください。

--loadLevel <level>

タイプ: 整数

デフォルト: 3

ソースクラスターと宛先クラスター間でデータを同期するためのクラスターワークロードレベルを設定します。

  • 4これは最上位の設定で、クラスターのワークロードが最大化され、データが最速で同期されます。

  • 1これは最下位の設定で、クラスタのワークロードが最小限に抑えられ、データの同期は最も遅くなります。

構成ファイルから --loadLevel オプションを設定するには、 loadLevel 設定を参照してください。

警告

loadLevel をデフォルトの 3 よりも高く設定すると、宛先クラスターのパフォーマンスに悪影響を及ぼす可能性があります。

ソースクラスターに読み取りボトルネックが存在する場合、または宛先クラスターに書込みボトルネックが存在する場合、loadLevel を減らすとパフォーマンスが向上する可能性があります。

バージョン 1.4 で追加

--logPath <directory>

ログディレクトリへのパスを設定します。Cluster-to-Cluster Sync は、このディレクトリ内のファイルにログを書き込みます。

詳しくは、「ログ記録」を参照してください。

構成ファイルから --logPath オプションを設定するには、 logPath 設定を参照してください。

注意

--logPathオプションを使用してmongosyncを起動すると、ログファイルをローテーションするためにUSR1シグナルをmongosyncプロセスに送信できます。

kill -s USR1 $mongosync_pid

$mongosync_pid は、 mongosyncプロセス ID です。

--migrationName <name>

重要

Cluster-to-Cluster Sync betaプログラム

この機能は mongosync betaでのみ使用できます。 詳しくは、「 Cluster-to-Cluster Sync betaプログラム 」を参照してください。

mongosync-beta 1.8以降、 は同期操作の移行名を設定します。 たとえば、移行名を設定して、複数のソースクラスターから 1 つの宛先クラスターへの各同期操作を識別できます。

migrationName string には、最大44個の英数字とアンダースコアの文字を含めることができます。 移行メタデータデータベース名を設定するために、string "mongosync_internal_"migrationNameが追加されます。

たとえば、 migrationName"cluster_27000_to_cluster_35000_sync"に設定すると、結果のmongosyncメタデータ データベース名は"mongosync_internal_cluster_27000_to_cluster_35000_sync"になります。

完全な例については、「多対 1 の移行」または 「 A->B->C の移行 」を参照してください。

構成ファイルから --migrationName オプションを設定するには、 migrationName 設定を参照してください。

--port

デフォルト: 27182

Cluster-to-Cluster Sync HTTP API の HTTP サーバーが使用するポートを設定します。

構成ファイルから --port オプションを設定するには、 port 設定を参照してください。

--verbosity <level>

デフォルト: DEBUG

ログ メッセージの冗長性レベルを設定します。Cluster-to-Cluster Syncでは、指定されたレベルのすべてのメッセージと、それより低いレベルのすべてのメッセージがログに記録されます。

--verbosity オプションでは、次の値がサポートされています。

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • PANIC

構成ファイルから --verbosity オプションを設定するには、 verbosity 設定を参照してください。

--version, -v

mongosyncのバージョン情報を stdout に出力します。

詳しくは、「 mongosyncの動作 」を参照してください。

戻る

参照