Migration Management

VPC環境で利用できます。

Migration Managementでは、Migrationタスクを作成して、マイグレーションに必要なタスクの各ステップを自動化できます。また、Migrationタスクのステータスを確認し、必要に応じてタスクを再起動、停止、完了、削除できます。

データベースのマイグレーションはバックアップ、復旧、データ同期化のステップで行われます。

バックアップ(Export): Source DBでデータバックアップ
復旧(Import): Target DBにデータ復旧
データ同期化(Replication): Source DBと Target DBのデータを同期化

参考

復旧が完了すると、バックアップファイルは削除されます。
MySQL DBのデータ復旧時、バイナリログサイズ増加予防のため、Target DBのバイナリログは1日間のみ保管され、復旧が完了するとデフォルト設定が適用されます。
DB Userアカウントはマイグレーションされません。直接 Target DBから作成します。(DB User管理を参照)
Migrationタスクは、Test Connectionの時点で存在する Databaseのリストに限り行われます。Test Connection後の Migration進行中に追加で作成される Databaseは整合性が保証されません。
Migration Completed(= Replication完了)段階とは、初期データの移行後にもソース DBの変更内容が引き続き目的地 DBに同期されるステータスを指します。このリアルタイム同期は、ユーザーがコンソールで [完了] ボタンをクリックして移行を最終的に完了するまで維持されます。

マイグレーション準備

Migrationタスクを作成してマイグレーションを行う前に、次の事項を完了します。

Source DBと Target DBのアクセス設定(Source DBと Target DBのアクセス設定を参照)
Source DB Endpointの作成(Endpoint作成を参照)
Target DBのステータスの運用有無を確認
Source DBで使用中のプロシージャ Definerアカウントがある場合、Target DBに IDとアクセス Hostが同じアカウントを作成(DB User管理を参照)
Source DBの Configを変更した場合、Target DBに当該変更事項を適用(DB Config管理を参照)
Target DBに Source DBと同じデータベースが存在する場合、Target DBのデータベースを削除

注意

Target DBに Source DBと同じデータベースが存在する場合、マイグレーションを行いません。Target DBに存在する同じ名前のデータベースを削除してから行ってください。

Migrationタスク作成

Migrationタスクを作成し、簡単に Source DBのデータを Target DBにマイグレーションできます。

参考

Migrationタスクを作成する前に、マイグレーション準備を完了します。
Migrationタスクを作成した後、すぐにマイグレーションが始まります。
Migrationタスクが完了または削除されるまで、Target DBのコンソール操作、データの変更と入力はできません。(データ読み取りは可能)
Migrationの Source DBに影響を与えることなく、マイグレーションを実行できます。
Target DBでの Importing実行中は、Target DBでの別途バックアップの実行が制限されます。

Migrationタスクを作成する方法は、次の通りです。

NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Database > Database Migration Serviceメニューを順にクリックします。
Migration Managementメニューをクリックします。
[Migrationタスク作成] ボタンをクリックします。
次の情報を入力します。
- Migrationタスク名: 希望する名前を入力
- Source DB: Source DB Endpointの Source DB IDを選択
  - [Endpoint変更] : クリックして Endpointに設定した Source DBのアクセス情報を変更(アクセス情報に関する詳細は、Endpoint作成を参照)
- Endpoint URL, DB PORT, DB User: Source DBを選択すると、Endpointに設定した Source DB情報を表示
- Target DB: NAVERクラウドプラットフォームに作成した Target DBを選択
[Test Connection] ボタンをクリックし、Source DBと Target DBの接続をテストします。
- テストに成功すると、DBエンジンバージョン、GTID MODEの情報を自動入力
- エラー発生時、アラームポップアップを表示
次の情報を入力します。
- Backupタイプ: mysqldump / mydumperのうち選択
- Thread制限:
  - Backupタイプが mysqldumpの場合は固定値1
  - Backupタイプが mydumperの場合は2から10までの数字のうち、ユーザーが入力(ただし、入力可能な Thread数は Target DBサーバの CPU·Memoryの仕様により上限が制限されます)。
- 対象データベース: マイグレーション対象データベースを1つ以上選択
[Migrationタスク開始] ボタンをクリックします。
- 接続テストが完了すると、ボタンが有効になります。
通知のポップアップが表示されたら、 [確認] ボタンをクリックします。
- マイグレーションを開始します。

注意

mydumper選択時、Thread制限値が大きいほどマイグレーション速度は速くなりますが、Source DBおよび Target DBに加重される負荷が大きくなります。そのため、この点に留意して Thread制限値を指定してください。
mydumperを活用するには、vCPU 2個以上、メモリ8GB以上のスペックを持つ Target DBを作成してからタスクを進めることをお勧めします。

Migrationタスク情報確認

作成した Migrationタスクの情報を確認する方法は、次の通りです。

NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Database > Database Migration Serviceメニューを順にクリックします。
Migration Managementメニューをクリックします。

タスクリストで基本情報を確認するか、ご希望のタスクをクリックし、タスク情報を確認します。

タスクリストで確認できる基本情報は、次の通りです。

項目	説明
タスクステータス	現在のタスクステータス進行中: マイグレーションが進行中のステータス異常終了: エラー発生によりマイグレーションが異常終了したステータス停止: ユーザーがマイグレーションを強制停止したステータス完了: Source DBとの接続を完全に切断したステータスであるため、再起動や前のステータスへの復元は不可
実行ステップ	現在実行中のタスクステップを表示(タスクステータスが進行中の場合にのみ表示) Exporting: Source DBのデータをバックアップ中 Importing: Target DBへデータを復旧中 Replication: Source DBと Target DBのデータを同期化中
Source DB	ユーザーが設定した Source DBの ID
Target DB	ユーザーが設定した Target DBの名前
開始日時	マイグレーションを開始した時間
終了日時	マイグレーションが完了した場合、終了日時を表示
経過時間	マイグレーションが完了した場合はマイグレーションにかかった時間、進行中の場合は最初にマイグレーションを開始した時間から現在まで経過した時間を表示
Migration容量	Source DBのバックアップファイルのサイズ

タスクをクリックすると確認できるタスク情報は、次の通りです。

項目	説明
Source DBエンジンバージョン	Source DBの DBMSタイプとバージョン
Target DBエンジンバージョン	Target DBの DBMSタイプとバージョン
Migration開始日時	マイグレーションを開始した時間
Migration終了日時	マイグレーションが完了した場合、終了日時を表示
Migration Status	現在のタスクステータス
Target DB Server名	Target DBサーバの名前
実行ステップ	タスクステータスが進行中の場合、各実行ステップのステータス(タスク前、進行中、完了、Error)を表示 Exporting: Source DBのデータバックアップの進捗状況 Importing: Target DBへのデータ復旧の進捗状況 Replication: Source DBと Target DBのデータ同期の進捗状況進捗ステータスが Errorの場合、[エラーを見る] をクリックしてエラー内容を確認
Backupタイプ	マイグレーション時に使用されたバックアップツールタイプ(mysqldumpまたは mydumper)
Thread数	バックアップおよび復旧時に使用した Thread数

各実行ステップ(Exporting, Importing, Replication)でエラーが発生すると、進捗ステータスが Errorと表示されます。[エラーを見る] ボタンをクリックすると、エラーの詳細を確認できます。ステップごとの対処方法は次の通りです。

実行ステップ	エラー発生時の対処
Exporting	Source DBの接続情報・権限などを確認し、原因に対処した上でマイグレーションを再開
Importing	Target DBのステータス・ディスク容量などを確認し、原因に対処した上でマイグレーションを再開。エラーの原因によっては、マイグレーションを削除してから再作成する必要がある場合がある
Replication	エラーの内容を確認した後、 [レプリケーションエラースキップ] ボタンをクリックして当該エラーをスキップ

レプリケーションエラースキップ

Replicationの段階でレプリケーションエラーが発生した場合、 [レプリケーションエラースキップ] ボタンをクリックすると、エラーが発生したトランザクションをスキップしてデータの同期を続行できます。

スキップが完了すると Replicationが自動的に再開され、実行段階が進行中のステータスに切り替わります。
レプリケーションエラースキップは Replication段階でのみ使用でき、Exportingまたは Importing段階のエラーには適用されません。

参考

バックアップと復旧中にエラーが発生した場合、エラー内容に対応した後にマイグレーションを再試行してください。
Replicationステップで失敗した場合、Target DBのバックアップ実行が制限されます。
Replicationまですべて完了したステータスの場合、 [完了] ボタンをクリックして Target DBをサービス可能なステータスにします。

注意

レプリケーションエラのスキップは GTIDベースのレプリケーション環境において、現在エラーが発生しているトランザクションをスキップする方式で動作します。スキップされたトランザクションのデータは Target DBに反映されないため、スキップ後に Source DBと Target DB間のデータ整合性を必ずご確認ください。
レプリケーションエラーが繰り返し発生する場合は、Source DBの問題に対処した後、マイグレーションを削除して再作成することをお勧めします。

テーブル状況チェック

Replication段階が完了すると、Source DBと Target DB間のテーブルの欠落やデータの復元漏れについて自動的にチェックを行います。チェック結果は、タスク情報画面のテーブル状況チェック領域で確認できます。テーブル状況チェックの項目の説明は、次の通りです。

ステータス: チェック結果のステータス
- 異常なし: Source DBと Target DB間の統計に基づく照合において、差異が確認されなかったステータス
- 異常検知: 一部のテーブルでデータの欠落または復元漏れが検出されたステータス
チェック日時: チェックが完了した時刻および所要時間
チェック結果: 統計に基づく確認結果のサマリー
- ステータスが異常なしの場合: Source ↔ Target 간 N개 테이블 통계 기반 확인 완료 形式で表示
- ステータスが異常検知の場合: 이상 없음 N / 이상 탐지 N 形式で表示され、下部に詳細内容の表を併せて提供
  - DB名: 異常が検知された DBの名前
  - テーブル名: 異常が検知されたテーブルの名前
  - 検知内容: 検知された理由(例: Target DB에 테이블이 존재하지 않음)

テーブル状況チェックは、Replication段階が完了した時点で自動的に1回実行されます。Replication段階で [停止] 後、 [再起動] して Replicationが再度完了した場合でも、自動的に再チェックが行われます。

参考

本チェックでは、DBの統計情報に基づき、テーブルの欠落やデータの復元漏れの有無を確認します。rowレベルの詳細な比較は、チェックの対象外となります。
異常検知項目は最大10件まで表示されます。
チェック結果は、 [完了] ボタンの使用可否には影響しません。異常が検知された場合でも [完了] ボタンをクリックでき、その場合は Source DBと Target DB間のデータの整合性を直接ご確認ください。何か特異事項がある場合は、サポートセンターまでお問い合わせください。

Migrationタスク再開

異常終了または停止した Migrationタスクを再起動する方法は、次の通りです。

NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Database > Database Migration Serviceメニューを順にクリックします。
Migration Managementメニューをクリックします。
タスクリストで再開するタスクをクリックし、 [再開] ボタンをクリックします。
通知のポップアップが表示されたら、 [確認] ボタンをクリックします。
- タスクステータスが実行中に変わります。

参考

異常終了を確認し、その原因を解決したにも関わらず、マイグレーションの再起動時に同じエラーメッセージが発生する場合は、マイグレーションを削除してから再作成してください。

Migrationタスク停止

進行中の Migrationタスクを停止する方法は、次の通りです。

参考

バックアップ中または復旧中の場合、当該タスクがキャンセルされます。
停止後にも再起動できます。(Migrationタスク再開を参照)
- バックアップ中に停止した場合: 再開時に Source DBのデータバックアップを最初から再実行します。
- 復旧中に停止した場合: 再開時に Target DBのデータ復旧を最初から再実行します。

NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Database > Database Migration Serviceメニューを順にクリックします。
Migration Managementメニューをクリックします。
タスクリストで停止するタスクをクリックし、 [停止] ボタンをクリックします。
通知のポップアップが表示されたら、 [確認] ボタンをクリックします。
- タスクステータスが停止に変わります。

Migrationタスク完了

Source DBとのデータ同期化タスクを終了し、Target DBを操作できるステータスに変更します。

Migrationタスクのタスクステータスが進行中、実行ステップが Replication完了の場合のみ操作できます。

参考

Migrationタスク完了まで数分かかります。
完了後にマイグレーションが必要な場合、Migrationタスクの作成ステップからやり直す必要があります。

Migrationタスクを完了する方法は、次の通りです。

NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Database > Database Migration Serviceメニューを順にクリックします。
Migration Managementメニューをクリックします。
タスクリストで終了するタスクをクリックし、 [完了] ボタンをクリックします。
通知のポップアップが表示されたら、 [確認] ボタンをクリックします。

Migrationタスク削除

Migrationタスク情報を削除できます。ただし、Migrationタスクのタスクステータスが異常終了、停止、完了の場合にのみ削除できます。

注意

削除後には Migrationタスク情報を復旧できません。
Migrationタスク情報に入力した Source DB情報は Endpoint Managementメニューで確認できます。

Migrationタスク情報を削除する方法は、次の通りです。

NAVERクラウドプラットフォームコンソールの VPC環境で、Menu > All Services > Database > Database Migration Serviceメニューを順にクリックします。
Migration Managementメニューをクリックします。
タスクリストで情報を削除するタスクをクリックし、 [削除] ボタンをクリックします。
通知のポップアップが表示されたら、 [確認] ボタンをクリックします。

Documentation Index