ApsaraDB for MongoDB:DTS を使用して自己管理スタンドアロン MongoDB データベースを ApsaraDB for MongoDB に移行する

MongoDB ツールを使用して、自己管理データベースをスタンドアロンインスタンスに移行することもできます。 詳細については、「MongoDB ツールを使用して自己管理データベースをスタンドアロンインスタンスに移行する」をご参照ください。

データ移行またはデータ同期ソリューションの詳細については、「データ移行と同期」をご参照ください。

準備

• 自己管理 MongoDB データベースと ApsaraDB for MongoDB でサポートされているバージョンの詳細については、「移行ソリューションの概要」をご参照ください。

• ApsaraDB for MongoDB インスタンスのストレージ容量が、自己管理 MongoDB データベースが占有するストレージ容量より少なくとも 10% 大きいことを確認してください。

使用上の注意

• デフォルトでは、スタンドアロンアーキテクチャの自己管理 MongoDB データベースは oplog をサポートしていません。 DTS を使用して増分移行を実行するには、スタンドアロンインスタンスを単一ノードのレプリカセットとして設定して oplog を有効にする必要があります。

• サービスへの影響を避けるため、オフピーク時にデータを移行してください。

• config データベースは内部システムデータベースです。 必要でない限り、このデータベースは移行しないでください。

• ApsaraDB for MongoDB インスタンスでサポートされているバージョンとストレージエンジンの詳細については、「バージョンとストレージエンジン」をご参照ください。 バージョンやストレージエンジンをまたいでデータを移行するには、事前に互換性を確認してください。

• admin データベースと local データベースは、ソースデータベースまたはターゲットデータベースとして使用できません。

• DTS はデータを同時に書き込みます。 その結果、ターゲットデータベースはソースデータベースよりも 5% から 10% 多くのストレージ容量を使用する場合があります。

• ターゲット MongoDB インスタンスに、ソースデータベースと同じプライマリキー (_id) を持つドキュメントが含まれていないことを確認してください。 そうしないと、データ損失が発生する可能性があります。 ターゲットインスタンスにソースと同じプライマリキーを持つドキュメントがある場合は、移行を開始する前に、ターゲットインスタンスから競合するドキュメントを削除する必要があります。

課金

データベースアカウントに必要な権限

データベースアカウントを作成して権限を付与するには:

• 自己管理 MongoDB データベースについては、「MongoDB Create User ドキュメント」をご参照ください。

• ApsaraDB for MongoDB インスタンスについては、「DMS を使用して MongoDB データベースユーザーを管理する」をご参照ください。

手順

1. 次のいずれかの方法でデータ移行ページに移動し、データ移行インスタンスが存在するリージョンを選択します。

   DTS コンソール

   1. DTS コンソールにログインします。

   2. 左側のナビゲーションウィンドウで、データの移行 をクリックします。

   3. ページの左上隅で、データ移行インスタンスが存在するリージョンを選択します。

   DMS コンソール

   説明

   実際の操作は、DMS コンソールのモードとレイアウトによって異なる場合があります。 詳細については、「シンプルモード」および「DMS コンソールのレイアウトとスタイルをカスタマイズする」をご参照ください。

   1. DMS コンソールにログインします。

   2. 上部のナビゲーションバーで、ポインターを [データ + AI] > [DTS (DTS)] > [データ移行] の上に移動します。

   3. [データ移行タスク] の右側にあるドロップダウンリストから、データ同期インスタンスが存在するリージョンを選択します。

2. タスクの作成 をクリックして、タスク設定ページに移動します。

3. ソースデータベースとターゲットデータベースを設定します。 次の表にパラメーターを示します。

   警告

   ソースデータベースとターゲットデータベースを設定した後、ページの上部に表示される [制限] を読むことをお勧めします。 そうしないと、タスクが失敗したり、データの不整合が発生したりする可能性があります。

   カテゴリ	設定	説明
   N/A	タスク名	DTS タスクの名前。 DTS は自動的にタスク名を生成します。タスクを簡単に識別できるような、わかりやすい名前を指定することをお勧めします。一意のタスク名を指定する必要はありません。
   移行元データベース	既存の接続情報の選択	DTS に登録されているデータベースインスタンスを使用する場合は、ドロップダウンリストからインスタンスを選択します。DTS は、インスタンスの次のデータベースパラメーターを自動的に入力します。詳細については、「データベース接続の管理」をご参照ください。 説明 DMS コンソールでは、[DMS データベースインスタンスの選択] ドロップダウンリストからデータベースインスタンスを選択できます。 インスタンスを DTS に登録できない場合、または DTS に登録されているインスタンスを使用する必要がない場合は、次のデータベース情報を設定する必要があります。
   	データベースタイプ	[NoSQL データベース] > MongoDB を選択します。
   	アクセス方法	ソースデータベースのデプロイ場所に基づいてタイプを選択します。このトピックでは、例として パブリック IP アドレス を使用します。 説明 自己管理データベースに別の接続タイプを選択した場合は、対応する準備も実行する必要があります。
   	インスタンスのリージョン	自己管理 MongoDB データベースが配置されているリージョンを選択します。 説明 自己管理 MongoDB データベースのリージョンがリストにない場合は、地理的に最も近いリージョンを選択できます。
   	アーキテクチャ	レプリカセット を選択します。
   	移行方法	ソースデータベースから増分データを移行するために使用されるメソッド。ビジネス要件に基づいてメソッドを選択します。有効な値: Oplog (推奨): このオプションは、ソースデータベースで oplog 機能が有効になっている場合に使用できます。 説明 デフォルトでは、oplog 機能は自己管理 MongoDB データベースと ApsaraDB for MongoDB インスタンスの両方で有効になっています。この機能により、ログのプル速度が速いため、低レイテンシで増分データを移行できます。したがって、[移行方法] パラメーターには Oplog を選択することをお勧めします。 ChangeStream: このオプションは、ソースデータベースで変更ストリームが有効になっている場合に使用できます。詳細については、「Change Streams」をご参照ください。 説明 ソースデータベースが非弾力的な Amazon DocumentDB クラスターである場合、[移行方法] パラメーターは ChangeStream にのみ設定できます。 アーキテクチャ パラメーターに シャードクラスター を選択した場合、Shardアカウント および Shardパスワード パラメーターを設定する必要はありません。
   	エンドポイントのタイプ	シングルノード を選択します。 説明 この設定項目は、Express Connect、VPN Gateway、または Smart Access Gateway、パブリック IP アドレス、または Cloud Enterprise Network (CEN) を使用して自己管理 MongoDB データベースに接続する場合にのみ表示されます。
   	ドメイン名または IP アドレス	自己管理 MongoDB データベースのドメイン名または IP アドレスを入力します。この例では、パブリック IP アドレスを入力します。
   	ポート番号	自己管理 MongoDB データベースのサービスポートを入力します。
   	認証データベース	自己管理 MongoDB のデータベースアカウントが属するデータベースの名前を入力します。変更されていない場合、デフォルトは admin です。
   	データベースアカウント	自己管理 MongoDB の Mongos ノードのアカウントを入力します。権限要件については、「データベースアカウントに必要な権限」をご参照ください。 説明 自己管理 MongoDB の アクセス方法 が ECS 上の自己管理データベース または データベースゲートウェイ の場合は、シャードノードのアカウントを入力します。
   	データベースのパスワード	データベースインスタンスへのアクセスに使用されるパスワード。
   	暗号化	ソースデータベースへの接続を暗号化するかどうかを指定します。ビジネス要件に基づいて、非暗号化、SSL 暗号化、または Mongo Atlas SSL を選択できます。暗号化 パラメーターで使用できるオプションは、アクセス方法 および アーキテクチャ パラメーターに選択された値によって決まります。DTS コンソールに表示されるオプションが優先されます。 説明 [アーキテクチャ] パラメーターが [シャードクラスター] に設定され、ApsaraDB for MongoDB データベースの [移行方法] パラメーターが Oplog に設定されている場合、[暗号化] パラメーター SSL 暗号化 は使用できません。 ソースデータベースが レプリカセット アーキテクチャを使用する自己管理 MongoDB データベースであり、アクセス方法 パラメーターが Alibaba Cloud インスタンス に設定されておらず、[暗号化] パラメーターが SSL 暗号化 に設定されている場合、認証局 (CA) 証明書をアップロードしてソースデータベースへの接続を検証できます。
   移行先データベース	既存の接続情報の選択	DTS に登録されているデータベースインスタンスを使用する場合は、ドロップダウンリストからインスタンスを選択します。DTS は、インスタンスの次のデータベースパラメーターを自動的に入力します。詳細については、「データベース接続の管理」をご参照ください。 説明 DMS コンソールでは、[DMS データベースインスタンスの選択] ドロップダウンリストからデータベースインスタンスを選択できます。 インスタンスを DTS に登録できない場合、または DTS に登録されているインスタンスを使用する必要がない場合は、次のデータベース情報を設定する必要があります。
   	データベースタイプ	MongoDB を選択します。
   	アクセス方法	Alibaba Cloud インスタンス を選択します。
   	インスタンスのリージョン	ターゲットの ApsaraDB for MongoDB インスタンスが配置されているリージョンを選択します。
   	Alibaba Cloud アカウント間でデータを複製	この例では、現在の Alibaba Cloud アカウントのデータベースインスタンスが使用されます。× を選択します。
   	アーキテクチャ	ターゲットの ApsaraDB for MongoDB インスタンスのアーキテクチャタイプを選択します。
   	インスタンス ID	ターゲットの ApsaraDB for MongoDB インスタンスの ID を選択します。
   	認証データベース	ターゲットの ApsaraDB for MongoDB インスタンスのデータベースアカウントが属するデータベースの名前を入力します。変更されていない場合、デフォルトは admin です。
   	データベース名	ターゲットの ApsaraDB for MongoDB インスタンスで移行オブジェクトが属するデータベースの名前を入力します。
   	データベースアカウント	ターゲットの ApsaraDB for MongoDB インスタンスのデータベースアカウントを入力します。権限要件については、「データベースアカウントに必要な権限」をご参照ください。
   	データベースのパスワード	データベースインスタンスへのアクセスに使用されるパスワード。
   	暗号化	ターゲットデータベースへの接続を暗号化するかどうかを指定します。ビジネス要件に基づいて、非暗号化、SSL 暗号化、または Mongo Atlas SSL を選択できます。暗号化 パラメーターで使用できるオプションは、アクセス方法 および アーキテクチャ パラメーターに選択された値によって決まります。DTS コンソールに表示されるオプションが優先されます。 説明 ターゲットデータベースが ApsaraDB for MongoDB インスタンスで、[アーキテクチャ] パラメーターが [シャードクラスター] に設定されている場合、[暗号化] パラメーター SSL 暗号化 は使用できません。 ターゲットデータベースが レプリカセット アーキテクチャを使用する自己管理 MongoDB データベースであり、アクセス方法 パラメーターが Alibaba Cloud インスタンス に設定されておらず、[暗号化] パラメーターが SSL 暗号化 に設定されている場合、CA 証明書をアップロードしてターゲットデータベースへの接続を検証できます。

4. ページの下部で [接続テストと次へ] をクリックし、表示される [DTS サーバーの CIDR ブロック] ダイアログボックスで 接続テスト をクリックします。

   説明

   DTS サーバーからのアクセスを許可するために、DTS サーバーの CIDR ブロックがソースデータベースとターゲットデータベースのセキュリティ設定に自動または手動で追加できることを確認してください。詳細については、「DTS サーバーの IP アドレスをホワイトリストに追加する」をご参照ください。

5. 移行するオブジェクトを設定します。

   1. オブジェクト設定 ページで、移行するオブジェクトを設定します。

      設定	説明
      移行タイプ	スキーマ移行 と 完全データ移行 の両方を選択します。
      競合するテーブルの処理モード	エラーの事前チェックと報告: ターゲットデータベースにソースデータベースのコレクションと同じ名前のコレクションが含まれているかどうかをチェックします。ソースデータベースとターゲットデータベースに同じ名前のコレクションが含まれていない場合、事前チェックは合格します。それ以外の場合、事前チェック中にエラーが返され、データ移行タスクを開始できません。 説明 ソースデータベースとターゲットデータベースに同じ名前のコレクションが含まれており、ターゲットデータベースのコレクションを削除または名前変更できない場合は、オブジェクト名マッピング機能を使用して、ターゲットデータベースに移行されるコレクションの名前を変更できます。詳細については、「オブジェクト名のマッピング」をご参照ください。 エラーを無視して続行: ソースデータベースとターゲットデータベースの同一のコレクション名の事前チェックをスキップします。 警告 エラーを無視して続行 を選択した場合、データの整合性は保証されず、ビジネスに潜在的なリスクが伴う可能性があります。 DTS は、ターゲットデータベースのデータレコードと同じプライマリキーを持つデータレコードを移行しません。 データの初期化に失敗したり、特定の列のみが移行されたり、データ移行タスクが失敗したりする可能性があります。
      移行先インスタンスでのオブジェクト名の大文字化	ターゲットインスタンスのデータベース名とコレクション名の大文字/小文字。デフォルトでは、[DTS のデフォルトポリシー] が選択されています。オブジェクト名の大文字/小文字がソースまたはターゲットデータベースのものと同じになるように、別のオプションを選択できます。詳細については、「ターゲットインスタンスでのオブジェクト名の大文字/小文字の指定」をご参照ください。
      ソースオブジェクト	ソースオブジェクト セクションから 1 つ以上のオブジェクトを選択します。 アイコンをクリックして、オブジェクトを 選択中のオブジェクト セクションに追加します。 説明 データベースまたはコレクションレベルでオブジェクトを選択できます。
      選択中のオブジェクト	移行するオブジェクトの名前を指定したり、ターゲットインスタンスでデータを受信するオブジェクトを指定したりするには、選択中のオブジェクト セクションでオブジェクトを右クリックします。詳細については、「オブジェクト名のマッピング」をご参照ください。 移行対象として選択されている 1 つ以上のオブジェクトを削除するには、選択中のオブジェクト セクションでオブジェクトをクリックし、 アイコンをクリックしてオブジェクトを ソースオブジェクト セクションに移動します。 説明 条件に基づいてデータをフィルタリングするには、選択中のオブジェクト ボックスで移行するコレクションを右クリックし、表示されるダイアログボックスで設定を構成します。詳細については、「フィルター条件の設定」をご参照ください。 オブジェクト名マッピング機能を使用してデータを受信するデータベースまたはコレクションを指定した場合、マッピングされたオブジェクトに依存する他のオブジェクトの移行が失敗する可能性があります。

   2. 次へ：詳細設定 をクリックして詳細設定を構成します。

      設定	説明
      タスクのスケジュールに使用する専用クラスターの選択	デフォルトでは、DTS は共有クラスターでタスクをスケジュールするため、選択する必要はありません。特定の仕様の専用クラスターを購入して、DTS 移行タスクを実行できます。詳細については、「DTS 専用クラスターとは」をご参照ください。
      失敗した接続の再試行時間	失敗した接続のリトライ時間範囲。データ移行タスクの開始後にソースまたはターゲットデータベースへの接続に失敗した場合、DTS はリトライ時間範囲内で直ちに接続をリトライします。有効な値: 10 から 1,440。単位: 分。デフォルト値: 720。パラメーターを 30 より大きい値に設定することをお勧めします。指定されたリトライ時間範囲内に DTS がソースおよびターゲットデータベースに再接続されると、DTS はデータ移行タスクを再開します。それ以外の場合、データ移行タスクは失敗します。 説明 同じソースまたはターゲットデータベースを共有する複数のデータ移行タスクに異なるリトライ時間範囲を指定した場合、後で指定した値が優先されます。 DTS が接続をリトライすると、DTS インスタンスに対して課金されます。ビジネス要件に基づいてリトライ時間範囲を指定することをお勧めします。ソースデータベースとターゲットインスタンスがリリースされた後、できるだけ早く DTS インスタンスをリリースすることもできます。
      移行元データベースと移行先データベースで他の問題が発生した場合の、再試行までの待機時間です。	その他の問題のリトライ時間範囲。たとえば、データ移行タスクの開始後に DDL または DML 操作の実行に失敗した場合、DTS はリトライ時間範囲内で直ちに操作をリトライします。有効な値: 1 から 1440。単位: 分。デフォルト値: 10。パラメーターを 10 より大きい値に設定することをお勧めします。指定されたリトライ時間範囲内に失敗した操作が正常に実行されると、DTS はデータ移行タスクを再開します。それ以外の場合、データ移行タスクは失敗します。 重要 移行元データベースと移行先データベースで他の問題が発生した場合の、再試行までの待機時間です。 パラメーターの値は、失敗した接続の再試行時間 パラメーターの値より小さくする必要があります。
      完全なデータ移行のためのスロットリングを有効化	完全なデータ移行のスロットリングを有効にするかどうかを指定します。完全なデータ移行中、DTS はソースデータベースとターゲットデータベースの読み取りおよび書き込みリソースを使用します。これにより、データベースサーバーの負荷が増加する可能性があります。ビジネス要件に基づいて、完全なデータ移行のスロットリングを有効にできます。スロットリングを設定するには、1 秒あたりのソースデータベースのクエリ率 QPS、1 秒あたりの完全移行の行数 RPS、および 1 秒あたりの完全移行データ量 (MB) BPS パラメーターを設定する必要があります。これにより、ターゲットデータベースサーバーの負荷が軽減されます。 説明 このパラメーターは、移行タイプ パラメーターに 完全データ移行 を選択した場合にのみ設定できます。
      同期するデータのうち、同一テーブル内のプライマリキー_id のデータ型が一意かどうか	プライマリキー _id のデータ型が、移行するコレクション内で一意であるかどうかを指定します。 重要 ビジネス要件に基づいてこのパラメーターを有効にしてください。そうしないと、データ損失が発生する可能性があります。 このパラメーターは、移行タイプ パラメーターに 完全データ移行 を選択した場合にのみ必要です。 有効な値: ○: データ型は一意です。完全移行中、DTS はソースデータベースのプライマリキーのデータ型をスキャンしません。DTS は、移行するコレクション内のプライマリキーのデータ型を 1 つだけ移行します。 ×: データ型は一意ではありません。完全移行中、DTS はソースデータベースのプライマリキーのデータ型をスキャンし、すべてのデータ型のデータを移行します。
      環境タグ	必要に応じて、インスタンスを識別するための環境タグを選択できます。この例では選択は不要です。
      ETL の設定	抽出・変換・書き出し (ETL) 機能を有効にするかどうかを指定します。詳細については、「ETL とは」をご参照ください。有効な値: [はい]: ETL 機能を設定します。コードエディタにデータ処理文を入力できます。詳細については、「データ移行またはデータ同期タスクで ETL を設定する」をご参照ください。 [いいえ]: ETL 機能を設定しません。
      監視アラート	データ移行タスクのアラートを設定するかどうかを指定します。タスクが失敗した場合、または移行遅延が指定されたしきい値を超えた場合、アラート連絡先は通知を受け取ります。有効な値: [いいえ]: アラートを設定しません。 [はい]: アラートを設定します。この場合、アラートのしきい値と アラート通知設定も設定する必要があります。詳細については、「DTS タスク作成時のモニタリングとアラートの設定」トピックの「DTS タスク作成時のモニタリングとアラートの設定」セクションをご参照ください。

   3. [次のステップ: データ検証] をクリックして、データ検証タスクを設定します。

      データ検証機能の使用方法の詳細については、「データ検証タスクの設定」をご参照ください。

6. タスク設定を保存し、事前チェックを実行します。

   • 関連する API 操作を呼び出して DTS タスクを設定する際に指定するパラメーターを表示するには、ポインターを 次：タスク設定の保存と事前チェック の上に移動し、OpenAPI パラメーターのプレビュー をクリックします。

   • パラメーターを表示する必要がない場合、または表示した場合は、ページの下部にある 次：タスク設定の保存と事前チェック をクリックします。

   説明

   • データ移行タスクを開始する前に、DTS は事前チェックを実行します。タスクが事前チェックに合格した後にのみ、データ移行タスクを開始できます。

   • タスクが事前チェックに合格しなかった場合は、失敗した各項目の横にある [詳細の表示] をクリックします。チェック結果に基づいて原因を分析した後、問題をトラブルシューティングします。その後、再度事前チェックを実行します。

   • 事前チェック中に項目のアラートがトリガーされた場合:

     • アラート項目を無視できない場合は、失敗した項目の横にある [詳細の表示] をクリックして問題をトラブルシューティングします。その後、再度事前チェックを実行します。

     • アラート項目を無視できる場合は、[アラート詳細の確認] をクリックします。[詳細の表示] ダイアログボックスで、[無視] をクリックします。表示されるメッセージで、[OK] をクリックします。次に、[再度事前チェック] をクリックして、再度事前チェックを実行します。アラート項目を無視すると、データの不整合が発生し、ビジネスに潜在的なリスクが伴う可能性があります。

7. インスタンスを購入します。

   1. [成功率] が [100%] になるまで待ちます。次に、[次へ: インスタンスの購入] をクリックします。

   2. [インスタンスの購入] ページで、データ移行インスタンスの [インスタンスクラス] パラメーターを設定します。次の表にパラメーターを示します。

      セクション	パラメーター	説明
      新しいインスタンスクラス	[リソースグループ]	データ移行インスタンスが属するリソースグループ。デフォルト値: [デフォルトリソースグループ]。詳細については、「リソース管理とは」をご参照ください。
      	インスタンスクラス	DTS は、移行速度が異なるインスタンスクラスを提供します。ビジネスシナリオに基づいてインスタンスクラスを選択できます。詳細については、「データ移行インスタンスのインスタンスクラス」をご参照ください。

   3. チェックボックスをオンにして、[Data Transmission Service (従量課金) サービス規約] を読んで同意します。

   4. [購入して開始] をクリックし、OK ダイアログボックスで [OK] をクリックします。

      データ移行タスク ページで移行インスタンスの進行状況を表示できます。