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

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

背景情報

データ移行では、複数のOceanBaseデータベースのOracle互換モードのテーブルデータを、Oracleデータベースの単一のテーブルに集約することがサポートされています。この場合、構造移行は不要で、全量移行と増分同期のみが必要です。この集約同期機能の制限事項は以下の通りです：

• 全量移行と増分同期において、ソース側にある列はターゲット側にも存在していなければなりません。この要件を満たさない場合、データ移行はエラーとなります。

• プライマリキー列はデータ送信元のテーブルに存在している必要があります。

• データ送信先テーブルには、データ送信元にはない列を含めることができます。

前提条件

• データ送信先のOracleデータベースに対応するスキーマが作成済みであること。

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

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

利用制限

• データ移行タスクの新規作成は、プロジェクトロールが プロジェクト所有者、プロジェクト管理者、または データサービス管理者 のユーザーのみが実行できます。

• データ送信元データベースの操作制限

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

• 現在、データ移行はOracleデータベースの10G/11G/12C/18C/19Cバージョンをサポートしています。12C以降のバージョンには、コンテナデータベース（Container Database、CDB）とプラガブルデータベース（Pluggable Database、PDB）が含まれます。同時に、OceanBaseデータベースのOracle互換モードV2.x、V3.x、V4.xもサポートしています。

• データ移行サービスは、テーブル内のすべての列がLOB型（BLOB/CLOB/NCLOB）である場合の増分データ移行をサポートしていません。

• データ移行サービスは、OceanBaseデータベースのOracle互換モードの非テンプレート型コンポジット・パーティションテーブルからOracleデータベースへの移行をサポートしていません。

• データ移行サービスは、現在、式に基づくインデックスをサポートしていません。

• データ移行サービスは、主キーを持つテーブルの複数テーブル集約のみをサポートしています。

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

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

• データソース識別子やユーザーアカウントなどは、データ移行サービスシステム内でグローバルに一意である必要があります。​

• Oracleデータベース11G及びそれ以前のバージョンでは、名前が30バイトを超えるデータベースオブジェクトの作成はサポートされていません。OceanBaseデータベースのOracle互換モードのデータをOracleデータベースに移行する際は、データ送信元でこの制限を超えるデータベースオブジェクトを作成できません。

注意事項

• OceanBaseデータベースV4.xでは、アーカイブログを有効にすることを強く推奨します。アーカイブログを有効にした後、Clogが回収されても、データ移行サービスはアーカイブログを消費することで増分同期機能を実現できます。

• データ送信元の文字セットがUTF-8の場合、データ送信先ではデータ送信元と互換性のある文字セット（例：UTF-8、UTF-16など）を使用し、文字セットの不整合によるデータ送信先での文字化けなどの問題を避けることを推奨します。

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

  例えば、システム時刻が標準時より前の時刻を示している場合、遅延時間が負の値になる可能性があります。標準時より後の時刻を示している場合、遅延が発生する可能性があります。

• OracleデータベースとOceanBaseデータベースのOracle互換モードで文字セットが異なる場合、データ移行タスクの状況に応じてフィールド長の処理ポリシーを選択できます。

• ソース側テーブルに「OMS_PK_INCRMT」というフィールド名が含まれている場合、増分同期タスクは中断され、再開できません。

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

• OceanBaseデータベースのOracle互換モードのリサイクルビン内のオブジェクトを確認してください。オブジェクト数が100を超えると、内部テーブルのクエリがタイムアウトしやすくなります。リサイクルビンのオブジェクトをクリーンアップしてください。

• Oracleデータベースのリサイクルビン内のオブジェクトを確認してください。オブジェクト数が100を超えると、内部テーブルのクエリがタイムアウトしやすくなります。リサイクルビンのオブジェクトをクリーンアップしてください。

  • リサイクルビンが有効になっているか確認してください。

    SELECT Value FROM V$parameter WHERE Name = 'recyclebin';
    

  • リサイクルビン内のオブジェクト数を確認してください。

    SELECT COUNT(*) FROM RECYCLEBIN;
    

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

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

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

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

サポートされているデータ送信元およびデータ送信先インスタンスタイプ

データ型のマッピング

手順

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

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

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

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

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

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

   数字、英字の組み合わせを使用することをお勧めします。名前にはスペースを含めることができず、長さは64文字を超えてはなりません。

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

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

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

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

      パラメータ	説明
      クラウドベンダー	現在、Alibaba Cloud、AWS、Google Cloud のみサポートしています。
      データベースタイプ	データ送信元を OceanBase Oracle Compatible に設定します。
      インスタンスタイプ	Dedicated (Transactional) と Self-managed Database が含まれますが、現在は Dedicated (Transactional) のデータをOracleデータベースに移行することのみサポートしています。
      リージョン	データ送信元データベースのリージョンを選択します。
      インスタンス	OceanBaseデータベースのOracle互換モードのテナントが存在するインスタンスのIDまたは名前です。インスタンス ページで、対象インスタンスのIDまたは名前を確認できます。 説明 クラウドベンダーがAlibaba Cloudの場合、アカウント間の権限付与をサポートするAlibaba Cloudのメインアカウントインスタンスの選択も可能です。詳細については、Alibaba Cloudアカウントの権限付与を参照してください。
      テナント	OceanBaseデータベースのOracle互換モードテナントのIDまたは名前です。インスタンス ページで、ターゲットインスタンスを展開し、そのインスタンス内のターゲットテナントのIDまたは名前を確認できます。
      データベースアカウント	データ移行用のOceanBaseデータベースOracle互換モードテナントのユーザー名。
      パスワード	データベースユーザーのパスワード。

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

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

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

      パラメータ	説明
      クラウドベンダー	現在は Alibaba Cloud、AWS、および Google Cloud のみをサポートしています。 ソースと同じクラウドベンダーを選択するか、異なるクラウドベンダー間でデータ移行を実行できます。 説明 現在、クロスクラウドベンダーデータ移行機能はデフォルトで無効です。この機能を使用する場合は、OceanBase Cloudのテクニカルサポートにお問い合わせください。
      データベースタイプ	ターゲットを Oracle として選択します。
      インスタンスタイプ	クラウドベンダーを AWS に設定した場合、インスタンスタイプは RDS Oracle と セルフマネージド Oracle をサポートします。 クラウドベンダーを Alibaba Cloud または Google Cloud に設定した場合、インスタンスタイプは セルフマネージド Oracle をサポートします。
      リージョン	データ送信先データベースのリージョンを選択します。
      接続タイプ	エンドポイント と パブリック接続 が含まれます。クラウドベンダー を Alibaba Cloud、AWS、または Google Cloud に設定した場合、ピアリング接続 もサポートされます。 エンドポイント 接続方式を選択した場合、ページに表示されているアカウントIDをエンドポイントサービスの許可リストに追加し、そのアカウントのエンドポイントがエンドポイントサービスに接続できるようにする必要があります。詳細については、プライベート接続の選択を参照してください。 クラウドベンダー を AWS に設定し、エンドポイントサービス作成時にパラメータ エンドポイント接続の承諾を要求 で 有効にする を選択した場合、データ移行サービスが初めてプライベート接続にアクセスする際、AWSコンソールにアクセスし、受信したConnectionsリクエストに対して Accept endpoint connection request 操作を実行するよう求められます。 クラウドベンダーを Google Cloud に設定した場合、Published Servicesに認可プロジェクトを追加してください。認可後は、データソースの接続テスト時に手動で認可する必要はありません。 パブリック接続 接続方式を選択した場合、ページに表示されているデータソースIPアドレスをOracleデータベースインスタンスの許可リストに追加し、接続性を確保する必要があります。詳細については、パブリック接続の選択を参照してください。 説明 ソースとターゲットのリージョンを選択すると、ページに許可リストに追加する必要があるデータソースIPアドレスが表示されます。 ピアリング接続を選択した場合、ドロップダウンリストから利用可能なピアリング接続を選択し、ページに表示されているIPアドレスをOracleデータベースインスタンスのセキュリティグループのインバウンドルールまたは許可リストに追加して、接続性を確保してください。具体的な操作については、AWSピアリング接続、Alibaba Cloudピアリング接続、Google Cloudピアリング接続を参照してください。
      ピアリング接続ID	接続タイプが ピアリング接続 の場合にのみ表示されます。ドロップダウンリストから利用可能なピアリング接続を選択します。ドロップダウンリストには、現在のクラウドベンダーとリージョンが一致し、状態が 接続済み のピアリング接続のみが表示され、対応するVPC IDとCIDRが表示されます。利用可能な接続がない場合、新規 をクリックして、新しいタブでデータサービスのピアリング接続を作成できます。
      接続情報	接続タイプ を エンドポイント に設定した場合、エンドポイントサービス名を入力してください。 接続タイプ を パブリック接続 に設定した場合、データベースホストのIPアドレスとポート番号を入力してください。 接続タイプ を ピアリング接続 に設定した場合、データベースホストのプライベートIPアドレス、またはドメイン名とポート番号を入力してください。
      Service Name	OracleデータベースのService名。
      データベースアカウント	データ移行用のOracleデータベースのユーザー名。
      パスワード	データベースユーザーのパスワード。

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

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

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

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

   2. タイプとオブジェクトを選択 ステップで、現在のデータ移行タスクの移行タイプを選択します。

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

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

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

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

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

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

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

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

        説明

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

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

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

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

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

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

   • 全量移行

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

     パラメータ	説明
     読み取り並列設定	このパラメータは、全量移行段階でソース側からデータを読み取る並列数を設定します。最大値は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;
     

   • 増分同期

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

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

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

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

   • 問題を調査・解決した後、事前チェックを再実行し、成功するまで繰り返します。

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

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

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

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

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