Atlas Infinite クラスターへのデータのロード

ソース配置でデータベースユーザーを設定します。

復元元で認証 が強制される場合、mongodump は、移行するすべてのデータベースを読み取りできるデータベースユーザーとして認証を受ける必要があります。backup データベースのadmin ロールはこれらの特権を付与します。

ソース配置にそのようなユーザーが存在しない場合は、作成します。データベースユーザーを作成および管理する方法については、ご使用の配置タイプの次のページを参照してください。

• Atlas が管理するクラスターについては、 「データベースユーザーの設定」 を参照してください。

• 自己管理型型配置については、「 自己管理型配置でユーザーとロールの管理 」を参照してください。

宛先 Atlas Infinite クラスターに、データベースユーザーを設定します。

mongorestoreは、移行するすべてのデータベースに書き込みができるデータベースユーザーとして認証する必要があります。宛先 Atlas Infinite クラスターのAtlas admin ロールは、これらの特権を付与します。

宛先 Atlas Infinite クラスターにそのようなユーザーが存在しない場合は、作成します。 Atlas でデータベースユーザーを作成および管理する方法については、「 データベースユーザーの構成 」を参照してください。

ホストにソースと宛先の配置へのネットワーク アクセスを許可します。

mongodumpとmongorestore を実行するホストが両方の配置にアクセスできることを確認します。

• 宛先 Atlas Infinite クラスターを含むプロジェクトのIP アクセス リストにホストを追加します。 IP アクセス リストにホストを追加する方法については、 「 IPアクセス リスト エントリの設定 」を参照してください。

• ソース配置が別のプロジェクトの Atlas Core クラスターである場合は、そのプロジェクトのIP アクセス リストにもホストを追加します。ソース配置が自己管理型の場合は、ホストからの接続を受け入れるようにファイアウォールを構成します。詳しくは、「 ネットワークと構成の強化 」を参照してください。

VPCピアリングを設定する場合は、ピアのVPC CIDR ブロックまたはサブネット、またはピアVPCのセキュリティ グループをIP アクセス リストに追加できます。詳細については、 「 IPアクセス リスト 」を参照してください。

mongodumpを実行します。

1. mongodumpコマンドをアセンブルします。

   次の mongodump コマンド テンプレートは、 接続文字列を使用してソースレプリカセットまたはスタンドアロンクラスターに接続し、ダンプのアーカイブをファイルに出力します。

   テンプレートをテキストエディタにコピーし、<connectionString> プレースホルダーをソース配置の接続文字列に、<fileName> を作成するアーカイブファイルの名前に置き換えます。

   mongodump --uri "<connectionString>" --archive=<fileName>.archive

   ソース配置用の接続文字列を作成する方法については、「 接続文字列 」を参照してください。

   注意

   mongodumpmongorestoreUbuntu. で18 または04 cannot unmarshal DNSを使用している場合、SRV 接続文字列（mongodb+srv:// 形式）を オプションとともに使用すると、 エラー--uri メッセージが表示されることがあります。その場合は、次のいずれかのオプションを代わりに使用します。

   • --uri非 SRV接続文字列（ mongodb://形式）と オプション

   • 直接接続するホストを指定するための--hostオプション

2. ソース配置へのネットワークアクセスを持つホスト上のターミナルまたはコマンドプロンプトから、完了したコマンドを実行します。

   例

   次の mongodump コマンドは、 SRV接続文字列を使用してソース Atlas Core クラスターに接続します。この文字列には、admin で backup ロールを持つデータベースユーザーのユーザー名（mySourceUsername）とパスワード（mySourcePassword）が含まれています。データベース。このコマンドは、現在の 作業ディレクトリ内の mongodump.archive という名前のファイルにダンプのアーカイブを出力します。

   mongodump --uri "mongodb+srv://mySourceUsername:mySourcePassword@cluster0.example.mongodb.net" \
             --archive="mongodump.archive"

mongorestoreを実行します。

1. mongorestoreコマンドをアセンブルします。

   次のmongorestore コマンド テンプレートは、接続文字列を使用して宛先の Atlas Infinite クラスターに接続し、 によって作成されたアーカイブを復元します。mongodump --nsExcludeadminconfigAtlas が管理する データベースと データベースを除外するには、 を使用します。

   テンプレートをテキストエディタにコピーし、次のプレースホルダーを適切な値に置き換えます。

   • <connectionString>: これを、宛先 Atlas Infinite クラスターの SRV接続文字列に置き換えます。宛先クラスターの接続文字列を検索または作成するには、「 接続文字列 」を参照してください。

     Atlas admin接続文字列に ロールを持つデータベースユーザーのユーザー名とパスワードを含めます。

   • <filePath>: これをmongodump が作成したアーカイブファイルへのパスに置き換えます。

   注意

   ユーザー名またはパスワードに次の文字が含まれている場合、それらをパーセント エンコーディングを使用して変換する必要があります。

   $ : / ? # [ ] @

   mongorestore --uri "<connectionString>" \
                --archive="<filePath>" \
                --nsExclude "admin.*" \
                --nsExclude "config.*"

2. によって作成されたアーカイブファイルにアクセスできるホストで、ターミナルまたはコマンドmongodump プロンプトから完了したコマンドを実行します。

   例

   次のmongorestore コマンドは、 SRV接続文字列を使用して Atlas InfinitemyDestinationUsername myDestinationPasswordクラスターに接続します。この文字列には、Atlas admin ロールを持つデータベースユーザーのユーザー名（ ）とパスワード（ ）が含まれています。このコマンドは、 データベースとmongodump.archive mongodumpデータベースを除き、 によって作成されたadmin configのアーカイブを復元します。

   mongorestore --uri "mongodb+srv://myDestinationUsername:myDestinationPassword@cluster0.example.mongodb.net" \
             --archive="mongodump.archive" \
             --nsExclude "admin.*" \
             --nsExclude "config.*"

移行 を確認します。

移行が完了したら、Atlas Infinite クラスターに接続し、データが正常に移行されたことを確認します。クエリを実行して、宛先クラスターにコレクションとドキュメントが存在することを確認できます。

アプリケーションを更新して、Atlas Infinite クラスターを点ようにします。

移行を確認した後、アプリケーションを更新して、ソース配置ではなく Atlas Infinite クラスターに接続します。 Atlas Infinite クラスターに正しい接続文字列と認証情報を使用していることを確認します。

Atlas で、プロジェクトの Database & Network Access ページに移動します。

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

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

3. サイドバーで、 Security見出しの下のDatabase & Network Accessをクリックします。

データベース &上記の手順を完了すると、[ ネットワーク アクセス ] ページが表示されます。

宛先 Atlas クラスターに、データベースユーザーを設定します。

mongoimportを実行して Atlas クラスターに書き込むには、データをインポートするデータベースで 読み取り / 書き込み 特権を持つデータベースユーザーを指定する必要があります。例、Atlas admin ロールを持つユーザーにはこれらの特権が付与されます。

そのようなユーザーが存在しない場合は、ユーザーを作成します。

1. まだ表示されていない場合は Database Users タブをクリックします。

2. Add New Database User をクリックします。

3. Atlas admin ユーザーを追加します。

Atlas で、プロジェクトの Clusters ページに移動します。

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

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

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

[ Clusters （クラスター） ] ページが表示されます。

[Connect] をクリックします。

データを移行する Atlas クラスターのConnectをクリックします。

IP アクセス リストを更新します。

mongoimportを実行するホストがIPアクセス リストにない場合は、更新します。次のいずれかを指定できます。

• mongoimport が実行されるサーバーのパブリック IP アドレス、または

• VPC ピアリングを設定する際、クラウドプロバイダーとして AWS を選択した場合、ピア VPC の CIDR ブロック（またはサブネット）またはピア VPC のセキュリティグループのいずれかとなります。

宛先クラスターの URI / ホスト情報をコピーします。

Atlasクラスターには、 接続文字列 URIを使用して接続できます。 接続ダイアログボックスで、次の手順を実行します。

1. [Drivers] をクリックします。

2. 手順 1 で見つかった接続文字列をコピーします。

3. PASSWORD を root ユーザーのパスワードに置き換え、DATABASE を接続先のデータベースの名前に置き換えます。

   重要

   提供された <PASSWORD> 内の@ 文字をすべてエスケープする必要があります。たとえば、p@ssword は p%40ssword にする必要があります。

この接続文字列は、mongoimport --uriオプションで に指定されます。

--host を使用する際、Atlas クラスターがレプリカセットである場合は、レプリカセット名も取得する必要があります。例:

myAtlasRS/atlas-host1:27017,atlas-host2:27017,atlas-host3:27017

mongoimport を実行します。

Atlas Infinite クラスターに接続します。

この手順の一括書き込み操作を実行するには、mongosh を使用してクラスターに接続します。方法については、「 Atlas クラスターへの接続 」を参照してください。

また、 MongoDBドライバーを使用したアプリケーションコード、Atlas UI、またはクラスターに接続するその他のインターフェースから、一括書き込み操作を実行することもできます。各インターフェースで同等の操作の詳細については、「 一括書込み操作 」を参照してください。

一括書込み (write)操作を実行します。

単一のコレクションに書き込むには、bulkWrite() を実行します。書込み操作の種類と一括書込みオプションの詳細については、bulkWrite() を参照してください。

例、次のコマンドは、2 つのドキュメントを inventoryコレクションに挿入します。

db.inventory.bulkWrite( [
   { insertOne: { document: {
      _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f1"),
      item: "notebook",
      qty: 50
   } } },
   { insertOne: { document: {
      _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f2"),
      item: "pencil",
      qty: 100
   } } }
] )

1 回のリクエストで複数のコレクションまたはデータベースに書き込むには、 を実行し、各操作の名前空間を指定します。例、次のコマンドは、 コレクションに 1bulkWrite() つのドキュメントを挿入し、sales.inventory コレクションに 2 つのドキュメントを挿入します。supplies.inventory

db.getMongo().bulkWrite( [
   {
      namespace: "sales.inventory",
      name: "insertOne",
      document: { item: "notebook", qty: 50 }
   },
   {
      namespace: "supplies.inventory",
      name: "insertOne",
      document: { item: "pencil", qty: 100 }
   }
] )

デフォルトでは 、一括書き込み操作は順番に実行され、最初のエラーで停止します。実行順序の構成方法については、「 操作の実行 」を参照してください。

結果を確認します。

操作によって返されるカウントを確認し、各 ターゲットコレクション内のドキュメント数を確認します。詳細については、「 出力 」を参照してください。

一括書き込み操作のエラーを処理する方法については、「 エラー処理 」を参照してください。