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時間以上保存する必要があります。

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

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

データ型のマッピング

手順

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

   

   1. OB Cloud クラウドデータベースコンソールにログインします。

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

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

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

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

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

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

   1. ソース側 セクションで、各パラメータを設定します。

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

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

      パラメータ	説明
      クラウドベンダー	現在、AWS、ファーウェイクラウド、Alibaba Cloud、および Tencent Cloud をサポートしています。
      データベースタイプ	ソースを OceanBase MySQL Compatible に設定します。
      インスタンスタイプ	クラスタインスタンス（トランザクション型） と 自己構築データベース が含まれます。現在、クラスタインスタンス（トランザクション型） のデータをMySQLデータベースに移行することのみをサポートしています。
      リージョン	ソースデータベースのリージョンを選択します。
      接続タイプ	エンドポイント と パブリックネットワーク接続 が含まれます。 エンドポイント 接続方式を選択した場合は、ページに表示されているアカウントIDをエンドポイントサービスのホワイトリストに追加し、そのアカウントのエンドポイントがエンドポイントサービスに接続できるようにする必要があります。詳細については、プライベートネットワーク接続の選択 モジュールのドキュメントを参照してください。 パブリックネットワーク接続 接続方式を選択した場合は、ページに表示されているデータソースIPアドレスをOceanBaseデータベースインスタンスのホワイトリストに追加し、接続性を確保する必要があります。詳細については、パブリックネットワーク接続の選択 モジュールのドキュメントを参照してください。 説明 このパラメータは、インスタンスタイプがオンプレミスデータベースの場合にのみ表示されます。ソース側とターゲット側のリージョンを選択すると、ページにはホワイトリストに追加する必要があるデータソース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 です。

   2. ターゲット側 セクションで、各パラメータを設定します。

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

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

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

4. 接続テストをして、次へ移動 をクリックします。

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

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

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

   • クラウドベンダー を Tencent Cloud に選択した場合、エンドポイント タブに移動し、エンドポイントの状態接続リクエストを受け入れる必要があります。詳細については、エンドポイント接続の管理 を参照してください。

5. タイプとオブジェクトの選択 ページで、各パラメータを設定します。

   1. 同期トポロジー セクションで、一方向の同期 を選択します。

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

   2. 移行タイプ セクションで、現在のデータ移行タスクの移行タイプを選択します。

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

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

   3. 移行オブジェクトの選択 セクションで、移行対象の選択方法を設定します。

      オブジェクトの指定 と マッチングルール の2つの方法で移行対象を選択できます。

   4. 移行範囲の選択 セクションで、移行する対象を選択します。

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

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

        データ移行では、テキストを使ったオブジェクトのインポート、ターゲット側のオブジェクト名の変更、行フィルターの設定、列情報の表示、単一またはすべての移行オブジェクトの削除などの操作をサポートしています。

        

      説明

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

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

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

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

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

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

   • フル移行

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

     

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

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

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

   • 問題を調査・解決した後、事前チェックを再実行し、合格するまで繰り返してください。

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

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

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

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

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