mongorestore
このドキュメントは、mongorestore のバージョン 100.10.0 用です。
Synopsis
mongorestore プログラムは、mongodump によって作成されたバイナリのデータベース ダンプ、または標準入力からデータを読み込み、mongod または mongos インスタンスにロードします。
mongodump から生成された BSON ファイルは、復元元と同じかそれ以降のバージョンを実行中の MongoDB 配置に復元できます。ただし、新しいバージョンの配置へのファイルの復元は、配置のアップグレード方法としては推奨されていません。配置のアップグレード方法については、アップグレードのドキュメントを参照してください。
mongo shell ではなく、システム コマンド ラインから mongorestore を実行します。
MongoDB は、同じコレクションに対して複数の mongorestore プログラムを同時に実行することをサポートしていません。
MongoDB データベースツールを使用して、セルフホスト型配置から MongoDB Atlas へ移行できます。MongoDB Atlas は、MongoDB をクラウドに配置するためのフルマネージド サービスです。詳細については、「mongorestore でのシード処理」を参照してください。
MongoDB Atlas への移行方法については、「データの移行またはインポート」を参照してください。
構文
mongorestore 構文:
mongorestore <options> <connection-string> <directory or file to restore>
たとえば、dump ディレクトリから ポート 27017 で実行されている mongod のローカル インスタンスに復元するには、次の手順に従います。
mongorestore dump/
mongorestore は、dump/ ディレクトリから復元する際、必要に応じてデータベースとコレクションを作成し、進行状況をログに記録します。
2019-07-08T14:37:38.942-0400 preparing collections to restore from 2019-07-08T14:37:38.944-0400 reading metadata for test.bakesales from dump/test/bakesales.metadata.json 2019-07-08T14:37:38.944-0400 reading metadata for test.salaries from dump/test/salaries.metadata.json 2019-07-08T14:37:38.976-0400 restoring test.salaries from dump/test/salaries.bson 2019-07-08T14:37:38.985-0400 no indexes to restore 2019-07-08T14:37:38.985-0400 finished restoring test.salaries (10 documents, 0 failures) 2019-07-08T14:37:39.009-0400 restoring test.bakesales from dump/test/bakesales.bson 2019-07-08T14:37:39.011-0400 restoring indexes for collection test.bakesales from metadata 2019-07-08T14:37:39.118-0400 finished restoring test.bakesales (21 documents, 0 failures) 2019-07-08T14:37:39.118-0400 restoring users from dump/admin/system.users.bson 2019-07-08T14:37:39.163-0400 restoring roles from dump/admin/system.roles.bson 2019-07-08T14:37:39.249-0400 31 document(s) restored successfully. 0 document(s) failed to restore.
dump/ ディレクトリから特定のコレクション（複数可）を復元することもできます。次の操作の例では、dump/ ディレクトリ内の対応するデータファイルから 1 つのコレクションを復元します。
mongorestore --nsInclude=test.purchaseorders dump/
dump/ ディレクトリに、指定された名前空間に対応するデータファイルが含まれていない場合、データは復元されません。次の例では、dump/ ディレクトリに対応するデータがないコレクション名前空間が指定されています。
mongorestore --nsInclude=foo.bar dump/
mongorestore では、次のメッセージが出力されます。
2019-07-08T14:38:15.142-0400 preparing collections to restore from 2019-07-08T14:38:15.142-0400 0 document(s) restored successfully. 0 document(s) failed to restore.
その他の例については、「mongorestore の例」を参照してください。
オプション
--quiet出力量を制限する quiet モードで
mongorestoreを実行します。このオプションにより次の項目が抑制されます。
データベースコマンドからの出力
レプリケーション アクティビティ
接続を受け付けたイベント
接続を終了したイベント
--config=<filename>バージョン 100.3.0 の新機能。
次のオプションの機密値を含む YAML 構成ファイルへのフル パスを
mongorestoreに指定します。これは、
mongorestoreにパスワードを指定するのに、パスワード プロンプトを使用して指定する以外で推奨される方法です。構成ファイルは以下の形式をとります。
password: <password> uri: mongodb://mongodb0.example.com:27017 sslPEMKeyPassword: <password> password:フィールドにパスワードを指定し、競合するパスワードを含む接続文字列をuri:フィールドに指定すると、エラーが発生します。このファイルは、必ず適切なファイルシステム権限で保護してください。
注意
--configで構成ファイルを指定し、かつmongorestore--password、--uriまたは--sslPEMKeyPasswordオプションも使用する場合、各コマンドライン オプションによって構成ファイルの対応オプションが上書きされます。
--uri=<connectionString>MongoDB 配置の解決可能な URI 接続文字列 を引用符で囲んで指定します。
--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]" mongorestoreのバージョン100.0以降、接続文字列は、--uriオプションを使用せずに、位置パラメータとして入力することもできます。mongorestore mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]] 接続文字列は、位置指定パラメータとして
mongodb://またはmongodb+srv://で始まっている限り、コマンドラインの任意の点で指定できます。以下に例を挙げます。mongorestore --username joe --password secret1 mongodb://mongodb0.example.com:27017 --ssl 入力できる接続文字列は 1 つのみです。複数の値を含めようとすると、
--uriオプションを使用する場合でも、位置引数として使用する場合でも、エラーになります。接続文字列のコンポーネントの詳細については、「接続文字列 URI 形式」ドキュメントを参照してください。
注意
connection string内の一部のコンポーネントは、--usernameや--passwordなど、独自の明示的コマンドライン オプションを使用して指定することもできます。明示的オプションを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。注意
mongorestoreを Ubuntu 18.04 で使用する場合、（mongodb+srv://形式で）SRV 接続文字列を--uriオプションと併用する場合、cannot unmarshal DNSというエラー メッセージが表示されることがあります。その場合は、次のいずれかのオプションを代わりに使用します。--uriオプションと非 SRV 接続文字列（mongodb://形式）直接接続するホストを指定するための
--hostオプション
--host=<hostname><:port>, -h=<hostname><:port>デフォルト: localhost:27017
MongoDB 配置の解決可能なホスト名を指定します。デフォルトでは、
mongorestoreによってポート番号27017のローカルホストで実行されている MongoDB インスタンスに接続しようとします。レプリカセットに接続するには、
replSetNameとセットノードのシードリストを次のように指定します。--host=<replSetName>/<hostname1><:port>,<hostname2><:port>,<...> レプリカセット リスト形式を指定する場合、
mongorestoreは常にプライマリに接続します。また、レプリカセットの任意の 1 つのノードに接続するには、そのノードのみのホストとポートを指定します。
--host=<hostname1><:port> IPv6 を使用し、
<address>:<port>形式を使用する場合は、アドレスとポートの組み合わせの一部を括弧で囲む必要があります（例:[<address>]）。あるいは、
URI connection stringでホスト名を直接指定することもできます。--hostを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。
--port=<port>デフォルト: 27017
MongoDB インスタンスがクライアント接続のためにリッスンする TCP ポートを指定します。
あるいは、
URI connection stringでポートを直接指定することもできます。--portを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。
--sslTLS/SSL サポートが有効になっている
mongodまたはmongosへの接続を有効にします。あるいは、
URI connection stringで TLS/SSL サポートを直接構成することもできます。--sslを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。
--sslCAFile=<filename>証明書認証機関からのルート証明書チェーンを含む
.pemファイルを指定します。相対パスまたは絶対パスを使用して.pemファイルのファイル名を指定します。あるいは、
URI connection stringで.pemファイルを直接指定することもできます。接続文字列を提供し、さらに--sslCAFileを使用中に競合する情報を指定すると、エラーが発生します。TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。
--sslPEMKeyFile=<filename>TLS/SSL 証明書とキーの両方を含む
.pemファイルを指定します。相対パスまたは絶対パスを使用して、.pemファイルのファイル名を指定します。このオプションが必要になるのは、
--sslオプションを使用してmongodまたはmongosに接続し、かつこれらでallowConnectionsWithoutCertificates. がない状態でCAFileが有効化されている場合です。あるいは、
URI connection stringで.pemファイルを直接指定することもできます。接続文字列を提供し、さらに--sslPEMKeyFileを使用中に競合する情報を指定すると、エラーが発生します。TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。
--sslPEMKeyPassword=<value>証明書キーファイル（例:
--sslPEMKeyFile）を復号化するためのパスワードを指定します。--sslPEMKeyPasswordオプションは、証明書キーファイルが暗号化されている場合にのみ使用してください。いずれの場合も、mongorestoreはログおよびレポート出力でパスワードを非表示にします。PEM ファイル内の秘密キーが暗号化されており、
--sslPEMKeyPasswordオプションを指定しない場合は、mongorestoreによってパスフレーズの入力が求められます。詳しくは、「TLS/SSL 証明書のパスフレーズ」を参照してください。あるいは、
URI connection stringでパスワードを直接指定することもできます。--sslPEMKeyPasswordを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。
警告
一部のシステムでは、
--sslPEMKeyPasswordオプションを使用して直接提供されたパスワードは、他のユーザーによって呼び出される可能性のあるpsなどのシステム ステータス プログラムに表示される場合があります。代わりに--configオプションを使用して、パスワードを含む構成ファイルを指定することを検討してください。
--sslCRLFile=<filename>証明書失効リストを含む
.pemファイルを指定します。相対パスまたは絶対パスを使用して.pemファイルのファイル名を指定します。TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。
--sslAllowInvalidCertificatesサーバー証明書の検証チェックをバイパスし、無効な証明書を使用できるようにします。
allowInvalidCertificates設定を使用すると、MongoDB では無効な証明書の使用に対する警告としてログに記録されます。警告
あるいは、
URI connection stringで証明書の検証を直接無効にすることもできます。接続文字列を提供し、さらに--sslAllowInvalidCertificatesを使用して競合する情報を指定すると、エラーが発生します。TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。
--sslAllowInvalidHostnamesTLS/SSL 証明書のホスト名の検証を無効にします。証明書内のホスト名が指定されたホスト名と一致しない場合でも、
mongorestoreによって MongoDB インスタンスへの接続が許可されます。あるいは、
URI connection stringでホスト名の検証を直接無効にすることもできます。--sslAllowInvalidHostnamesを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。
--username=<username>, -u=<username>認証を使用する MongoDB データベースへの認証すに使用するユーザー名を指定します。
--passwordオプションおよび--authenticationDatabaseオプションと組み合わせて使用します。あるいは、
URI connection stringでユーザー名を直接指定することもできます。--usernameを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。MONGODB-AWSauthentication mechanismを使用して MongoDB Atlas クラスターに接続する場合は、次の場所で AWS アクセス キー ID を指定できます。このフィールド
AWS_ACCESS_KEY_ID環境変数。
それぞれの例については、「AWS IAM 認証情報を使用した MongoDB Atlas クラスターへの接続」を参照してください。
--password=<password>, -p=<password>認証を使用する MongoDB データベースに対して認証するためのパスワードを指定します。
--usernameオプションおよび--authenticationDatabaseオプションと組み合わせて使用します。ユーザーにパスワードの入力を求めるには、
--usernameオプションを--passwordなしで渡すか、--password=""のように--passwordの値に空の文字列を指定します。あるいは、
URI connection stringでパスワードを直接指定することもできます。--passwordを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。MONGODB-AWSauthentication mechanismを使用して MongoDB Atlas クラスターに接続する場合は、次の場所で AWS シークレットアクセスキーを指定できます。このフィールド
AWS_SECRET_ACCESS_KEY環境変数。
それぞれの例については、「AWS IAM 認証情報を使用した MongoDB Atlas クラスターへの接続」を参照してください。
警告
一部のシステムでは、
--passwordオプションを使用して直接提供されたパスワードは、他のユーザーによって呼び出される可能性のあるpsなどのシステム ステータス プログラムに表示される場合があります。そのため、次の代替策を検討しましょう。--passwordオプションを省略し、インタラクティブなパスワード プロンプトを表示する--configオプションを使用して、パスワードを含む構成ファイルを指定します。
--awsSessionToken=<AWS Session Token>MONGODB-AWSauthentication mechanismを使用して MongoDB Atlas クラスターに接続し、AWS アクセスキー ID とシークレットアクセスキーに加えてセッション トークンを使用する場合は、次の場所に AWS セッション トークンを指定できます。このフィールド
AWS_SESSION_TOKENauthMechanismPropertiesパラメーターをconnection stringへ、またはAWS_SESSION_TOKEN環境変数。
それぞれの例については、「AWS IAM 認証情報を使用した MongoDB Atlas クラスターへの接続」を参照してください。
MONGODB-AWSauthentication mechanismを使用している場合にのみ有効です。
--authenticationDatabase=<dbname>指定された
--usernameが作成された認証データベースを指定します。詳細については、「認証データベース」を参照してください。GSSAPI（Kerberos）、PLAIN（LDAP SASL）、または
MONGODB-AWSauthentication mechanismsを使用する場合は、--authenticationDatabaseを$externalに設定する必要があります。あるいは、
URI connection stringで認証データベースを直接指定することもできます。--authenticationDatabaseを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。
--authenticationMechanism=<name>デフォルト: SCRAM-SHA-1
mongorestoreインスタンスがmongodまたはmongosへの認証に使用する認証メカニズムを指定します。バージョン 100.1.0 での変更: バージョン
100.1.0以降、MongoDB Atlas クラスターへの接続時にMONGODB-AWS認証メカニズムのサポートがmongorestoreに追加されます。値説明SHA-1 ハッシュ関数を使用する RFC5802 標準の Salted Challenge Response Authentication Mechanismです。SHA-256 ハッシュ関数を使用する RFC 7677 標準の Salted Challenge Response Authentication Mechanism。
featureCompatibilityVersion を
4.0に設定する必要があります。MongoDB TLS/SSL 証明書認証。MONGODB-AWSMongoDB Atlas クラスターへの接続に使用する AWS IAM 認証情報を使用した外部認証。「AWS IAM 認証情報を使用して MongoDB Atlas クラスターに接続する」を参照してください。
バージョン 100.1.0 の新機能。
GSSAPI（Kerberos）Kerberos を使用する外部認証。このメカニズムは MongoDB Enterprise でのみ使用できます。PLAIN（LDAP SASL）LDAP を使用する外部認証。データベース内のユーザー認証には、PLAINを使用することもできます。PLAINはパスワードをプレーン テキストで送信します。このメカニズムは MongoDB Enterprise でのみ使用できます。あるいは、
URI connection stringで認証メカニズムを直接指定することもできます。--authenticationMechanismを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。
--gssapiServiceName=<serviceName>GSSAPI/Kerberos を使用してサービスの名前を指定します。サービスがデフォルト名
mongodbを使用しない場合のみ必要となります。このオプションは MongoDB Enterprise でのみ使用できます。
--gssapiHostName=<hostname>GSSAPI/Kerberos を使用してサービスのホスト名を指定します。マシンのホスト名が DNS で解決されたホスト名と一致しない場合にのみ必要となります。
このオプションは MongoDB Enterprise でのみ使用できます。
--db=<database>, -d=<database>BSON ファイルからデータを復元するときに、
mongorestoreにデータの復元先のデータベースを指定します。データベースが存在しない場合は、mongorestoreによりデータベースが作成されます。次の例では、salariesコレクションをreportingデータベースに復元しています。mongorestore --db=reporting dump/test/salaries.bson --dbを指定しない場合、mongorestoreはデータファイルからデータベース名を読み取ります。ディレクトリまたはアーカイブ ファイルから復元する場合、
--dbと--collectionオプションの使用は推奨されません。代わりに、アーカイブまたはディレクトリから復元するには、「--nsInclude」を参照してください。あるいは、
URI connection stringでデータベースを直接指定することもできます。--dbを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。
--collection=<collection>, -c=<collection>BSON ファイルからの復元時にデータを読み込む
mongorestoreの復元先コレクション名を指定します。--collectionを指定しない場合、mongorestoreは入力ファイル名からコレクション名を取得します。入力ファイルに拡張子がある場合、コレクション名ではその拡張子は省略されます。mongorestore --db=reporting --collection=employeesalaries dump/test/salaries.bson ディレクトリまたはアーカイブ ファイルから復元する場合、
--dbと--collectionオプションの使用は推奨されません。代わりに、アーカイブまたはディレクトリから復元するには、「--nsInclude」を参照してください。
--nsExclude=<namespace pattern>名前空間パターン（例:
"test.myCollection"、"reporting.*"、"dept*.bar"）を指定して、一致する名前空間を復元対象から除外します。このパターンでは、ワイルドカードとしてアスタリスク*を使用できます。ワイルド カード パターンの例については、「ワイルドカードを使用したコレクションの復元」を参照してください。--nsExcludeを複数回指定回指定することで、複数の名前空間パターンを除外することができます。
--nsInclude=<namespace pattern>名前空間パターン（例:
"test.myCollection"、"reporting.*"、"dept*.bar"）を指定して、パターンに一致する名前空間のみを復元します。このパターンでは、ワイルドカードとしてアスタリスク*を使用できます。ワイルド カード パターンの例については、「ワイルドカードを使用したコレクションの復元」を参照してください。複数の名前空間パターンを含めるには、
--nsIncludeを複数回指定できます。ソース ディレクトリまたはファイル（つまり、データの復元元のディレクトリ/ファイル）に名前空間パターンと一致するデータファイルが含まれていない場合、データは復元されません。
コレクション名に非 ASCII 文字が含まれている場合、
mongodumpは、対応するファイル名をパーセント エンコードされた名前で出力します。ただし、これらのコレクションを復元する場合は、エンコードされた名前を使用しないでください。代わりに、非 ASCII 文字を含む名前空間を使用してください。たとえば、ダンプ ディレクトリに
dump/test/caf%C3%A9s.bsonが含まれている場合は、--nsInclude "test.cafés"と指定します。
--nsFrom=<namespace pattern>--nsToを使用して、復元操作中に名前空間の名前を変更します。--nsFromはダンプファイル内のコレクションを指定し、--nsToは復元されたデータベースで使用する名前を指定します。--nsFromは名前空間パターンを引数として受け入れます。名前空間パターンにより--nsFromは指定パターンに一致する任意の名前空間を参照できます。mongorestoreは、名前空間パターンの最小の有効な出現と一致します。単純な置換の場合は、ワイルド カードとしてアスタリスク（
*）を使用します。すべてのリテラルのアスタリスクとバックスラッシュを、バックスラッシュでエスケープします。置換は一致に対して順次に対応します。--nsFromの各アスタリスクは--nsToのアスタリスクに対応し、--nsFromの最初のアスタリスクはnsToの最初のアスタリスクと一致する必要があります。より複雑な置き換えでは、使用する「ワイルドカード」変数をドル記号で区切ります。このワイルドカードを使った複雑な置き換えの例については、「復元中のコレクションの名前空間の変更」を参照してください。
アスタリスクによる置換とは異なり、ドル記号で区切られたワイルド カードの置換は順次対応する必要はありません。
--nsTo=<namespace pattern>--nsFromを使用して、復元操作中に名前空間の名前を変更します。--nsToは復元されたデータベースで使用する新しいコレクション名を、--nsFromはダンプファイル内の名前を指定します。--nsToは名前空間パターンを引数として受け入れます。名前空間パターンにより--nsToは指定パターンに一致する任意の名前空間を参照できます。mongorestoreは、名前空間パターンの最小の有効な出現と一致します。単純な置換の場合は、ワイルド カードとしてアスタリスク（
*）を使用します。すべてのリテラルのアスタリスクとバックスラッシュを、バックスラッシュでエスケープします。置換は一致に対して順次に対応します。--nsFromの各アスタリスクは--nsToのアスタリスクに対応し、--nsFromの最初のアスタリスクはnsToの最初のアスタリスクと一致する必要があります。より複雑な置き換えでは、使用する「ワイルドカード」変数をドル記号で区切ります。このワイルドカードを使った複雑な置き換えの例については、「復元中のコレクションの名前空間の変更」を参照してください。
アスタリスクによる置換とは異なり、ドル記号で区切られたワイルド カードの置換は順次対応する必要はありません。
--objcheckクライアントからのすべてのリクエストについて、受信時に
mongorestoreに検証を強制して、クライアントがデータベースに無効なドキュメントを挿入しないようにします。サブドキュメントのネストが深いオブジェクトの場合、--objcheckによってパフォーマンスに若干影響が出る可能性があります。
--dropダンプされたバックアップからコレクションを復元する前に、復元先のデータベースからコレクションを削除します。バックアップに含まれていないコレクションは、
--dropによって削除されません。復元に
adminデータベースが含まれている場合、mongorestoreは--dropを使用してすべてのユーザー認証情報を削除し、ダンプファイルで定義されたユーザーに置き換えます。そのため、authorizationが有効なシステムでは、mongorestoreは既存のユーザーおよびダンプファイルで定義されたユーザーの両方に対して認証できる必要があります。mongorestoreがダンプファイルで定義されたユーザーに対して認証できない場合、復元プロセスは失敗し、空のデータベースが残ります。コレクションが復元過程で削除、再作成される場合、新たに作成されるコレクションの UUID は、
--dropが--preserveUUIDと併用されない限り、異なるものになります。
--preserveUUID復元の一環で削除、再作成されたコレクションに対して新しい UUID が作成されるのではなく、復元されたコレクションには復元データの UUID が使用されます。
--preserveUUIDを使用するには、--dropオプションも含める必要があります。
--dryRunデータを実際にインポートせずに
mongorestoreを実行し、mongorestoreサマリー情報を返します。より詳細なサマリー情報を生成するには、--verboseを一緒に使用します。
--oplogReplayデータベース ダンプの復元後に、
oplog.bsonファイルから oplog エントリを再生します。復元時に
oplog.bsonファイルから oplog エントリを適用するには、mongorestore --oplogReplayを使用します。データが最新で、ダンプ操作中に発生したすべての書き込みが含まれていることを確認するには、mongodump --oplogをmongorestore --oplogReplayと併用します。mongorestore次のロケーションで BSON ファイルの有効なソースの検索も使用します。mongodump --oplogで作成されたダンプの場合と同様に、最上位のダンプ ディレクトリです。mongodump --oplog--oplogFileで指定されるパス。<dump-directory>/local/oplog.rs.bson、mongodのlocalデータベースに含まれるoplog.rsコレクションのダンプが、レプリカ セットのノードである場合。
oplog.bsonファイルがダンプ ディレクトリの最上位にあり、かつパスが--oplogFileで指定されている場合には、mongorestoreからエラーが返されます。ダンプ ディレクトリの最上位に
oplog.bsonファイルがある場合、mongorestoreは、そのファイルを oplog として復元します。dump/localディレクトリに bson ファイルもある場合、mongorestoreは、通常のコレクションと同様にそれらを復元します。--oplogFileを使用して oplog ファイルを指定すると、mongorestoreではそのファイルは oplog として復元されます。dump/localディレクトリに bson ファイルもある場合、これらのファイルはmongorestoreで通常のコレクションと同様に復元されます。oplog replay 出力の次のメッセージは、oplog replay の前の挿入数を示しています。リプレイ中に行われた挿入は含まれません。
0 document(s) restored successfully. 0 document(s) failed to restore. --oplogReplayの例については、「Oplog ファイルを使用したデータのバックアップと復元」を参照してください。注意
mongorestoreを使用して--oplogReplayでレプリカセットを復元する場合、mongodump --oplogを使用して作成されたレプリカ セットノードの完全なダンプを復元する必要があります。次のオプションのいずれかを使用して復元するデータを制限する場合、mongorestoreと--oplogReplayは併用できません。
--oplogLimit=<timestamp>mongorestoreが oplog エントリを<timestamp>以降のタイムスタンプで適用しないようにします。<timestamp>値は<time_t>:<ordinal>形式で指定します。<time_t>は UNIX エポック後の秒数、<ordinal>は指定秒数内に発生した oplog での操作の回数を表します。警告
oplogLimitの使用には注意が必要です。適用する oplog エントリを手動で指定すると、復元データの破損や不整合につながる恐れがあります。--oplogLimitは--oplogReplayオプションと組み合わせて使用する必要があります。
--oplogFile=<path>復元用の oplog データを含む oplog ファイルへのパスを指定します。
--oplogReplayと併用します。--oplogFileを指定した場合にダンプ ディレクトリの最上位にoplog.bsonファイルがあると、mongorestoreからエラーが返されます。警告
oplogFileの使用には注意が必要です。適用する oplog エントリを手動で指定すると、復元データの破損や不整合につながる恐れがあります。
--convertLegacyIndexesバージョン100.0.0の新機能。
対応する
mongodump出力で指定された無効なインデックス オプションをすべて排除し、レガシー インデックス キーの値を有効な値に書き換えます。無効なインデックス オプションとは、
createIndexesコマンドの有効フィールドとしてリストされていないインデックス専用のオプションです。たとえば、nameとcollationは有効ですが、無作為のcustom_fieldは有効ではありません。--convertLegacyIndexesが指定されている場合、見つかった無効なインデックス オプションはすべて削除されます。レガシー インデックス キー値とは、サポートされなくなったインデックス タイプの値です。たとえば、
1と-1は有効なインデックス キー値ですが、0または空の文字列はレガシー値です。--convertLegacyIndexesが指定されている場合、見つかったレガシー インデックス キー値は1に書き換えられます。空でない文字列の値は書き換えられません。
--convertLegacyIndexesオプションが指定されていない場合、無効なインデックス オプションまたはレガシー インデックス キーの値が存在すると、インデックス構築が失敗する可能性があります。--noIndexRestoreオプションがmongorestoreに指定されている場合、--convertLegacyIndexesオプションは無視されます。
--noIndexRestore対応する
mongodump出力で指定されているように、mongorestoreがインデックスを復元および構築するのを防ぎます。
--fixDottedHashIndexドット表記されたフィールドのすべてのハッシュインデックスを、ターゲットデータベースの 1 つのフィールドの昇順インデックスとして作成します。
--noOptionsRestoremongorestoreが復元されたコレクションに対してcollModデータベースコマンドによって指定されたコレクション オプションを設定するのを防ぎます。
--restoreDbUsersAndRoles指定されたデータベースのユーザーとロールの定義を復元します。詳細については、system.roles コレクションおよび system.users コレクションを参照してください。
注意
--restoreDbUsersAndRolesオプションは、adminデータベースに--dbオプションを指定すると使用できなくなり、指定を試みるとエラーが発生します。--db adminにmongorestoreを指定してadminデータベースを復元すると、すべてのユーザーとロールは自動的に復元されます。
--writeConcern=<document>デフォルト: 過半数
mongorestoreで実行される各書き込み操作の書き込み保証（write concern）レベルを指定します。w オプション適用のドキュメントとしての書込み保証（write concern）の指定
--writeConcern="{w:'majority'}" 書き込み保証が
--uri connection stringにも含まれている場合、URI文字列で指定された書き込み保証はコマンドライン--writeConcernで上書きされます。
--maintainInsertionOrderデフォルト: false
指定した場合、
mongorestoreは、入力ソースに出現する順序でドキュメントを挿入します。つまり、一括書込み (write) バッチの順と、バッチ内のドキュメント順の両方が維持されます。--maintainInsertionOrderを指定することで--stopOnErrorも有効になり、numInsertionWorkersPerCollectionは 1 に設定されます。指定されていない場合、
mongorestoreが、無作為な順序で挿入を実行する可能性があります。
--numParallelCollections=<int>, -j=<int>デフォルト: 4
mongorestoreが並行して復元すべきコレクションの数。単一コレクションの復元時に、
-jを指定すると、-jは--numParallelCollectionsではなく--numInsertionWorkersPerCollectionオプションにマッピングされます。
--numInsertionWorkersPerCollection=<int>デフォルト: 1
コレクションごとに同時に実行する挿入ワーカーの数を指定します。
大規模なインポートの場合、挿入ワーカーの数を増やすとインポートが迅速化する可能性があります。
--stopOnErrorエラーに遭遇すると、
mongorestoreは復元を中止するよう強制します。mongorestoreのデフォルト設定では、キーの重複とドキュメント検証エラーが発生しても復元処理は続行されます。こうしたエラー発生時にプログラムが停止するようにするには、--stopOnErrorを指定します。
--bypassDocumentValidation操作中にドキュメントの検証をバイパスするよう
mongorestoreを有効にします。これにより、検証要件を満たさないドキュメントを挿入できるようになります。このオプションは、Queryable Encryption が有効なコレクションを復元する場合に必要です。
--gzip以下によって作成された圧縮ファイルまたはデータ ストリームから復元します。
mongodump --gzip圧縮ファイルを含むダンプ ディレクトリから復元するには、
--gzipオプションを指定してmongorestoreを実行します。圧縮されたアーカイブ ファイルから復元するには、
--gzipオプションと--archiveオプションの両方を指定してmongorestoreを実行します。
--archive=<file>指定されたアーカイブ ファイルから復元します。ファイルが指定されていない場合は、標準入力（
stdin）から復元します。アーカイブ ファイルから復元するには、
--archiveオプションとアーカイブ ファイル名を指定してmongorestoreを実行します。標準入力から復元するには、
--archiveオプションを指定してmongorestoreを実行しますが、ファイル名は省略します。