AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

1 つのデータベースまたはコレクションの復元

スナップショットから単一のデータベースまたはコレクション(または特定のドキュメント)を復元するには、クエリ可能なバックアップを使用して単一のデータベースまたはコレクションをエクスポートし、ターゲットの配置に復元します。

復元を試みる前に、ターゲット配置のホストに復元ファイルと復元されたデータベースの十分なストレージ領域があること、およびデータセットの増加に対応する追加領域があることを確認してください。db.stats()を使用して現在のデータベースサイズを検索します。

重要

MongoDB Database Toolsの最新バージョン( mongodumpとmongorestoreを含む)を使用します。 mongoshの最新バージョンを使用します。

mongodump の古いバージョンには、コレクションオプション内のキーが間違った順序でダンプされる可能性がある問題が含まれています。詳しくは、 TOOLS-3411 を参照してください。

You can use a queryable backup snapshot to export data for a database or a collection and restore to the target deployment. The following procedure connects to the queryable backup instance via Cloud Manager-provided tunnel [1].

1

クエリするバックアップの配置で、Optionsの下のをクリックし、Query を選択します。

配置をクリックしてスナップショットを表示し、Actions 列の下にある Query ボタンをクリックすることもできます。

2
  1. クエリするスナップショットを選択し、[Next] をクリックします。

  2. Start スナップショットをクエリするプロセス。2 要素認証を求められます。

  3. Select Backup Tunnel as the connection method to the queryable snapshot. [1]

  4. プラットフォームを選択してダウンロードします。

  5. ダウンロードしたファイルを解凍します。

    注意

    クエリ可能なスナップショットがマウントされるまで待ってから続行します。 スナップショットのマウント時間は、スナップショットのサイズによって異なります。 スナップショットがマウントされていることを確認するには、以下を行います。

    1. MongoDB Cloud Managerで、プロジェクトの Continuous Backup ページにGoします。

      1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

      2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

      3. サイドバーで、 Database見出しの下のContinuous Backupをクリックします。

      [継続的なバックアップ ]ページが表示されます。

    2. Restore History タブを選択します。

    スナップショットがマウントされると、 Status列はマウント操作の日時を報告します。

  6. ターミナルまたはコマンド プロンプトを開き、解凍された <tunnel> ディレクトリに移動します。実行可能ファイルを実行してトンネルを開始します。

    トンネルのデフォルト ポートは27017です。 ポートを変更するには、次の例のように--localフラグを使用します。

    ./<tunnel executable> --local localhost:27020

    注意

    ポートを変更する場合は、接続時にポート情報を含める必要があります。

3

データベースのデータをエクスポートするには、

トンネルに接続するには、次のmongodumpオプションを含めます。[1]

  • --port トンネルのポートに設定

  • --db エクスポートするデータベースの名前に設定

  • --out 空のディレクトリに設定して、データ ダンプを出力します。

    重要

    mongodumpを実行しているユーザーが指定されたディレクトリに書込みできるようにします。

mongodump --port <port for tunnel> --db <single-database> --out <data-dump-path>

例

ポート 27020 で動作しているトンネルに接続して test データベースから /mydata/restoredata/ ディレクトリにデータをダンプするには、

mongodump --port 27020 --db test --out /mydata/restoredata/

mongodumpはtestデータベースファイルを/mydata/restoredata/test/ディレクトリに出力します。

mongodumpがPATHにない場合は、ツールのパスを指定します。

コレクションのデータをエクスポートするには、

include the following options to connect to the tunnel [1]:

  • --port トンネルのポートに設定します。

  • --db エクスポートするデータベースの名前に設定します。

  • --collection 単一のコレクション用。

  • --out 空のディレクトリに設定して、データ ダンプを出力します。

    重要

    mongodumpを実行しているユーザーが指定されたディレクトリに書込みできるようにします。

mongodump --port <port for tunnel> \ --db <single-database> \ --collection <collection-name> \ --out <data-dump-path>

例

ポート 27020 で動作しているトンネルに接続して restaurants コレクションのデータを test データベースから /mydata/restoredata/ ディレクトリにダンプするには、

mongodump --port 27020 \ --db test \ --collection restaurants \ --out /mydata/restoredata/

mongodumpはrestaurantsコレクション データを/mydata/restoredata/test/restaurants.bsonファイルに出力します。

4

単独のデータベースを復元するには、

次のmongorestoreオプションを含めます。

  • --port 宛先クラスターのポートに設定します。

  • --db 宛先データベースの名前に設定します。

オプションとして、データベースがすでに存在する場合は、宛先クラスター内のデータベースを削除するために--dropを含めることができます。

mongorestore --port <port> --db <destination database> <data-dump-path/database> --drop

たとえば、/mydata/restoredata/test ディレクトリから新しいデータベース restoredTest に復元するには、次のように行います。

mongorestore --port 27017 --db restoredTest /mydata/restoredata/test --drop

この例では、宛先レプリカセットのプライマリまたは宛先シャーディングされたクラスターのmongosがポート27017でリッスンしている ことを前提としています。

単独のコレクションを復元するには、

次のmongorestoreオプションを含めます。

  • --port 宛先クラスターのポートに設定します。

  • --db 宛先データベースの名前に設定します。

オプションとして、コレクションがすでに存在する場合は、宛先クラスター内のコレクションを削除するために--dropを含めることができます。

mongorestore --port <port> --db <destination database> --collection <collection-name> <data-dump-path/dbname/collection.bson> --drop

たとえば、/mydata/restoredata/test/restaurants.bson データ ファイルから test2 データベース内の新しいコレクション rest2 に復元するには、次のように行います。

mongorestore --port 27017 --db test2 --collection rest2 /mydata/restoredata/test/restaurants.bson --drop

この例では、宛先レプリカセットのプライマリまたは宛先シャーディングされたクラスターのmongosがポート27017でリッスンしている ことを前提としています。

5

終了したら、クエリ可能なインスタンスを終了できます。

  1. Restore History を開き、配置アイテムの Status 列にカーソルを合わせます。

  2. [Cancel] をクリックします。

[1](1, 2, 3, 4) Alternatively, instead of connecting via the tunnel, you can connect directly to the queryable backup, using the X.509 PEM files provided. If connecting directly to the queryable backup, you must specify the hostname and port, the TLS/SSL option, and the X.509 certificates.

重要

AES256-GCM で暗号化されたスナップショット復元後のマスター キー ローテーション

Cloud Manager が AES256 -GCM を使用して 暗号化されたスナップショット を復元する場合は、復元の完了後に マスターキーをローテーションします 。