OceanBaseデータベースの同一互換モード間でのデータ移行

OceanBaseデータベースから同じ種類のOceanBaseデータベーステナントへのデータ移行タスクを新規作成し、構造移行、フル移行、増分同期を通じて、ソースデータベースの既存業務データと増分データをターゲットデータベースにシームレスに移行できます。

前提条件

• ターゲット側のOceanBaseデータベースに対応するスキーマが作成されています。

• ソース側およびターゲット側のOceanBaseデータベースのクラスタとテナントが作成されています。詳細については、クラスタの作成およびテナントの作成をご参照ください。

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

利用制限

• プロジェクトロールが プロジェクト所有者、プロジェクト管理者、または データサービス管理者 のいずれかであるユーザーのみが新規データ移行タスクの作成をサポートします。

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

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

• 現在、データ移行はOceanBaseデータベース（MySQLおよびOracle互換モードを含む）V2.x、V3.x、およびV4.xをサポートしています。

• データ移行はクラスタインスタンスのみをサポートしており、共有インスタンスは現在サポートしていません。

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

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

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

注意事項

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

• ノード間の時刻同期が取れていない場合、またはクライアント端末とサーバー間の時刻が同期されていない場合、増分同期の遅延時間が正確でない可能性があります。

例えば、時計が標準時刻より早い場合、遅延時間が負の値になる可能性があります。時計が標準時刻より遅い場合、遅延が発生する可能性があります。

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

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

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

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

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

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

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

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

• OceanBaseデータベースをソースとして増分同期を実行する場合、データベーステーブルにUDT列が含まれていると、UDT列はサポート対象外のため、増分同期タスクが失敗する可能性があります。

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

操作手順

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

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

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

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

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

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

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

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

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

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

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

インスタンスタイプが 自己構築データベース の場合、構造移行と増分同期を行う必要がある場合は、詳細設定 セクションで各パラメータを設定します。

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

• タイプとオブジェクトの選択 ページで 増分同期 を選択する場合は、増分ログプロキシサービスを有効にし、OBLogProxy が情報を受信します を入力してください。

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

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

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

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

インスタンスタイプが 自己構築データベース の場合、構造移行と増分同期を行う必要がある場合は、詳細設定 セクションで各パラメータを設定します。

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

• タイプとオブジェクトの選択 ページで 増分同期 を選択する場合は、増分ログプロキシサービスを有効にし、OBLogProxy が情報を受信します を入力してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• フル移行

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

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

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

• 増分同期

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

• 詳細オプション

ターゲット側のOceanBaseデータベースがV4.3.0以降のバージョンであり、かつ タイプとオブジェクトの選択 ページで、スキーマ移行 または 増分同期 > DDL同期期間 を選択した場合にのみ、このセクションのパラメータが表示されます。

ターゲット側テーブルオブジェクトのストレージタイプには、デフォルト、行ストレージ、リスト、および 行列混合ストレージ が含まれます。この設定は、構造移行または増分同期時のターゲット側テーブルオブジェクトのストレージタイプを決定するために使用されます。

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

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

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

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

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

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

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

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