mongodump の動作、アクセス、使用方法

なしで を使用mongodumpauthSource

When authSource is not specified in the MongoDB URI, the database name specified in --db is used both to authenticate your mongodump session and to indicate the database being dumped. For an example of using a different database for authentication when using mongodump, see Authenticating with a Specific Database.

一致するサーバー バージョンへの復元

mongorestoreを使用してmongodumpによって作成されたデータファイルを読み込む場合、ソース配置と宛先配置の MongoDB バージョンは次のいずれかである必要があります。

• 同一メジャー バージョン。

• 同一機能互換バージョン。

たとえば、ダンプの作成元が 4.4 を実行中のMongoDB 配置であった場合、復元先となる MongoDB 配置でも、バージョン 4.4 を実行しているか、FCV を 4.4 に設定している必要があります。

To change your feature compatibility version, see setFeatureCompatibilityVersion.

さらに、データファイルの読み込みに使用する mongorestore のバージョンが、それらの作成に使用した mongodump のバージョンと同じであることを確認してください。実際には、異なるバージョンの mongorestore を使用しても機能することが多いですが、バージョン間でダンプ形式が変更されると、復元が失敗したり、データが正しく復元されなかったりする可能性があります。例として、mongodump バージョン 100.19.1 を使用してダンプを作成した場合は、mongorestore バージョン 100.19.1 を使用して復元します。

時系列コレクション

To dump time series collections from a MongoDB 9.0 deployment, use Database Tools 100.16.0 or later. Earlier Database Tools versions read time series bucket namespaces directly, which MongoDB 9.0 doesn't allow. If you use an earlier Database Tools version, mongodump aborts with a CommandNotSupportedOnLegacyTimeseriesBucketsNamespace error. To resolve the error, upgrade to the latest Database Tools version.

mongodump が時系列コレクションを読み込んでいる間に時系列形式変換が開始すると、InterruptedDueToTimeseriesUpgradeDowngrade エラーで操作が失敗します。ダンプは切り据てられたり、破損したりしません。エラーを解決するには、機能の互換性バージョン (FCV) の変更が終了するまで待ち、その後、mongodump を再度実行します。変換の詳細については、「時系列形式変換における oplog リプレイ」を参照してください。

読み込み設定 (read preference)

By default, mongodump uses read preference primary. To override the default, you can specify the read preference in the --readPreference command-line option or in the --uri connection string.

URI string と--readPreferenceオプションの両方で読み取り設定が指定されている場合、 --readPreferenceの値が URI string で指定された読み取り設定よりも優先されます。

データの除外

--db } オプションと--collectionオプションの両方を指定すると、 mongodumpは指定されたコレクションをダンプします。

--dbオプションのみを指定すると、 mongodumpはそのデータベースを次の除外でダンプします。

• --dbの値がadminの場合:

  • Atlas プロキシに接続していない場合、 mongodumpはデータベースをダンプしますが、 system.keysコレクションは除外されます。

  • Atlas プロキシに接続している場合、 mongodumpはデータベースをダンプしようとしますが、エラーが発生します。

• --dbの値がconfigの場合、 mongodumpはそのデータベース内のすべてのコレクションをダンプします。

• --dbの値がlocalの場合、 mongodumpはそのデータベース内のすべてのコレクションをダンプします。

• 他のすべてのデータベースでは、 mongodumpはsystem.で始まるすべてのコレクションを除外します（ system.jsを除く）。

--dbオプションを省略すると、次の除外が適用されます。

• mongodump localデータベースを除外します。

• mongodump では、 configデータベースの出力に次のコレクションのみが含まれます。

  • chunks

  • collections

  • databases

  • settings

  • shards

  • tags

  • version

• Atlas プロキシに接続している場合、 mongodumpはadminデータベースを除外します。

mongodump output:

• データベース内のドキュメントとインデックス定義が含まれます。

• インデックス データは含まれません。

mongorestore or mongod must rebuild the indexes after restoring data.

If you're using views:

• デフォルトでは、 mongodumpはビューのメタデータのみをエクスポートします。 mongodumpでは、ビューに含まれるドキュメントのバイナリ エクスポートは作成されません。

• ビュー内のドキュメントをエクスポートするには、 --viewsAsCollectionsを使用します。

Metadata Output

mongodumpの出力がディレクトリに出力される場合、出力には次のプロパティを含むコレクション メタデータが含まれます。

• コレクション名

• コレクションの種類

• コレクション構成オプション

• UUID

• Indexes

mongodumpの出力が標準出力（ stdout ）に出力される場合、出力にはメタデータは含まれません。 詳しくは、 --outオプションを参照してください。

Metadata Format

mongodump uses Extended JSON v2.0 (Canonical) format for the metadata files. To parse these files for restore, use mongorestore, which supports Extended JSON v2.0 (Canonical or Relaxed mode) format.

ファイルの上書き

mongodump はバックアップ データ フォルダーに出力ファイルがある場合は、そのファイルを上書きします。 mongodumpコマンドを複数回実行する前に、出力フォルダー（デフォルトはdump/フォルダー）のファイルが不要であることを確認するか、フォルダーまたはファイルの名前を変更してください。

mongodump リシャーディング中

mongodump 次の場合に失敗します。

• mongodump は、再シャーディング操作の進行中に開始されます。

• The reshardCollection command is run during a mongodump operation.

データ圧縮処理

When run on a mongod instance that uses the WiredTiger storage engine, mongodump outputs uncompressed data.

ワーキングセット

mongodump は、 mongodのパフォーマンスに悪影響を与える可能性があります。 データがシステムメモリより大きい場合、 mongodumpはワーキングセットをメモリからプッシュします。

FIPS

mongodump は、 FIPS モードを使用するように構成されたmongodまたはmongosへの FIPS 準拠の接続を自動的に作成します。

Atlas の無料階層クラスターと共有階層クラスターでの mongodump の使用

無料（M0）層および共有（M2 と M5）層の Atlas クラスターでは、次の制限が適用されます。

• adminデータベースではmongodumpを実行できません。 デフォルトでは、 mongodumpはこのデータベースをスキップします。 --dbオプションを使用して宛先データベースをadminに設定すると、プログラムはエラーを返します。

• mongodump プログラムでは、次のオプションは使用できません。

  • --dumpDbUsersAndRoles

  • --oplog

Atlas Infinite データベースクラスターでのmongodumpの使用

mongodump Atlas Infinite Database クラスターからデータをダンプするとき、--oplog オプションをサポートしています。oplog リプレイは Atlas Infinite データベース クラスターではサポートされていません。詳細については、「mongorestore の動作、アクセス、使用方法」を参照してください。

スタンドアロン配置とレプリカセット

For standalone or a replica set, mongodump can be a part of a backup strategy with mongorestore for partial backups based on a query, syncing from production to staging or development environments, or changing the storage engine of a standalone.

バックアップおよび復旧戦略の一環としてmongorestoreとmongodumpを使用する方法の詳細については、以下をご覧ください。

• MongoDB ツールを使用したバックアップと復元

• MongoDB バックアップ メソッド

シャーディングされたクラスター

To use mongodump and mongorestore as a backup strategy for sharded clusters, see Back Up a Self-Managed Sharded Cluster with a Database Dump.

シャーディングされたクラスターではバックアップと復元に次のいずれかの連携的なプロセスも利用できます。これにより、書込みを受け入れながらシャード間のアトミック性が保証されます。

• MongoDB Atlas

• MongoDB Cloud Manager

• MongoDB Ops Manager