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 を参照してください。

MongoDB Ops Manager を ローカル モードで実行する場合は、最新のバージョンではなく、MongoDB Ops Manager リリースの Database Tools 互換性テーブル に記載されているバージョンをインストールします。

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 Ops 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. ダウンロードしたファイルを解凍します。

    注意

    クエリ可能なスナップショットがマウントされるまで待ってから続行します。 スナップショットのマウント時間は、スナップショットのサイズによって異なります。 スナップショットがマウントされていることを確認するには、 Continuous Backupに移動し、 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 で暗号化されたスナップショット復元後のマスター キー ローテーション

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