ApsaraDB for MongoDB:DTS を使用した自己管理 MongoDB シャードクラスターの移行

ソースデータベースの制限

• サーバーには十分なアウトバウンド帯域幅が必要です。帯域幅が不足すると移行が遅くなります。

• 移行対象のコレクションには、プライマリキーまたは一意性制約が必要で、すべてのフィールドが一意である必要があります。そうでない場合、ターゲットに重複レコードが表示される可能性があります。

• DTS は完全データ移行中にソースデータベースとターゲットデータベースの両方で読み取りおよび書き込みリソースを使用するため、サーバーの負荷が増加します。オフピーク時間に移行を実行してください。

• ソースデータベースとターゲットデータベースの MongoDB バージョンまたはストレージエンジンが異なる場合は、まず互換性を確認してください。 詳細については、「MongoDB バージョンとストレージエンジン」をご参照ください。

• 増分データ移行の場合、ソースデータベースで oplog を有効にし、oplog を少なくとも 7 日間保持してください。oplog が有効でない場合、事前チェック中にエラーメッセージが返され、データ移行タスクを開始できません。DTS が oplog を取得できない場合、タスクは失敗し、データの不整合や損失が発生する可能性があります。これらの保持要件は、DTS のサービスレベルアグリーメント (SLA) の対象外です。

• 移行オブジェクトとしてコレクションを選択し、ターゲットで編集 (名前変更など) を計画している場合、1 つのタスクでサポートされるコレクションは最大 1,000 個です。1,000 個を超えるコレクションの場合は、複数のタスクを設定するか、データベース全体を移行してください。

• admin または local データベースをソースまたはターゲットとして使用しないでください。

• ソースの自己管理 MongoDB データベースには、10 個を超える mongos ノードを含めることはできません。

• Time-to-Live (TTL) インデックスを持つコレクションは移行しないでください。TTL インデックスは、移行後にソースとターゲットの間でデータの不整合を引き起こす可能性があります。

• ソースデータベースまたは送信先のシャードクラスターインスタンスに孤立ドキュメントが存在しないことを確認してください。孤立ドキュメントは、データの不整合やタスクの失敗の原因となります。詳細については、「MongoDB ドキュメント」および「シャードクラスターアーキテクチャの MongoDB データベースから孤立ドキュメントを削除する方法」をご参照ください。

移行中に、ソースデータベースで以下のコマンドを実行しないでください。これらのコマンドはデータ分散を変更し、不整合を引き起こす原因となります。

• shardCollection、reshardCollection、unshardCollection、moveCollection、movePrimary

スキーマ移行および完全データ移行中：

• データベースやコレクションに対してスキーマ変更 (配列型の更新を含む) を行わないでください。スキーマ変更はタスクの失敗やデータの不整合を引き起こします。

• 完全データ移行のみ (増分なし) を実行する場合は、ソースデータベースにデータを書き込まないでください。データの一貫性を確保するには、スキーマ移行、完全データ移行、増分データ移行を一緒に選択してください。

移行中にソースデータベースのバランサーがアクティブな場合、チャンクの移行によって遅延が発生する可能性があります。

その他の制限

• タスクを設定する前に DTS インスタンスを購入する場合、購入時にシャード数を指定してください。

• DTS は SRV 接続文字列を介して MongoDB データベースに接続できません。

• 移行を開始する前に、ソースデータベースのすべてのデータにシャードキーを追加してください。移行中、INSERT 操作にはシャードキーを含める必要があり、UPDATE 操作ではシャードキーを変更できません。

• 完全なデータ移行中は、ソース MongoDB データベースのバランサーを無効にしてください。各サブタスクが増分データ移行フェーズに達するまで、無効にしたままにしてください。時期尚早に再度有効にすると、データの不整合の原因となります。詳細については、「ApsaraDB for MongoDB バランサーの管理」をご参照ください。

• ターゲットデータベースに、ソースと同じプライマリキー (_id) を持つドキュメントが既に存在しないことを確認してください。重複が存在する場合は、移行を開始する前にターゲット内の対応するドキュメントを削除してください。

• トランザクション情報は保持されません。移行されたトランザクションは個別のレコードに変換されます。

• DTS がターゲットに書き込む際にプライマリキーまたは一意キーの競合が発生した場合、DTS は競合する書き込みをスキップし、既存のデータを保持します。

• 移行タスクの実行中に ApsaraDB for MongoDB シャードクラスターインスタンスをスケーリングしないでください。スケーリングするとタスクが失敗します。

• ターゲットの ApsaraDB for MongoDB データベースで db.$table_name.aggregate([{ $count:"myCount"}]) を使用してクエリ数をカウントします。

• DTS はデータを同時に書き込むため、ターゲットで使用されるストレージ容量はソースよりも 5～10% 大きくなります。

• ターゲットコレクションに一意なインデックスがあるか、capped 属性が true に設定されている場合、コレクションはシングルスレッドの書き込みのみをサポートし、増分移行中の同時リプレイをサポートしません。これにより、移行遅延が増加する可能性があります。

• 完全データ移行は両方のデータベースで読み取りおよび書き込みリソースを使用するため、サーバーの負荷が増加します。オフピーク時間に移行を実行してください。

• 完全データ移行中の同時 INSERT 操作は、テーブルの断片化を引き起こします。完全データ移行後、ターゲットのテーブルスペースはソースよりも大きくなります。

• DTS は、失敗した移行タスクを最大 7 日間再試行します。ワークロードをターゲットインスタンスに切り替える前に、失敗したタスクを停止またはリリースするか、ターゲットに対する DTS の書き込み権限を取り消してください。そうしないと、失敗したタスクが再開されたときにソースデータがターゲットデータを上書きします。

• DTS タスクが失敗した場合、DTS テクニカルサポートは 8 時間以内に復元を試みます。復元中、タスクが再起動され、タスクパラメーターが変更される場合があります。

  変更される可能性があるのはタスクパラメーターのみであり、データベースパラメーターは変更されません。変更される可能性のあるパラメーターは、インスタンスパラメーターの変更セクションに記載されています。

• ターゲットがレプリカセットインスタンスの場合：

  • Express Connect、VPN ゲートウェイ、Smart Access Gateway、パブリック IP アドレス、または Cloud Enterprise Network (CEN) 経由で接続されている場合は、[ドメイン名または IP] と [ポート番号] を設定します

    プライマリノードの IP アドレスとポートに接続するか、高可用性エンドポイントを設定します。 詳細については、「ソースまたはターゲットデータベースが高可用性 MongoDB データベースである DTS タスクを作成する」をご参照ください。

  • ECS 上の自己管理型データベース経由で接続する場合、[ポート番号] をプライマリノードのポートに設定します

• ターゲットがシャードクラスターインスタンスの場合、アプリケーションの動作が ApsaraDB for MongoDB シャードクラスターの要件を満たしていることを確認してください。

事前準備

DTS タスクを作成する前に、以下の手順を完了してください。

ステップ 1：データ移行ページを開く

以下のいずれかの方法で[データ移行] ページを開き、移行インスタンスが存在するリージョンを選択します。

DTS コンソール

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

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

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

DMS コンソール

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

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

2. トップナビゲーションバーで、[Data + AI] > [DTS (DTS)] > [データ移行] の順に選択します。

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

ステップ 2：タスクを作成する

[タスクの作成] をクリックしてタスク構成ページを開きます。

ステップ 3：ソースデータベースとターゲットデータベースを設定する

以下のパラメーターを設定します：

一般

ソースデータベース

ターゲットデータベース

ステップ 4：接続性をテストする

[接続をテストして続行] をクリックします。

ソースデータベースとターゲットデータベースのセキュリティ設定に、DTS サーバーの CIDR ブロックが追加されていることを確認してください。「DTS サーバーの CIDR ブロックを追加する」をご参照ください。ソースまたはターゲットが、[Alibaba Cloud インスタンス] として接続されていない自己管理データベースの場合、[DTS サーバーの CIDR ブロック] ダイアログボックスで [接続テスト] をクリックします。

ステップ 5：移行オブジェクトを設定する

[オブジェクトの設定] ページで、次のパラメーターを設定します：

[次へ: 詳細設定] をクリックして、以下を設定します。

[次のステップ: データ検証] をクリックしてデータ検証を設定します。 詳細については、「データ検証タスクを設定する」をご参照ください。

ステップ 6：事前チェックを実行する

[次へ: タスク設定の保存と事前チェック] をクリックします。

このタスク構成の API パラメーターをプレビューするには、[次へ: タスク設定の保存と事前チェック] にカーソルを合わせ、[OpenAPI パラメーターのプレビュー] をクリックします。

DTS は移行が開始される前に事前チェックを実行します。事前チェックが成功するまでタスクは開始できません。

• 事前チェック項目が失敗した場合は、その横にある[詳細の表示]をクリックし、問題を解決してから、再度事前チェックを実行します。

• 事前チェック項目がアラートをトリガーした場合：

  • アラートが無視できない場合は、[詳細を表示] をクリックして問題を解決し、事前チェックを再実行してください。

  • アラートを無視できる場合は、[アラート詳細の確認] をクリックし、ダイアログボックスで [無視]、[OK] の順にクリックします。 続行するには、[事前チェックを再実行] をクリックします。 アラートを無視すると、データの不整合が発生する可能性があります。

ステップ 7：インスタンスを購入する

1. 成功率 が 100% に達したら、[次へ: インスタンスの購入] をクリックします。

2. [インスタンスの購入] ページで、次の項目を設定します。

   セクション	パラメーター	説明
   新しいインスタンスクラス	リソースグループ	移行インスタンスのリソースグループです。デフォルトはデフォルトリソースグループで、「Resource Management とは」をご参照ください。
   	インスタンスクラス	インスタンスクラスは移行速度を決定します。ニーズに合わせて選択してください。詳細については、「データ移行インスタンスのインスタンスクラス」をご参照ください。

3. チェックボックスを選択して、Data Transmission Service (従量課金) サービス利用規約を読んで同意します。

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

タスクは[データ移行] ページに表示されます。

• 完全データ移行のみ：タスクは自動的に停止します。ステータスは [完了] と表示されます。

• 増分データ移行：タスクは継続的に実行され、自動的に停止しません。ステータスは [実行中] と表示されます。

ステップ 8：残りのシャードのタスクを作成する (該当する場合)

ソースの [アクセス方法] が [ECS 上の自己管理型データベース] または [データベースゲートウェイ] の場合、残りの各シャードについてステップ 1～7 を繰り返します。

ステップ 9：移行タスクを停止する

フルデータ移行

移行されたデータが不完全になる可能性があるため、完全データ移行タスクを手動で停止しないでください。タスクが自動的に停止するのを待ちます。

増分データ移行

増分データ移行は自動的に停止しません。オフピーク時間やターゲットインスタンスにワークロードを切り替える前など、適切なタイミングで手動で停止してください。

1. [増分データ移行] が [実行中] のプログレスバーに表示され、[操作情報] に [遅延なし] が表示されるまで待機します。その後、ソースデータベースへのデータの書き込みを数分間停止します。

2. [増分データ移行] のステータスが [遅延なし] に戻ったら、すべてのシャードの移行タスクを手動で停止します。

ステップ 10：ワークロードをターゲットインスタンスに切り替える

移行が完了し、データを確認した後、ワークロードをターゲットの ApsaraDB for MongoDB インスタンスに切り替えます。