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

バックアップ スナップショットのクエリ

MongoDB Ops Managerは、クエリ可能なバックアップを提供します。 この機能を使用すると、特定のバックアップ スナップショットをより迅速にクエリできます。 クエリ可能なバックアップを使用すると、次のことが可能になります。

  • MongoDB 配置内のデータのサブセットを復元します。

  • 前のバージョンのデータを現在のデータと比較します。

  • 複数のスナップショットのデータを比較して、システムを復元するのに最適なポイントインタイムを特定します。

MongoDB Ops Manager は、これらのクエリ可能なスナップショットを読み取り専用のMongoDB インスタンスとしてプロビジョニングします。具体的には、MongoDB Ops Manager は選択したスナップショットストアのデータを使用してmongodを起動します。

重要

デフォルトでは、これらのインスタンスは最大 24 時間利用できます。 Expiration (Hours)を使用して期間を設定できます。 その他のクエリ可能なバックアップ設定については、「 クエリ可能なスナップショット構成 」を参照してください。

クエリ可能なスナップショットでは、次の操作は実行できません。

スナップショットに名前空間フィルターを適用した場合、そのスナップショットをクエリすることはできません。

ファイル システム ストア に 圧縮 されているスナップショットはクエリできません。この制限は、ブロックストアまたは S3 互換のストレージ互換スナップショット ストアに保存されている圧縮されたスナップショットには適用されません。これらはストレージ形式の一部として圧縮を使用します。

機能の互換性バージョン 4.2 以降を実行している MongoDB データベースの場合、MongoDB Ops Manager はバックアップをファイルシステムストアに圧縮せず、File System Store Gzip Compression Level 設定を無視します。

ファイル システム 保存 (する)のスナップショットに圧縮が適用されている場合は、圧縮を無効にして新しいファイル システム 保存 (する)を作成し、今後のバックアップをそこに割り当てます。

これらのインスタンスへの接続は、TLS を介して行われ、x.509 認証が必要です。MongoDB Ops Manager は、次の機能を提供します。

  • クライアント TLS と x.509 認証を含む接続を取り扱う トンネル を作成する実行可能ファイル。

    リクエストはトンネルを介してルーティングされます。トンネルは、リクエストが正しいmongodインスタンスに伝播するようにします。

  • 接続詳細を手動で取り扱いたい場合は、TLS と x.509 認証を含む x.509 証明書が必要です。

    リクエストは、 mongodへのプロキシとして機能するウェブ サーバーを介して送信されます。

マルチリージョンバックアップを有効にした場合 、リージョン間でのデータ転送を防ぐために、クエリ可能なバックアップはクラスターレベルで無効になります。 シャードやコンフィギュレーションサーバーなどのクラスター ノードを、異なる配置リージョンに関連付けることができます。 これにより、 MongoDB Ops Managerはすべてのクラスターレベルのクエリをコンフィギュレーションサーバーの bqProxyEndpoint を介してルーティングできるようになります。 クラスターレベルでクエリ可能なバックアップを有効にするには、 /opt/mongodb/mms/conf/conf-mms.propertiesファイルでmms.backup.enableClusterLevelMultiRegionQueryableをtrueに設定します。 デフォルトでは、このアプリ設定の値はfalseです。

注意

シャードまたはコンフィギュレーションサーバーを直接クエリしても、リージョン間でのデータ転送は発生しません。

シャーディングされたクラスターでリージョンバックアップを有効にする場合は、リージョンデータの分離を確保するために、シャードごとにクエリ可能な復元ジョブを開始する必要があります。 配置リージョンはシャーディングされたクラスターではなく個々のシャードにバインドされるため、シャーディングされたクラスター レベルで復元ジョブを開始すると、 MongoDB Ops Managerはデータ分離を保証できません。

重要

クエリ可能なバックアップ インスタンスに自分のワークステーションから接続するには、MongoDB Database Toolsの最新バージョン( mongodumpとmongorestoreを含む)と、mongoshの最新バージョンを使用します。

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

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

4.2.9 以降を実行している場合は、 ローカル モード を使用して暗号化されたスナップショットをクエリできます。MongoDB Ops ManagerMongoDB Enterprise

CSRS がMongoDB3.2 以降を実行している場合、 レプリカセット または シャーディングされたクラスター から作成されたスナップショットをクエリできます。

クエリ可能なバックアップを成功させるには、復元のターゲットである MongoDB インスタンスが互換性のある MongoDB バージョンを実行している必要があります。 次の表は、各配置タイプと MongoDB バージョンの互換性要件を示しています。

スナップショット データ MongoDB バージョン
ターゲット データベースに互換性のある MongoDB バージョン
プラットフォーム

8.0.x

8.0.xEnterprise 以降

Any

7.0.x

7.0.xEnterprise 以降

Any

6.0.x

6.0.0 Enterprise 以降

Any

5.0.x

5.0.0 Enterprise 以降

Any

4.4.x

4.4.0 Enterprise 以降

Any

スナップショット データ MongoDB バージョン
ターゲット データベースに互換性のある MongoDB バージョン
プラットフォーム

8.0.x

8.0.xEnterprise 以降

Any

7.0.x

7.0.0 Enterprise 以降

Any

6.0.x

6.0.0 Enterprise 以降

Any

5.0.x

5.0.0 Enterprise 以降

Any

4.4.x

4.4.0 Enterprise 以降

Any

重要

Transport Layer セキュリティ 、 公開キー基盤 X .509 証明書、 証明機関の 詳細な説明は このチュートリアルの範囲を超えています。このチュートリアルでは、 TLS に関する事前の知識と、有効な X.509 証明書にアクセスできることを前提としています。

MongoDB Ops Managerでは、クエリ可能なバックアップの使用を認証および認可するために別のPEMファイルが必要です。 このPEMファイル:

  • MongoDB Ops Managerプロセスを所有するのと同じプラットフォームユーザーとグループに属している必要があります。 Linuxでは、mongodb-mms:mongodb-mms ユーザーとグループがこの PEMファイル を所有します。

  • プラットフォーム ユーザーのみが読み取れる必要があります。

  • MongoDB Ops Manager へのHTTPS接続に使用されるものとは異なる必要があります( HTTPS PEM Key File )。

  • 512 ビットを超えるキー長を使用する必要があります。 2048 ビット RSA キーの使用が推奨されます。

  • は、 sha256など、 sha1よりも強力なメッセージ ダイジェストを使用する必要があります。

PEMファイルは少なくとも次の要素で構成されています。

  • サーバー証明書とキーのペア、および

  • 証明機関の証明書

これらのペアはマージされて、クエリ可能なバックアップで使用できるPEMファイルが作成されます。 ペアには次の要件があります。

証明機関は、PEM ファイルで使用される他の証明書とキーに署名する必要があります。 認証局は、次のいずれかになります。

選択した証明機関は、このサーバー証明書に署名する必要があります。

サーバー証明書とキーのペアのコモンネーム設定は、 MongoDB Ops Managerの配置で使用されるホストの数によって異なります。

  • 単一の MongoDB Ops Manager ホストの場合、ペア内のサブジェクト代替名(SAN)は、MongoDB Ops Manager ホストのFQDNと一致する必要があります。

  • 高可用性の場合、ペア内の SAN は、ロードバランサー URL の FQDN と一致する必要があります。

サーバー証明書とキーのペアと証明書チェーンを連結して、プロキシ サーバー PEM キーを作成します。

クエリ可能なバックアップ ホストの場合、 Proxy Server PEM File設定を使用して PEM ファイル(公開鍵証明書とそれに関連付けられた秘密キーの両方を含む)の場所を指定する必要があります。 クエリ可能なバックアップ設定をまだ設定していない場合は、次の手順に従います。

  1. 右上隅のAdminをクリックします。 Admin画面からGeneralをクリックしますOps Manager Config Backup 。

  2. Queryable Snapshot ConfigurationProxy Server PEM Fileまでスクロールし、トンネルまたはクライアントがクエリ可能なmongod インスタンスに接続するために使用できるを指定します。

    ファイルが暗号化されている場合は、 Proxy Server PEM File Passwordを指定します。

  3. 任意。 その他のクエリ可能なスナップショット設定を必要に応じて更新します。 設定の説明については、「 クエリ可能なスナップショット構成 」を参照してください。

    注意

    次の設定のいずれかを変更する場合は、Web サーバーを再起動する必要があります。

アプリサーバーでは、クエリ可能なバックアップスナップショットの通信に対してポート 27700 ~ 27719 がオープンである必要があります。

ロードProxy Server Port バランサーを使用する場合、. の値を介して TCP 接続を渡す必要があります。

ポート要件の詳細については、「ファイアウォール構成 」を参照してください。

シャーディングされたクラスターのスナップショットをクエリするには、バックアップデーモンは少なくとも コンフィギュレーションサーバー 用に 1 つのワーカー、各シャードごとに 1 つのワーカー、 mongosインスタンス用に 1 つのワーカーが必要です。

レプリカセットのスナップショットをクエリするには、バックアップデーモンにはレプリカセットに対して少なくとも 1 つのワーカーが必要です。

例えば、 1シャード ルーター( mongos )を使用して3シャードクラスターからクエリ可能なバックアップを復元する場合、この値は少なくとも5である必要があります。

  • シャードあたり 1( 3 )+

  • コンフィギュレーションサーバーの 1( 1 ) +

  • 1 mongos

クエリ可能なバックアップが開始されると、バックアップデーモンはこれらのコンポーネントを管理するために 5 つ以上のワーカーを起動します。

クエリ可能なバックアップ用の` `をホストする`mongod FQDNDaemons `は、 ページに見つかるものと一致する必要があります。そのホスト名を見つけるには、Admin リンクをクリックし、次に Backup をクリックし、そして Daemons をクリックします。

Ops Manager がインターネットに接続できる場合は、Backup Versions Auto Download Enterprise Builds を TRUE に設定します。クエリ可能なバックアップ には MongoDB Enterprise が必要です。

注意

トンネルは、インスタンスへの接続のためのセキュリティ(〈dfn class=""〉TLS〈/dfn〉と x.509 認証)を取り扱います。

1

クエリするバックアップの配置で、 Options列の下の省略記号 ボタンをクリックし、 Queryを選択します。

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

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

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

  3. クエリ可能なスナップショットへの接続方法としてBackup Tunnelを選択します。

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

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

    注意

    クエリ可能なスナップショットがマウントされるまで待ってから続行します。 スナップショットのマウント時間は、スナップショットのサイズによって異なります。 スナップショットがマウントされていることを確認するには、 Continuous Backupに移動し、 Restore Historyタブを選択します。 スナップショットがマウントされると、 Status列はマウント操作の日時を報告します。

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

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

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

    注意

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

    トンネルに渡すことができるオプションの完全なリストについては、 -hオプションを使用して実行可能なトンネルを実行してください。

    ./<tunnel executable> -h
  7. トンネル経由でバックアップに接続するには、 mongoshまたは MongoDB ドライバーを使用します。

    • トンネルが実行されているマシンと同じマシンからローカルに接続する場合は、接続stringやホスト情報を指定する必要はありません。 それ以外の場合は、トンネルが実行中のマシンの接続stringまたはホスト情報を指定します。

    • トンネルがリッスンしているポートを変更した場合は、接続時にポート情報を指定する必要があります。

Tip

このスナップショットのクエリが終了したら、クエリ可能なインスタンスを終了できます。

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

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

注意

クエリ可能なバックアップmongodインスタンスのログファイルを見つけるには、バックアップデーモンホストのヘッドディレクトリにある次のパスに移動します。

<daemon-hostname>:/<headDirectory>/queryable/<backupId>/mongod.log

重要

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

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

注意

クライアントの X.509 証明書の有効期間は、クエリ可能なインスタンスExpiration (Hours)と同じで、デフォルトでは 24 時間です。

1

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

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

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

  2. Start スナップショットをクエリするプロセス。 パスワードの入力を求められた場合は、パスワードを入力して確認します。

  3. クエリ可能なスナップショットへの接続方法としてConnect Manuallyを選択します。

  4. X.509 クライアント PEM ファイルをダウンロードします。

  5. 認証局 PEM ファイルをダウンロードします。

    注意

    クエリ可能なスナップショットがマウントされるまで待ってから続行します。 スナップショットのマウント時間は、スナップショットのサイズによって異なります。 スナップショットがマウントされていることを確認するには、 Continuous Backupに移動し、 Restore Historyタブを選択します。 スナップショットがマウントされると、 Status列はマウント操作の日時を報告します。

  6. mongosh または MongoDB ドライバーを使用して、クエリ可能なバックアップ ホストに接続します。接続するには、ホスト名とポート、TLS オプション、および X.509 証明書を指定する必要があります。

    例

    mongoshを使用してインスタンスに接続する場合:

    mongosh my-queryable-backup-host.mongodb.com:27217 \ --tls --tlsCertificateKeyFile <client certificate> \ --tlsCAFile mms-backup-ca.pem

Tip

このスナップショットのクエリが終了したら、クエリ可能なインスタンスを終了できます。

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

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

重要

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

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

クエリ可能なバックアップの MongoDB インスタンスを使用してデータベースまたはコレクションを復元するには、「 クエリ可能なバックアップからデータベースまたはコレクションを復元する 」を参照してください。