mongosync
定義
mongosync
バイナリーは、Cluster-to-Cluster Sync で使用されるプライマリ プロセスです。mongosync
は、あるクラスターから別のクラスターにデータを移行し、クラスターを継続的に同期させることができます。
mongosync
を使用すると、本番環境をミラーリングした分析、開発、またはテスト専用のクラスターを作成できます。同期されたクラスターは、監査とデータ レジデンシーに関するローカルのコンプライアンス要件もサポートできます。
データの継続的な同期に加えて、mongosync
クラスター間の 1 回限りのデータ移行も容易にします。
mongosync
プロセスの概要については、「 mongosync
について 」を参照してください。
mongosync
を使い始めるには、「クイック スタート ガイド」を参照してください。
互換性
mongosync
では、 MongoDB 8.0 を使用するクラスターへの移行とクラスターからの移行はまだサポートされていません。8.0 の宛先クラスターにデータを移行する手順については、「8.0 より前のソースクラスターから 8.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
を使用してcluster0
をcluster1
に接続するには、次のコマンドを 1 行で入力します。
mongosync \ --cluster0 "<cluster0_connection_string>" \ --cluster1 "<cluster1_connection_string>"
接続文字列の形式方法の詳細については、「 mongosync
の接続 」を参照してください。
コマンドライン オプション
グローバル オプション
--acceptDisclaimer
このオプションなしで
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
設定を参照してください。詳しくは、「 ユーザー データの収集」を参照してください。
--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 です。
--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
設定を参照してください。
動作
詳しくは、「 mongosync
の動作 」を参照してください。