OceanBaseデータベースのMySQL互換モードのデータをMySQLデータベースに移行する

OceanBaseデータベースのMySQL互換モードからMySQLデータベースへのデータ移行タスクを新規作成し、構造移行、全量移行、増分同期を通じて、ソースデータベースの既存業務データと増分データをターゲットデータベースへシームレスに移行できます。

前提条件

• OceanBaseデータベースのクラスタとテナントが作成済みであること。詳細については、クラスタの作成をご参照ください。

• データ移行用の専用データベースユーザーをソース側とターゲット側に作成し、関連する権限を付与していること。詳細については、データ移行ユーザー権限をご参照ください。

• ターゲット側のデータベースインスタンスが作成済みであること。

  クラウドプロバイダーごとのデータベースクラウドインスタンスの作成ドキュメントは以下の通りです：

  • クラウドプロバイダーがAWSの場合：Aurora MySQLデータベースインスタンスの作成

  • クラウドプロバイダーがHuawei Cloudの場合：RDS for MySQLデータベースインスタンス

  • クラウドプロバイダーがAlibaba Cloudの場合：RDS MySQLデータベースインスタンスの作成またはPolarDB MySQLクラスタの購入

  • クラウドプロバイダーがTencent Cloudの場合：TencentDB for MySQLデータベースインスタンスの作成

使用上の制限

• プロジェクトロールが プロジェクトオーナー、プロジェクト管理者、または データサービス管理者 のユーザーのみが新規データ移行タスクの作成をサポートします。

• ソースデータベースの操作制限

  構造移行およびフル移行段階では、データベースまたはテーブル構造の変更を行うDDL操作を実行しないでください。そうしないと、データ移行タスクが中断する可能性があります。

• 現在、データ移行はTencentDB for MySQL V5.x、Aurora MySQL V2.x、V3.x、Huawei Cloud RDS MySQL V5.6、V5.7、V8.0、V8.4、MySQLデータベースV5.6、V5.7、V8.0、V8.4、OceanBaseデータベースMySQL互換モードV2.x、V3.x、V4.xをサポートしています。

• データ移行は、ASCIIコードで特殊文字（.|"'`()=;/&および改行を含む）を含まないデータベース名、テーブル名、列名のオブジェクトの移行のみをサポートします。

• データ移行は大文字小文字を区別するモードをサポートしていません。ターゲット側に同じ名前だが大文字小文字が異なるデータベースやテーブルが存在する場合、事前チェックでエラーが発生します。

• ターゲット側がデータベースの場合、データ移行はターゲット側にトリガー(Trigger)が存在することをサポートしていません。存在すると、データ移行が失敗する可能性があります。

注意事項

• ソース側の文字セットがUTF-8の場合、ターゲット側ではソース側と互換性のある文字セット（例：UTF-8、UTF-16など）を使用することを推奨します。これにより、文字セットの不互換によるターゲット側での文字化けなどの問題を回避できます。

• ノード間の時刻のずれや、クライアント端末とサーバー間の時刻のずれは、増分同期の遅延時間が正確でない原因となる可能性があります。

  例えば、時計が標準時より進んでいると、遅延時間が負の値になる可能性があります。時計が標準時より遅れていると、遅延が発生する可能性があります。

• DDL同期を有効にしていない場合、ターゲット側の一意インデックスを変更した後は、データ移行タスクを再開始する必要があります。そうでない場合、データの不整合が発生する可能性があります。

• DECIMAL、FLOAT、DATETIMEなどの列型の移行精度が期待通りであるか確認してください。ターゲット側のフィールド型の精度がソース側のフィールド型の精度より低い場合、切り捨てが発生し、ソース側とターゲット側のデータが不整合になる可能性があります。

• ソース側がOceanBaseデータベースでDDL同期が有効なデータ移行タスクにおいて、ソース側のデータベーステーブルに対してRENAME操作が行われた場合、増分同期でデータが失われるのを避けるため、タスクを再開始することを推奨します。

• ソース側とターゲット側のテーブル構造が完全に一致しない場合、データの不整合が発生する可能性があります。現在知られているシナリオは以下の通りです：

  • ユーザーが手動でテーブル構造を作成する際、データ移行のサポート範囲を超えると、暗黙的な変換が発生し、ソース側とターゲット側の列の型が一致しなくなる可能性があります。

  • ターゲット側のデータ長がソース側のデータ長より短い場合、データが切り捨てられ、ソース側とターゲット側のデータが一致しなくなる可能性があります。

• データ移行タスクを新規作成する際に、増分同期 のみを設定した場合、データ移行ではソースデータベースのローカル増分ログを48時間以上保持する必要があります。

• データ移行タスクを新規作成する際に、増分同期 のみを設定した場合、データ移行ではソースデータベースのローカル増分ログを48時間以上保存する必要があります。

  データ移行タスクを新規作成する際に、完全移行 + 増分同期 を設定した場合、データ移行ではソースデータベースのローカル増分ログを少なくとも7日間以上保持する必要があります。そうでない場合、増分ログを取得できないためデータ移行タスクが失敗したり、ソース側とターゲット側のデータが一致しなくなったりする可能性があります。

• OceanBaseデータベースをソースとして増分同期を行う場合、データベーステーブルオブジェクトにUDT列が含まれていると、UDT列をサポートしていないため増分同期タスクが異常終了する可能性があります。

サポートされているソースおよびターゲットインスタンスタイプ

データ型のマッピング

操作手順

1. データ移行タスクを新規作成します。

   

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

   2. 左側のナビゲーションペインで、データサービス > データ移行 をクリックします。

   3. データ移行 ページで、データ移行 タブをクリックします。

   4. データ移行 タブで、右上の タスクを作成する をクリックします。

2. タスク名を編集するテキストボックスに、カスタムの移行タスク名を入力します。

中国語、数字、英字の組み合わせを使用することをお勧めします。名前にはスペースを含めず、長さは64文字を超えないようにしてください。

3. ソースとターゲットを設定する ページで、各パラメータを設定します。

4. ソース エリアで、各パラメータを設定します。

   既に作成・保存されたデータソースを参照する必要がある場合、ソース側 の右側にある クイックフィル をクリックし、ドロップダウンリストから対象のデータソースを選択します。選択完了後、ソースエリアの各設定は自動的に入力されます。現在の設定を新しいデータソースとして保存する場合は、ソース エリアの右上にある 保存 アイコンをクリックします。

   また、クイックフィル のドロップダウンリストで データソースの管理 をクリックすると、データソース ページに移動し、データソースの表示や管理ができます。この記事では異なるタイプのデータソースを一元的に管理できます。詳細については、データソースモジュールのドキュメントをご参照ください。

   パラメータ	説明
   クラウドベンダー	現在 AWS、ファーウェイ・クラウド、Alibaba Cloud、Tencent Cloud をサポートしています。
   データベースタイプ	ソースを OceanBase MySQL Compatible に選択します。
   インスタンスタイプ	クラスタインスタンス（トランザクション） と オンプレデータベース が含まれます。現在、クラスタインスタンス（トランザクション） のデータからMySQLデータベースへの移行のみをサポートしています。
   リージョン	ソースデータベースのリージョンを選択します。
   接続タイプ	エンドポイント と パブリックネットワーク接続 が含まれます。 エンドポイント 接続方式を選択した場合、ページに表示されているアカウントIDをエンドポイントサービスのホワイトリストに追加する必要があります。これにより、そのアカウントのエンドポイントがエンドポイントサービスに接続できるようになります。詳細については、プライベートネットワーク接続の選択モジュールのドキュメントをご参照ください。 パブリックネットワーク接続 接続方式を選択した場合、ページに表示されているデータソースIPアドレスをOceanBaseデータベースインスタンスのホワイトリストに追加して接続性を確保する必要があります。詳細については、パブリックネットワーク接続の選択モジュールのドキュメントをご参照ください。 説明 インスタンスタイプが自社構築データベースのみを選択した場合にこのパラメータが表示されます。ソースとターゲットのリージョンを選択すると、ページにホワイトリストに追加する必要があるデータソースIPアドレスが表示されます。
   接続情報	インスタンスタイプが自社構築データベースのみを選択した場合にこのパラメータが表示されます。 接続タイプ を エンドポイント に選択した場合、エンドポイントサービス名を入力してください。 接続タイプ を パブリックIP に選択した場合、データベースホストのIPアドレスとポート番号を入力してください。
   インスタンス	OceanBaseデータベースMySQL互換モードのテナントが存在するインスタンスのIDまたは名前です。インスタンス ページで、ターゲットインスタンスのIDまたは名前を確認できます。 説明 クラウドベンダーがAlibaba Cloudの場合、アカウント間認証をサポートするAlibaba Cloudのメインアカウントインスタンスの選択も可能です。詳細については、Alibaba Cloudアカウント認証をご参照ください。
   テナント	OceanBaseデータベースMySQL互換モードのテナントのIDまたは名前です。インスタンス ページで、ターゲットインスタンスを展開し、そのインスタンス下のターゲットテナントのIDまたは名前を確認できます。
   データベースアカウント	データ移行用のOceanBaseデータベースMySQL互換モードテナントのユーザー名です。
   パスワード	データベースユーザーのパスワード。

   インスタンスタイプが 自己管理型データベース の場合、構造移行と増分同期を行う必要がある場合は、詳細設定 エリアで各パラメータを設定してください。

   

   • タイプとオブジェクトを選択してください のステップで スキーマ移行 または 増分同期 を選択する場合は、sysテナントアカウントを有効にし、以下のパラメータを設定してください。

     パラメータ	説明
     sysアカウント	sysユーザーの名前です。このユーザーは主にOceanBaseデータベースの増分ログとデータベースオブジェクト構造情報の読み取りに使用されます。業務クラスタのsysテナント内に作成してください。
     パスワード	sysユーザーのパスワード。

   • タイプとオブジェクトを選択してください のステップで 増分同期 を選択する場合は、OBLogProxyを有効にし、OBLogProxy接続情報を入力してください。

     注意

     増分同期をサポートするには、sysテナントアカウントとOBLogProxyの両方を有効にする必要があります。

     OBLogProxy接続情報 は、OceanBaseデータベースの増分ログプロキシサービスであり、サービス形態でリアルタイムの増分ログの取得と管理機能を提供し、アプリケーションがOceanBaseデータベースの増分ログにアクセスすることを容易にします。同時に、ネットワークが分離されている状況でも増分ログのサブスクリプションニーズを解決できます。形式は OBLogProxy IP：OBLogProxy Port です。

5. ターゲット エリアで、各パラメータを設定します。

   既に作成・保存されたデータソースを参照する必要がある場合は、ターゲット側 の右側にある クイックフィル をクリックし、ドロップダウンリストから対象のデータソースを選択します。選択完了後、ターゲット側エリアの各設定は自動的に入力されます。現在の設定を新しいデータソースとして保存する場合は、ターゲット エリアの右上にある 保存 アイコンをクリックしてください。

   また、クイックフィル のドロップダウンリストで データソースの管理 をクリックすると、データソース ページに移動し、データソースの表示や管理を行えます。この記事では異なる種類のデータソースを一元的に管理できます。詳細については、データソース モジュールのドキュメントをご参照ください。

   パラメータ	説明
   クラウドベンダー	現在 AWS、Huaweicloud、Alibaba Cloud、および Tencent Cloud をサポートしています。ソースと同じクラウドベンダーを選択することも、異なるクラウドベンダー間でのデータ移行も可能です。 説明 現在、異なるクラウドベンダー間でのデータ移行機能はデフォルトで利用できません。この機能を使用する場合は、OB Cloudのテクニカルサポートにお問い合わせください。
   データベースタイプ	ターゲット側のデータベースタイプとして MySQL を選択します。
   インスタンスタイプ	クラウドベンダー を AWS に設定した場合、インスタンスタイプは Aurora MySQL、RDS MySQL、および セルフマネージド MySQL が含まれます。 クラウドベンダー を Huawei Cloud に設定した場合、インスタンスタイプは RDS MySQL と セルフマネージド MySQL が含まれます。 クラウドベンダー を Alibaba Cloud に設定した場合、インスタンスタイプは RDS MySQL、PolarDB MySQL、および セルフホスト型MySQL が含まれます。 クラウドベンダー を Tencent Cloud に設定した場合、インスタンスタイプは TencentDB for MySQL と セルフマネージド MySQL が含まれます。
   リージョン	ターゲット側データベースのリージョンを選択します。
   接続タイプ	エンドポイント と パブリックIP が含まれます。 エンドポイント 接続方式を選択した場合、ページに表示されているアカウントIDをエンドポイントサービスのホワイトリストに追加し、そのアカウントのエンドポイントがエンドポイントサービスに接続できるようにする必要があります。詳細については、プライベートネットワーク接続の選択をご参照ください。 パブリックIP 接続方式を選択した場合、ページに表示されているデータソースIPアドレスをMySQLデータベースインスタンスのホワイトリストに追加して接続性を確保する必要があります。詳細については、パブリックネットワーク接続の選択をご参照ください。 説明 ソースとターゲットのリージョンを選択すると、ページにはホワイトリストに追加する必要があるデータソースIPアドレスが表示されます。
   接続情報	接続タイプ を エンドポイント に設定した場合、エンドポイントサービス名を入力してください。 接続タイプ を パブリックIP に設定した場合、データベースホストのIPアドレスとポート番号を入力してください。
   データベースアカウント	データ移行用のMySQLデータベースのユーザー名。
   パスワード	データベースユーザーのパスワード。

6. テストして続行 をクリックします。

   エンドポイント接続リクエストを承認しない場合、接続テストに失敗します。ポップアップウィンドウの指示に従って操作してください。

   • クラウドベンダー を AWS に設定した場合、AWSコンソールにアクセスして、受信したエンドポイント接続リクエストに対して エンドポイント接続リクエストを承認する 操作を実行する必要があります。

   • クラウドベンダー を Huaweicloud に設定した場合、接続管理 タブにアクセスして、接続承認を受け入れる必要があります。詳細については、エンドポイントサービスの接続承認の管理をご参照ください。

   • クラウドベンダー を Tencent Cloud に設定した場合、エンドポイント タブにアクセスして、エンドポイントの状態接続リクエストを承認する必要があります。詳細については、エンドポイント接続の管理をご参照ください。

7. タイプとオブジェクトを選択してください ページで、各パラメータを設定します。

   1. 同期トポロジー エリアで、一方向同期 を選択します。

      データ移行は 一方向同期 と 双方向同期 をサポートしています。本記事では一方向同期の操作について説明します。双方向同期の詳細については、双方向同期タスクの設定をご参照ください。

   2. 移行タイプ 領域で、現在のデータ移行タスクの移行タイプを選択します。

      移行タイプ には、スキーマ移行、完全移行、および 増分同期 が含まれます。

      パラメータ	説明
      構造移行	構造移行では、文字セットのマッピング関係を自ら定義する必要があります。データ移行は、ソースデータベースのデータ（構造）をターゲットデータベースにコピーするだけで、ソースデータ（構造）に影響を与えません。OceanBaseデータベースのMySQL互換モードのテナントからMySQLデータベースへの構造移行では、ターゲット側に存在しないデータベースを自動作成することをサポートしています。
      フル移行	フル移行タスク開始後、データ移行サービスは、ソースデータベースのテーブルの既存データをターゲットデータベースの対応するテーブルに移行します。
      増分同期	増分同期タスク開始後、データ移行は、ソースデータベースで変更されたデータ（追加、変更、削除）をターゲットデータベースの対応するテーブルに同期します。増分同期 には、DML同期 と DDL同期 が含まれ、ニーズに応じてカスタマイズ設定できます。詳細については、DML/DDLのカスタム設定をご参照ください。

   3. 移行対象を選択してください 領域で、移行オブジェクトの選択方法を設定します。

      オブジェクトの指定 と ルールによる一致 の2つの方法で移行オブジェクトを選択できます。

      

   4. 移行範囲を選択してください 領域で、移行するオブジェクトを選択します。

      • オブジェクトの指定 を選択した場合、データ移行は データベースオブジェクト と データベース全体 をサポートしています。データベース・テーブル移行では、1つまたは複数のデータベース内のテーブルやビューを移行オブジェクトとして選択できます。データベース移行では、データベース全体を移行オブジェクトとして選択できます。あるデータベースでデータベース・テーブル移行を選択した場合、そのデータベースはデータベース移行をサポートしなくなります。あるデータベースでデータベース移行を選択した場合、そのデータベースはデータベース・テーブル移行をサポートしなくなります。

        データベースオブジェクト または データベース全体 の方法を選択した後、左側で移行するオブジェクトを選択し、> をクリックして右側のリストに追加します。

        データ移行は、テキストを使用してオブジェクトをインポートすることをサポートしており、ターゲット側のオブジェクトの名前変更、行フィルタリングの設定、列情報の表示、および単一またはすべての移行オブジェクトの削除などの操作もサポートしています。

      説明

      データベース移行を選択した場合：

      • 右側のリストにはデータベース名のみが表示され、具体的なオブジェクトの表示はサポートされていません。

      • 増分同期-DDL同期移行タイプを選択した場合、ソース側で新規作成されたテーブルはターゲット側に同期することができます。

      操作	説明
      オブジェクトのインポート	選択領域の右側のリストで、右上の インポート対象 をクリックします。詳細については、移行オブジェクトのインポートをご参照ください。	\
      名前の変更	データ移行は移行オブジェクトの名前を変更することをサポートしています。詳細については、データベース・テーブルの名前変更をご参照ください。	\
      行フィルタリング	データ移行は WHERE 条件を使用した行フィルタリングをサポートしています。詳細については、SQL条件でのデータフィルタリングをご参照ください。また、列を表示 領域で、移行オブジェクトの列情報を確認することもできます。	\
      削除/すべてクリア	データ移行では、データマッピング時に、一時的にターゲット側に選択された単一または複数のオブジェクトを削除する操作をサポートしています。 単一の移行オブジェクトの削除 選択領域の右側のリストで、対象オブジェクトの後ろにある 削除 アイコンをクリックすると、その移行オブジェクトを削除できます。 すべての移行オブジェクトの削除 選択領域の右側のリストで、右上の すべてクリア をクリックします。ダイアログボックスで、OK をクリックすると、すべての移行オブジェクトを削除できます。	\

   • ルールによる一致 を選択した場合、詳細については データベース間のマッチングルールの設定をご参照ください。

8. 次へ をクリックし、移行オプション ページで、各パラメータを設定します。

   • フル移行

     タイプとオブジェクトを選択してください ページで、一方向同期 > 完全移行 を選択した場合にのみ、以下のパラメータが表示されます。

     パラメータ	説明
     読み取り並列設定	このパラメータは、フル移行段階でソース側からデータを読み取る並列数を設定します。最大値は512です。並列数が高すぎると、ソース側の負荷が過大になり、業務に影響を与える可能性があります。
     書き込み並列設定	このパラメータは、フル移行段階でターゲット側にデータを書き込む並列数を設定します。最大値は512です。並列数が高すぎると、ターゲット側の負荷が過大になり、業務に影響を与える可能性があります。
     フル移行レートの制限を有効にするかどうか	実際のニーズに応じて、フル移行レートの制限を有効にするかどうかを決定できます。有効にする場合は、ソース側の読み取りRPS（フル移行段階で1秒間にソース側から読み取れる行数の最大制限）、ソース側の読み取りBPS（フル移行段階で1秒間にソース側から読み取れる流量の最大制限）、ターゲット側の書き込みRPS（フル移行段階で1秒間にターゲット側に書き込める行数の最大制限）、およびターゲット側の書き込みBPS（フル移行段階で1秒間にターゲット側に書き込める流量の最大制限）を設定してください。 説明 ここで設定されたRPSとBPSは、スロットリング機能としてのみ機能し、フル移行で実際に達成可能な性能は、ソース側、ターゲット側、インスタンス仕様の設定などの要因の影響を受けます。
     ターゲット側テーブルオブジェクトにレコードが存在する場合の処理ポリシー	処理ポリシーには、移行を停止する と 無視する が含まれます： 移行を停止する を選択した場合、ターゲット側のテーブルオブジェクトにデータが存在すると、フル移行はエラーとして「移行を許可できない」と表示されます。ターゲット側のデータを適切に処理した後、移行を続行してください。 注意 エラー発生後に「復元」をクリックすると、データ移行はこの設定オプションを無視し、テーブルデータの移行を続行します。操作は慎重に行ってください。 無視する を選択した場合、ターゲット側のテーブルオブジェクトにデータが存在すると、元のデータと書き込むデータが競合した場合、データ移行は競合データをログに記録し、元のデータを変更せずに書き込むポリシーでデータを書き込みます。
     インデックスの後付けを許可するかどうか	インデックスの後付け機能は、フル移行の所要時間を短縮できます。ここでは、フルデータ移行完了後にインデックスを作成するかどうかを設定できます。インデックスの後付けを選択する際の注意事項については、表の下部の説明をご参照ください。 注意 移行タイプの選択ページで、構造移行とフル移行の両方を選択している場合にのみ、このオプションの設定がサポートされます。 一意キー以外のインデックスのみ、後付け作成をサポートします。

     インデックスの後付けを許可する場合、OceanBaseデータベースのハードウェア条件と現在の業務トラフィック状況に基づき、CLIツールを使用して以下のビジネステナントパラメータを調整することを推奨します。

     // ファイルメモリバッファサイズの制限
     ALTER SYSTEM SET _temporary_file_io_area_size = '10' tenant = 'xxx';
     // OceanBaseデータベースV4.xでのトラフィック制限の無効化
     ALTER SYSTEM SET sys_bkgd_net_percentage = 100;
     

   • 増分同期

     タイプとオブジェクトを選択してください ページで、一方向同期 > 増分同期 を選択すると、以下のパラメータが表示されます。

     パラメータ	説明
     書き込み並列設定	このパラメータは、増分同期段階でターゲット側にデータを書き込む並列数を設定します。最大値は512です。並列数が高すぎると、ターゲット側の負荷が過大になり、業務に影響を与える可能性があります。
     増分移行レートの制限を有効にするかどうか	実際のニーズに応じて、増分同期レートの制限を有効にするかどうかを決定できます。有効にする場合は、ターゲット側の書き込みRPS（増分同期段階で1秒間にターゲット側に同期できるデータ行数の最大値の制限）とターゲット側の書き込みBPS（増分同期段階で1秒間にターゲット側に同期できる流量の最大値の制限）を設定してください。 説明 ここで設定されたRPSとBPSは、スロットリング機能としてのみ機能し、増分同期で実際に達成可能な性能は、ソース側、ターゲット側、インスタンス仕様の設定などの要因の影響を受けます。
     増分同期開始時点	移行タイプの選択時に 全量移行 を選択している場合、このパラメータは表示されません。 移行タイプの選択時に 全量移行 を選択していないが、増分同期 を選択している場合は、この時点以降の特定の時間のデータを移行するように指定してください。デフォルトは現在のシステム時刻です。増分同期の開始時点の設定をご参照ください。

9. 次へ をクリックすると、システムはデータ移行タスクの事前チェックを実行します。

   事前チェック プロセスでは、データ移行はデータベースユーザーの読み書き権限、データベースのネットワーク接続などが要件を満たしているかどうかをチェックします。すべてのチェックタスクが通過した場合にのみ、データ移行タスクを開始できます。事前チェックでエラーが発生した場合：

   • 問題を調査・処理した後、事前チェックを再実行し、事前チェックが成功するまで繰り返すことができます。

   • または、失敗した事前チェック項目の操作列にある スキップ をクリックすることもできます。これにより、この操作をスキップする具体的な影響を示すダイアログボックスがポップアップ表示されます。スキップしてもよいことを確認したら、ダイアログボックス内の わかりました をクリックしてください。

10. 事前チェックが成功したら、購入 をクリックし、データ移行インスタンスを購入する ページに進んで購入します。

    購入が成功すると、データ移行タスクを開始できます。購入の詳細については、データ移行インスタンスの購入をご参照ください。データ移行インスタンスの購入が一時的に不要な場合は、保存 をクリックして、データ移行タスクの詳細ページに移動し、後から必要に応じて手動で購入できます。

    データ移行の詳細ページの右上隅にある 検証タスクの設定 をクリックすると、ソースデータベースとターゲットデータベースのデータ差異を比較できます。詳細については、データ検証タスクの新規作成をご参照ください。

    データ移行サービスは、データ移行タスクの実行中に移行オブジェクトを変更することをサポートしています。詳細については、移行オブジェクトの表示と変更をご参照ください。データ移行タスクは開始後、選択した移行タイプに従って順次実行されます。詳細については、データ移行タスクの詳細の表示の「移行の詳細を見る」モジュールの内容をご参照ください。