PolarDB:自己管理 Oracle データベースから PolarDB for PostgreSQL（Oracle 互換）クラスターへのデータ移行

前提条件

開始する前に、以下の点を確認してください。

• ソースの Oracle データベースおよびターゲットの PolarDB for PostgreSQL（Oracle 互換）クラスターがいずれも作成済みである必要があります。PolarDB for PostgreSQL（Oracle 互換）クラスターの作成手順については、「クラスターの作成」をご参照ください。対応するデータベースバージョンについては、「データ移行シナリオの概要」をご参照ください。

• ソースの Oracle データベースが ARCHIVELOG モードで実行されており、アーカイブ REDO ログファイルにアクセス可能であり、保持期間が設定済みである必要があります。「アーカイブ REDO ログファイルの管理」をご参照ください。

• ソースの Oracle データベースで補足ログが有効化されており、SUPPLEMENTAL_LOG_DATA_PK および SUPPLEMENTAL_LOG_DATA_UI の値が Yes に設定されている必要があります。「補足ログ」をご参照ください。

• DTS の Oracle 移行に関する機能および制限事項を十分に理解している必要があります。移行前に、Advanced Database & Application Migration（ADAM）を使用してソースデータベースを評価してください。「Oracle データベースの準備」および「概要」をご参照ください。

課金

移行タイプ

増分移行でサポートされる SQL 操作

データ型のマッピング

「異種データベース間のデータ型マッピング」をご参照ください。

制限事項

スキーマ移行中、DTS は外部キーをターゲットデータベースに移行します。完全なデータ移行および増分データ移行中、DTS はセッションレベルで外部キーの制約チェックおよびカスケード操作を一時的に無効化します。移行中にソースデータベースで実行されたカスケード更新および削除操作により、データの不整合が発生する可能性があります。

Oracle データベースアカウントの設定

ソースの Oracle データベースにログインし、DTS 用のアカウントを作成して必要な権限を付与します。

以下の権限を備えたアカウントをすでに作成済みの場合は、この手順をスキップしてください。

アカウントの作成および権限の付与手順については、以下をご参照ください。

• 自己管理 Oracle データベース：「データベースアカウントの準備」、「CREATE USER」、「GRANT」

• PolarDB for PostgreSQL（Oracle 互換）クラスター：「データベースアカウントの作成」

移行タスクの作成

1. データ移行タスク ページに移動します。

   1. Data Management（DMS）コンソール にログインします。

   2. トップナビゲーションバーで、DTS の上にポインターを合わせます。

   3. DTS（DTS） ＞ データ移行 を選択します。

   ナビゲーションは、DMS コンソールのモードおよびレイアウトによって異なる場合があります。「シンプルモード」および「DMS コンソールのレイアウトおよびスタイルのカスタマイズ」をご参照ください。また、直接「新しい DTS コンソールのデータ移行ページ」にアクセスすることもできます。

2. データ移行タスク の右側にあるドロップダウンリストから、ご利用の移行インスタンスが配置されているリージョンを選択します。

   新しい DTS コンソールでは、左上隅のリージョンを選択します。

3. タスクの作成 をクリックします。データ移行タスクの作成 ウィザードで、ソースおよびターゲットデータベースを構成します。

   警告

   ソースおよびターゲットデータベースの構成後、次に進む前にページ上部に表示される制限事項を必ずご確認ください。この手順をスキップすると、タスクが失敗したり、データの不整合が発生したりする可能性があります。

   セクション	パラメーター	説明
   該当なし	タスク名	タスクの名前です。DTS が自動的に名前を生成します。識別しやすい名前を指定してください。名前は一意である必要はありません。
   ソースデータベース	データベースタイプ	Oracle を選択します。
   	アクセス方法	ソースデータベースへの接続方法です。本例では パブリック IP アドレス を使用します。その他のアクセス方法の場合は、事前に必要な環境を構築してください。「事前準備の概要」をご参照ください。
   	インスタンスリージョン	ソースの Oracle データベースが配置されているリージョンです。
   	ホスト名または IP アドレス	ソースの Oracle データベースのエンドポイントです。
   	ポート番号	ソースの Oracle データベースのサービスポートです。デフォルト値：1521。本例では、このポートがインターネット経由でアクセス可能である必要があります。
   	Oracle タイプ	ソースの Oracle データベースのアーキテクチャです。ノン RAC インスタンス を選択して SID パラメーターを構成するか、RAC または PDB インスタンス を選択して サービス名 パラメーターを構成します。本例では ノン RAC インスタンス を使用します。
   	データベースアカウント	ソースの Oracle データベースのアカウントです。「Oracle データベースアカウントの設定」で必要な権限をご確認ください。
   	データベースパスワード	データベースアカウントのパスワードです。
   ターゲットデータベース	データベースタイプ	PolarDB（Oracle 互換） を選択します。
   	アクセス方法	パブリック IP アドレス を選択します。
   	インスタンスリージョン	ターゲットクラスターが展開されているリージョンです。
   	データソース	単一データソース を選択してプライマリノードのエンドポイントおよびポートを構成します。複数データソース を選択して、データソースの IP:ポート フィールドに複数ノードの IP アドレスおよびポート番号を指定します。複数データソース を使用すると、プライマリ/セカンダリ スイッチオーバー時に DTS が自動的に新しいプライマリノードに切り替わり、ディザスタリカバリのシナリオに適しています。本例では 単一データソース を使用します。
   	ドメイン名または IP アドレス	ターゲットクラスターのプライマリノードのエンドポイントです。お使いのコンピューターで ping コマンドを実行して IP アドレスを取得してください。
   	ポート番号	ターゲットデータベースのサービスポートです。デフォルト値：1521。
   	データソースの IP:ポート	プライマリノードを含む複数ノードの IP アドレスおよびポート番号です。複数のエントリはカンマ（,）で区切ります。
   	データベース名	ターゲットクラスター内のデータベース名です。
   	データベースアカウント	ターゲットクラスターのアカウントです。「Oracle データベースアカウントの設定」で必要な権限をご確認ください。
   	データベースパスワード	データベースアカウントのパスワードです。

4. ソースデータベースに IP アドレスホワイトリストが設定されている場合は、DTS サーバーの CIDR ブロックをホワイトリストに追加してください。その後、接続テスト をクリックします。

   警告

   DTS サーバーの CIDR ブロックをデータベースのホワイトリストまたは ECS セキュリティグループに追加すると、セキュリティリスクが発生する可能性があります。実行前に、アカウント認証情報の強化、公開ポートの制限、API 呼び出しの検証、ホワイトリストルールの定期的な監査などの予防措置を講じてください。パブリック IP アドレスの代わりに、Express Connect、VPN Gateway、または Smart Access Gateway を使用してデータベースと DTS を接続することを検討してください。

5. 移行対象のオブジェクトおよび高度な設定を構成します。

   パラメーター	説明
   移行タイプ	一度限りの移行の場合は、スキーマ移行 および 完全なデータ移行 を選択します。サービスの停止を伴わずに移行する場合は、増分データ移行 も選択します。 説明 増分データ移行 を選択しない場合、データ整合性を保つため、移行中にソースデータベースへの書き込みを避けてください。
   プライマリキー／一意キーのないテーブルに非表示のプライマリキーを追加	移行対象のテーブルのいずれかにプライマリキーまたは一意キーがない場合、はい に設定します。DTS は、ターゲットで Oracle の ROWID カラムを非表示のプライマリキーとして使用し、重複データを防止します。このパラメーターは、スキーマ移行、完全なデータ移行、および 増分データ移行 のすべてが選択されている場合にのみ利用可能です。
   競合テーブルの処理モード	事前チェックおよびエラー報告：DTS は、ターゲットデータベースにソースと同じ名前のテーブルが存在するかどうかをチェックします。重複が見つかった場合、事前チェックは失敗し、タスクは開始できません。オブジェクト名マッピング機能を使用して競合するテーブルの名前を変更してください。「オブジェクト名のマッピング」をご参照ください。エラーを無視して続行：重複テーブル名の事前チェックをスキップします。ソースおよびターゲットのスキーマが同一で、レコードが既存のターゲットレコードとプライマリキーを共有する場合：完全移行中は DTS がレコードをスキップし、増分移行中は DTS が既存レコードを上書きします。スキーマが異なる場合、特定のカラムのみが移行されるか、タスクが失敗します。慎重に使用してください。
   ソースオブジェクト	1 つ以上のオブジェクトを選択します。 アイコンをクリックして、選択済みオブジェクト に移動します。
   選択済みオブジェクト	単一のオブジェクトの名前を変更するには、右クリックします。「単一オブジェクトの名前をマップする」をご参照ください。複数のオブジェクトを一度に名前変更するには、一括編集 をクリックします。「複数のオブジェクト名を一度にマップする」をご参照ください。 説明 オブジェクトの名前を変更すると、それに依存する他のオブジェクトの移行が失敗する可能性があります。行をフィルターするには、テーブルを右クリックして WHERE 条件を指定します。「フィルター条件の指定」をご参照ください。増分移行で特定の SQL 操作を選択するには、オブジェクトを右クリックして操作を選択します。

6. 次へ：高度な設定 をクリックし、以下の設定を構成します。データ検証設定 「データ検証タスクの構成」をご参照ください。

   高度な設定

   パラメーター	説明
   タスクスケジューリング専用クラスター	デフォルトでは、DTS はタスクを共有クラスターにスケジュールします。専用クラスターを使用するには、必要な仕様で購入してください。「DTS 専用クラスターとは？
   接続失敗時の再試行時間	接続失敗後に DTS が再試行する時間です。有効範囲：10～1440 分。デフォルト値：720 分。30 分より大きい値を設定してください。この期間内に DTS が再接続できた場合、タスクは再開されます。そうでない場合、タスクは失敗します。 説明 複数のタスクが同じソースまたはターゲットデータベースを共有する場合、最も最近に構成された再試行時間が優先されます。再試行中は、インスタンスに対して課金されます。
   その他の問題発生時の再試行時間	DDL または DML 操作失敗後に DTS が再試行する時間です。有効範囲：1～1440 分。デフォルト値：10 分。10 分より大きい値を設定してください。 重要 この値は、接続失敗時の再試行時間 より小さい必要があります。
   完全なデータ移行のスロットリングを有効化	完全移行中の読み取り／書き込みリソース使用量を制限して、サーバー負荷を軽減します。ソースデータベースへのクエリ数（QPS）、完全データ移行の RPS、完全移行のデータ移行速度（MB/s） を構成します。完全なデータ移行 が選択されている場合にのみ利用可能です。
   増分データ移行のスロットリングを有効化	増分移行中のリソース使用量を制限します。増分データ移行の RPS および 増分移行のデータ移行速度（MB/s） を構成します。増分データ移行 が選択されている場合にのみ利用可能です。
   環境タグ	DTS インスタンスを識別するための任意のタグです。
   実際の書き込みコード	ターゲットデータベースへのデータ書き込みに使用するエンコード形式です。
   ETL の構成	抽出・変換・書き出し（ETL）機能を有効化します。はい を選択すると、コードエディタでデータ処理ステートメントを入力できます。「データ移行またはデータ同期タスクにおける ETL の構成」をご参照ください。いいえ を選択すると、ETL 構成をスキップします。「ETL とは？
   モニタリングとアラート	タスク失敗または遅延がしきい値を超えた場合のアラートを構成します。はい を選択すると、アラートのしきい値および通知設定を構成できます。「DTS タスク作成時のモニタリングおよびアラートの構成」をご参照ください。

7. 次へ：タスク設定の保存および事前チェック をクリックします。このタスク構成の API パラメーターを表示するには、次へ：タスク設定の保存および事前チェック の上にポインターを合わせ、OpenAPI パラメーターのプレビュー をクリックします。

   DTS はタスク開始前に事前チェックを実行します。事前チェックに合格した場合にのみタスクを開始できます。事前チェックに失敗した場合は、各失敗項目の横にある 詳細の表示 をクリックし、問題をトラブルシューティングした後、再チェック をクリックしてください。無視可能な警告項目がある場合は、警告の詳細の確認 ＞ 無視 ＞ OK ＞ 再チェック の順にクリックしてください。警告項目を無視すると、データの不整合が発生する可能性があります。

8. 成功率 が 100% になるまで待機し、次へ：インスタンスの購入 をクリックします。

9. インスタンスの購入 ページで、インスタンスクラスを構成します。

   セクション	パラメーター	説明
   新規インスタンスクラス	リソースグループ	移行インスタンスのリソースグループです。デフォルト値：デフォルトのリソースグループ。「Resource Management とは？
   	インスタンスクラス	インスタンスクラスは移行速度を決定します。要件に応じてクラスを選択してください。「データ移行インスタンスのインスタンスクラス」をご参照ください。

10. Data Transmission Service（従量課金）サービス利用規約 のチェックボックスを読み、選択します。

11. 購入および開始 をクリックします。確認ダイアログで OK をクリックします。データ移行 ページで移行の進行状況を確認できます。

次のステップ

非表示のプライマリキーの削除（該当する場合）

プライマリキー／一意キーのないテーブルに非表示のプライマリキーを追加 を はい に設定した場合、ワークロードをターゲットクラスターに切り替えた後、DTS インスタンスを終了する前に非表示のプライマリキーを削除してください。完全なデータ移行 または 増分書き込み モジュールの 基本情報 タブで、アクション 列の 非表示のプライマリキーの削除 をクリックします。

シーケンスの初期値のリセット

ワークロードをターゲットに切り替えた後、新しく書き込まれるシーケンスはソースデータベースの最大値から連続しません。切り替え前にソースデータベースから最大シーケンス値を照会し、それらの値をターゲットの初期値として設定してください。

ソースの Oracle データベースから最大シーケンス値を照会するには、以下のコマンドを実行します。

DECLARE
  CURSOR cur_data IS
    SELECT SEQUENCE_NAME, LAST_NUMBER FROM user_sequences;
  v_column1_value varchar(1000);
  v_column2_value number(20);
BEGIN
  dbms_output.enable(NULL);
  OPEN cur_data;
  LOOP
    FETCH cur_data INTO v_column1_value, v_column2_value;
    EXIT WHEN cur_data%NOTFOUND;
    DBMS_OUTPUT.PUT_LINE('select setval(''' || lower(v_column1_value) || ''', ' || v_column2_value || ');');
  END LOOP;
  CLOSE cur_data;
END;
/

出力には、ソースデータベース内のすべてのシーケンスに対する setval ステートメントが含まれます。ターゲットデータベースで、ワークロードに関連するシーケンスのみのステートメントを実行してください。