mongosync バイナリは、非正規のMongoDB配置ではサポートまたはテストされていません。 これらのツールはこれらの配置で動作する可能性がありますが、互換性は保証されません。定義
mongosync バイナリは Mongosync で使用されるプライマリ プロセスです。mongosyncは、 が同期を完了するまで、ソースクラスターから宛先クラスターにデータを移行します。
mongosyncプロセスの概要については、「 mongosyncについて 」を参照してください。
mongosync を使い始めるには、「クイック スタート ガイド」を参照してください。
よくある質問(FAQ)ページでは、mongosync に関してユーザーから寄せられた質問を取り上げています。
互換性
mongosyncでは、 MongoDB 8.0 を使用するクラスターへの移行とクラスターからの移行はまだサポートされていません。8.0 の宛先クラスターにデータを移行する手順については、「8.0 より前のソースクラスターから 8.0 宛先クラスターへのデータ同期」および「2 つの 8.0 クラスター間でのデータ同期」を参照してください。MongoDB でサポートされる最小のサーバー バージョンは 6.0.17 および 7.0.13 です。
MongoDB のバージョンが6.0未満のクラスター(ソース)のデータを Atlas クラスター(宛先)に移行できます。 下位バージョンのクラスターから移行するには、下位バージョンのクラスターで追加の準備と構成が必要です。 プロフェッショナル サービスについては、アカウント チームに問い合わせてください。
mongosyncは、レプリカセットとシャーディングされたクラスターをサポートします。スタンドアロンのMongoDBインスタンスはサポートされていません。Mongosync を使用する前に、スタンドアロンインスタンスをレプリカセットに変換します。
mongosyncでは、Atlas 共有クラスターまたはサーバーレスインスタンスはサポートされていません。制限事項の完全なリストについては、Mongosync 制限事項を参照してください。
構文
以下のmongosyncコマンドのレイアウトは表示用に変更されています。 mongosyncを使用してcluster0をcluster1に接続するには、次のコマンドを 1 行で入力します。
mongosync \ --cluster0 "<cluster0_connection_string>" \ --cluster1 "<cluster1_connection_string>"
接続文字列の形式方法の詳細については、「 mongosyncの接続 」を参照してください。
コマンドライン オプション
コマンドラインを使用して、次の mongosync オプションを設定できます。
構成ファイルから mongosync を設定するには、構成ファイルをご覧ください。
グローバル オプション
--acceptDisclaimerこのオプションなしで
mongosyncプロセスが開始されると、ユーザーは各ディスククレームを受け入れるように求められます。このオプションでは、すでにディスク クレームを読み取って承認したユーザーは、ディスク クレームを受け入れ、
mongosyncプロセスを開始できます。構成ファイルから
--acceptDisclaimerオプションを設定するには、acceptDisclaimer設定を参照してください。バージョン 1.9 の新機能。
--cluster0 <uri>最初のクラスターの接続 URIを設定します。最初のクラスターは、同期プロセスのソースまたは宛先として機能できます。
startAPI エンドポイントの呼び出しでソースクラスターと宛先クラスターを指定します。mongosyncの接続の詳細については、「 接続」を参照してください。構成ファイルから
--cluster0オプションを設定するには、cluster0設定を参照してください。警告
一部のシステムでは、
--cluster0または--cluster1オプションを使用して接続文字列にパスワードを指定すると、他のユーザーによって呼び出される可能性のあるpsなどのシステム ステータス プログラムにパスワードが表示される場合があります。代わりに
--configオプションを使用して、パスワードを含む構成ファイルを指定することを検討してください。
--cluster1 <uri>2 番目のクラスターの接続 URI を設定します。2 番目のクラスターは、同期プロセスのソースまたは宛先のいずれかとして機能します。
startAPI エンドポイントの呼び出しでソースクラスターと宛先クラスターを指定します。mongosyncの接続の詳細については、「 接続」を参照してください。構成ファイルから
--cluster1オプションを設定するには、cluster1設定を参照してください。警告
一部のシステムでは、
--cluster0または--cluster1オプションを使用して接続文字列にパスワードを指定すると、他のユーザーによって呼び出される可能性のあるpsなどのシステム ステータス プログラムにパスワードが表示される場合があります。代わりに
--configオプションを使用して、パスワードを含む構成ファイルを指定することを検討してください。
--config <filename>構成ファイルへのパスを設定します。
移行中に構成ファイルのパスを設定するには、「同期中の
mongosyncの再構成」を参照してください。詳しくは、構成ファイル を参照してください。
--disableTelemetryバージョン 1.4.0 の新機能。
mongosyncの テレメトリー データの収集を無効にします。デフォルトでは、
mongosyncMongoDB 製品を改善するために匿名の集約された使用状況データを収集します。mongosyncを実行すると、このテレメトリー データのコレクションを無効にできます。構成ファイルから
--disableTelemetryオプションを設定するには、disableTelemetry設定を参照してください。移行中にテレメトリー データの収集を無効にするには、同期中の
mongosyncの再構成を参照してください。詳しくは、「 ユーザー データの収集」を参照してください。
--id <id>mongosyncインスタンスの識別子を設定します。シャーディングされたクラスターで
mongosyncの複数のインスタンスを実行中の場合は、このオプションを使用して、シャードを個別に同期します。このオプションの識別子の値は、同期するシャードのシャード ID に対応していなければなりません。シャード ID を見つけるには、
listShardsコマンドを使用します。構成ファイルから
--idオプションを設定するには、id設定を参照してください。
--loadLevel <level>タイプ: 整数
デフォルト:
3ソースクラスターと宛先クラスター間でデータを同期するためのクラスターワークロードレベルを設定します。
4これは最上位の設定で、クラスターのワークロードが最大化され、データが最速で同期されます。1これは最下位の設定で、クラスタのワークロードが最小限に抑えられ、データの同期は最も遅くなります。
構成ファイルから
--loadLevelオプションを設定するには、loadLevel設定を参照してください。移行中に負荷レベルを変更するには、「同期中の
mongosyncの再構成」をご覧ください。警告
loadLevelをデフォルトの3よりも高く設定すると、宛先クラスターのパフォーマンスに悪影響を及ぼす可能性があります。ソースクラスターに読み取りボトルネックが存在する場合、または宛先クラスターに書込みボトルネックが存在する場合、
loadLevelを減らすとパフォーマンスが向上する可能性があります。バージョン 1.4 で追加。
--logPath <directory>ログディレクトリへのパスを設定します。Mongosync は、このディレクトリ内のファイルにログを書込みます。
詳しくは、「ログ記録」を参照してください。
構成ファイルから
--logPathオプションを設定するには、logPath設定を参照してください。移行中にログディレクトリのパスを変更するには、同期中の
mongosyncの再構成を参照してください。注意
--logPathオプションを使用してmongosyncを起動すると、ログファイルをローテーションするためにUSR1シグナルをmongosyncプロセスに送信できます。kill -s USR1 $mongosync_pid $mongosync_pidは、mongosyncプロセス ID です。
--portデフォルト:
27182Mongosync HTTP APIのHTTPサーバーが使用するポートを設定します。
構成ファイルから
--portオプションを設定するには、port設定を参照してください。移行中にポートを変更するには、同期中の
mongosyncの再構成を参照してください。
--verbosity <level>デフォルト:
DEBUGログメッセージの冗長レベルを設定します。Mongosync では、指定されたレベルのすべてのメッセージと、それより低いレベルのすべてのメッセージがログに記録されます。
--verbosityオプションでは、次の値がサポートされています。TRACEDEBUGINFOWARNERRORFATALPANIC
構成ファイルから
--verbosityオプションを設定するには、verbosity設定を参照してください。移行中に冗長度レベルを変更するには、同期中の
mongosyncの再構成を参照してください。
動作
詳しくは、「 mongosyncの動作 」を参照してください。