すべてのプロダクト
Search
ドキュメントセンター

Data Transmission Service:PolarDB-X 2.0 から AnalyticDB for PostgreSQL への移行

最終更新日:Jul 18, 2026

Data Transmission Service (DTS) を使用して、PolarDB-X 2.0 インスタンスから AnalyticDB for PostgreSQL インスタンスにデータを移行できます。

前提条件

  • ソースとなる PolarDB-X 2.0 インスタンスが存在していること。詳細については、「インスタンスの作成」をご参照ください。

  • ターゲットとなる AnalyticDB for PostgreSQL インスタンスが存在していること。詳細については、「インスタンスの作成」をご参照ください。

  • ターゲットとなる AnalyticDB for PostgreSQL インスタンスのストレージ容量は、ソースとなる PolarDB-X 2.0 インスタンスで使用されているストレージ容量を超える必要があります。

注意事項

種別

説明

ソースデータベースの制限事項

  • 移行対象のテーブルにはプライマリキーまたは一意制約が設定されており、そのキーまたは制約に含まれるフィールドが一意である必要があります。この要件を満たさない場合、ターゲットデータベースに重複データが発生する可能性があります。

  • Enterprise Edition PolarDB-X 2.0 の読み取り専用インスタンスは、ソースデータベースとしてサポートされていません。

  • テーブル単位でオブジェクトを移行し、列名のマッピングなど編集を行う場合、1 つのデータ移行タスクで最大 1,000 テーブルまでサポートされます。この上限を超えると、タスクの送信が失敗します。この場合は、複数のデータ移行タスクに分割するか、データベース全体を移行するタスクを構成してください。

  • 増分データ移行を行う場合、ソースデータベースは次のバイナリログ要件を満たす必要があります。

    • バイナリログ機能を有効化し、binlog_row_image パラメーターを full に設定してください。設定しない場合、事前チェックに失敗し、データ移行タスクを開始できません。

    • 増分データ移行タスクの場合、DTS ではソースデータベースのバイナリログを少なくとも 24 時間保持する必要があります。完全なデータ移行と増分データ移行の両方を含むタスクの場合、バイナリログは少なくとも 7 日間保持する必要があります。完全なデータ移行が完了した後は、保持期間を 24 時間に変更できます。必要な期間以上バイナリログを保持しない場合、DTS がバイナリログを取得できず、タスクが失敗したり、データの不整合や損失が発生したりする可能性があります。バイナリログの保持期間が不足することによる問題は、DTS の SLA の対象外です。

  • ソースデータベースに対する操作上の制限事項:

    • スキーマ移行および完全なデータ移行中は、データベースまたはテーブルスキーマを変更する DDL 操作を実行しないでください。実行すると、データ移行タスクが失敗します。

      説明

      完全なデータ移行中、DTS はソースデータベースに対してクエリを実行します。この操作によりメタデータロックが発生し、ソースデータベースでの DDL 操作がブロックされる可能性があります。

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

    • 移行中に PolarDB-X 2.0 インスタンスのネットワークタイプを変更する必要がある場合は、変更完了後に移行タスクのネットワーク接続情報を更新してください。

    • 完全なデータ移行のみを実行する場合、移行中はソースデータベースに新しいデータを書き込まないでください。書き込むと、ソースデータベースとターゲットデータベースの間でデータ整合性が失われます。リアルタイムのデータ整合性を維持するには、スキーマ移行、完全なデータ移行、および増分データ移行を選択してください。

  • テーブルグループ (TABLEGROUP) および Locality 属性を持つデータベースまたはテーブルの移行はサポートされていません。

  • select などの予約語をテーブル名として使用しているテーブルの移行はサポートされていません。

  • PolarDB-X 2.0 インスタンスにおいて、DRDS モードのデータベースパーティションの同期はサポートされていません。

  • DTS 移行タスクの実行中に、ソース PolarDB-X 2.0 インスタンス内のブロードキャストテーブルのタイプを変更すること(たとえば、ブロードキャストテーブルを通常のテーブルまたはシャードテーブルに変更すること)はサポートされていません。テーブルタイプを変更する場合は、まず移行タスクを停止し、変更完了後に移行タスクを再構成してください。

その他の制限事項

  • テーブル単位の移行のみがサポートされています。AO テーブルはターゲットテーブルとしてサポートされていません。

  • 列マッピングを使用する場合やテーブルスキーマが一致しない場合、ターゲットテーブルに存在しないソース列のデータは失われます。

  • 移行対象のテーブルにプライマリキーが存在する場合、ターゲットテーブルのプライマリキー列はソーステーブルと同じである必要があります。移行対象のテーブルにプライマリキーが存在しない場合、ターゲットテーブルのプライマリキー列は分散キーと同じである必要があります。

  • ターゲットテーブルの一意キー(プライマリキー列を含む)は、分散キーのすべての列を含んでいる必要があります。

  • データ移行を開始する前に、ソースおよびターゲットデータベースのパフォーマンスを評価してください。オフピーク時間帯にデータ移行を実行することを推奨します。完全なデータ移行は、両方のデータベースの読み取りおよび書き込みリソースを消費し、負荷が増加します。

  • DTS は失敗した移行タスクを 7 日以内に復旧しようと試みます。そのため、ビジネスをターゲットインスタンスに切り替える前に、タスクを終了またはリリースするか、ターゲットインスタンスへのアクセスに DTS が使用するアカウントの書き込み権限を revoke コマンドで取り消してください。これにより、タスクが自動的に復旧した後にソースデータがターゲットインスタンスのデータを上書きすることを防止できます。

  • タスクが失敗した場合、DTS サポートスタッフは 8 時間以内に復旧を試みます。復旧中は、タスクを再起動したり、パラメーターを調整したりする場合があります。

    説明

    データベースパラメーターではなく、DTS タスクパラメーターのみが変更されます。 調整対象となるパラメーターは、「インスタンスパラメーターの変更」に記載されています。

その他の注意事項

DTS は、バイナリログ位置を進めるために、定期的にソースデータベース内の dts_health_check.ha_health_check テーブルを更新します。

課金

移行タイプ リンク構成料金 データ転送料金
スキーマ移行 + 完全なデータ移行 無料 無料(ただし、ターゲットアクセス方法が パブリック IP アドレス の場合は除く — 「課金概要」をご参照ください)
増分データ移行 課金対象 — 「課金概要

移行タイプ

  • スキーマ移行

    DTS は、移行オブジェクトのスキーマ定義をソースデータベースからターゲットデータベースに移行します。

  • 完全移行

    DTS は、指定された移行オブジェクトの既存データをすべてソースデータベースからターゲットデータベースに移行します。

  • 増分移行

    完全移行完了後、DTS はソースデータベースからの増分データ更新をターゲットデータベースに移行します。増分移行により、セルフマネージドアプリケーションを中断せずにスムーズにデータ移行できます。

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

操作タイプ

SQL ステートメント

DML

INSERT、UPDATE、DELETE

説明

ターゲット AnalyticDB for PostgreSQL インスタンスにデータを書き込む際、システムは自動的に UPDATE ステートメントを REPLACE INTO ステートメントに変換します。UPDATE ステートメントでプライマリキーが変更される場合は、代わりに DELETE ステートメントと INSERT ステートメントに変換されます。

DDL

ADD COLUMN

データベースアカウントの権限要件

データベース

スキーマ移行

完全移行

増分移行

PolarDB-X 2.0 インスタンス

SELECT 権限

SELECT 権限

移行対象オブジェクトに対する REPLICATION SLAVE、REPLICATION CLIENT、および SELECT 権限。

説明

データベースアカウントに権限を付与する方法については、「PolarDB-X 向けデータ同期ツール」をご参照ください。

AnalyticDB for PostgreSQL

読み取りおよび書き込み権限

データ型マッピング

詳細については、「初期スキーマ同期のデータ型マッピング」をご参照ください。

操作手順

  1. 次のいずれかの方法で、ターゲットリージョンの移行タスクリストページに移動します。

    DTS コンソールから

    1. Data Transmission Service (DTS) コンソールにログインします。

    2. 左側のナビゲーションウィンドウで、データの移行 をクリックします。

    3. ページ左上隅で、移行インスタンスが配置されているリージョンを選択します。

    DMS コンソールから

    説明

    実際の操作は、DMS コンソールのモードおよびレイアウトによって異なる場合があります。詳細については、「シンプルモードコンソール」および「DMS コンソールのレイアウトとスタイルのカスタマイズ」をご参照ください。

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

    2. 上部メニューバーで、Data + AI > Data Transmission (DTS) > データ移行 を選択します。

    3. データ移行タスク の右側で、移行インスタンスが配置されているリージョンを選択します。

  2. タスクの作成 をクリックして、タスク構成ページに移動します。

  3. ソースデータベースおよびターゲットデータベースを構成します。

    警告

    ソースおよびターゲットインスタンスを選択した後、ページ上部に表示される 制限事項 を確認し、移行タスクを正常に作成および実行できることを保証してください。

    セクション

    パラメーター

    説明

    該当なし

    タスク名

    DTS は自動的にタスク名を生成します。識別しやすいように、わかりやすい名前を指定してください。名前は一意である必要はありません。

    ソースデータベース

    既存の接続情報の選択

    • システムに追加済み(作成または保存済み)のデータベースインスタンスを使用する場合は、ドロップダウンリストから目的のデータベースインスタンスを選択します。以下のデータベース情報が自動的に構成されます。

      説明

      DMS コンソールでは、このパラメーターの名前は DMS データベースインスタンスの選択 です。

    • データベースインスタンスをシステムに登録していない場合、または登録済みのインスタンスを使用しない場合は、以下でデータベース情報を手動で構成してください。

    データベースタイプ

    PolarDB-X 2.0 を選択します。

    アクセス方法

    Alibaba Cloud インスタンス を選択します。

    インスタンスリージョン

    ソース PolarDB-X 2.0 インスタンスが配置されているリージョンを選択します。

    Alibaba Cloud アカウント間でデータを複製

    この例では、同一 Alibaba Cloud アカウント内でデータを移行します。× を選択します。

    インスタンス ID

    ソース PolarDB-X 2.0 インスタンスのインスタンス ID を選択します。

    データベースアカウント

    ソース PolarDB-X 2.0 インスタンスのデータベースアカウントを入力します。必要な権限の詳細については、「データベースアカウントの権限要件」をご参照ください。

    データベースパスワード

    データベースアカウントのパスワードを入力します。

    宛先データベース

    既存の接続情報の選択

    • システムに追加済み(作成または保存済み)のデータベースインスタンスを使用する場合は、ドロップダウンリストから目的のデータベースインスタンスを選択します。以下のデータベース情報が自動的に構成されます。

      説明

      DMS コンソールでは、このパラメーターの名前は DMS データベースインスタンスの選択 です。

    • データベースインスタンスをシステムに登録していない場合、または登録済みのインスタンスを使用しない場合は、以下でデータベース情報を手動で構成してください。

    データベースタイプ

    AnalyticDB for PostgreSQL を選択します。

    アクセス方法

    Alibaba Cloud インスタンス を選択します。

    インスタンスリージョン

    ターゲット AnalyticDB for PostgreSQL インスタンスが配置されているリージョンを選択します。

    インスタンス ID

    ターゲット AnalyticDB for PostgreSQL インスタンスのインスタンス ID を選択します。

    データベース名

    AnalyticDB for PostgreSQL インスタンス内のターゲットデータベース名を入力します。

    データベースアカウント

    ターゲット AnalyticDB for PostgreSQL インスタンスのデータベースアカウントを入力します。

    データベースのパスワード

    データベースアカウントのパスワードを入力します。

  4. 構成が完了したら、ページ下部の 接続をテストして続行 をクリックします。

    説明

    DTS サービスの IP アドレスセグメントが、ソースおよびターゲットデータベースのセキュリティ設定に自動または手動で追加され、DTS サーバーからのアクセスが許可されていることを確認してください。詳細については、「DTS サーバーの IP アドレスをホワイトリストに追加する」をご参照ください。

  5. タスクオブジェクトを構成します。

    1. オブジェクト設定 ページで、移行するオブジェクトを構成します。

      パラメーター

      説明

      移行タイプ

      • 完全なデータ移行のみを実行する場合は、スキーマ移行完全データ移行 の両方を選択します。

      • ダウンタイムなしでオンライン移行を実行する場合は、スキーマ移行完全データ移行、および 増分データ移行 を選択します。

      説明
      • スキーマ移行 を選択すると、ソースデータベースの外部キーもターゲットデータベースに移行されます。

      • 完全データ移行 を選択すると、CREATE TABLE 文を使用して作成されたテーブルのスキーマおよびデータがターゲットデータベースに移行されます。

      • 増分データ移行 を選択しない場合、データ整合性を確保するために、データ移行中はソースインスタンスに新しいデータを書き込まないでください。

      競合テーブルの処理モード

      • エラーの事前チェックと報告:ターゲットデータベース内に同名のテーブルが存在するかどうかをチェックします。同名のテーブルが存在しない場合は、事前チェックに合格します。同名のテーブルが存在する場合は、事前チェック中にエラーが報告され、データ移行タスクは開始されません。

        説明

        ターゲットデータベース内のテーブルが同名であるが、簡単に削除または名前変更できない場合は、ターゲットデータベース内のテーブル名を変更できます。詳細については、「オブジェクト名マッピング」をご参照ください。

      • エラーを無視して続行:同名のテーブルのチェックをスキップします。

        警告

        エラーを無視して続行 を選択すると、データの不整合やビジネスリスクが発生する可能性があります。たとえば、次のようになります。

        • テーブルスキーマが一致しており、ターゲットデータベース内のレコードがソースデータベース内のレコードと同じプライマリキー値を持つ場合:

          • 完全移行中、DTS はターゲットデータベース内のレコードを保持します。ソースデータベースからのレコードは移行されません。

          • 増分移行中、DTS はターゲットデータベース内のレコードを保持しません。ソースデータベースからのレコードがターゲットデータベース内のレコードを上書きします。

        • テーブルスキーマが一致しない場合、一部の列のデータのみが移行されるか、移行が失敗する可能性があります。慎重に操作してください。

      ストレージエンジンタイプ

      ビジネス要件に基づいて、ターゲットテーブルのストレージエンジンを選択します。デフォルト値は Beam です。

      説明

      このパラメーターは、ターゲット AnalyticDB for PostgreSQL インスタンスのカーネルバージョンが v7.0.6.6 以降であり、かつ スキーマ移行 パラメーターに対して 移行タイプ を選択した場合にのみ利用可能です。

      移行先インスタンスでのオブジェクト名の大文字化

      ターゲットインスタンス内に移行されるデータベース、テーブル、および列名の大文字・小文字ポリシーを構成します。DTS のデフォルトポリシーがデフォルトで選択されます。ソースまたはターゲットデータベースポリシーとの一貫性を維持することもできます。詳細については、「ターゲットインスタンス内のオブジェクト名の大文字・小文字」をご参照ください。

      ソースオブジェクト

      ソースオブジェクト セクションから 1 つ以上のオブジェクトを選択します。Rightwards arrow アイコンをクリックして、オブジェクトを 選択済みオブジェクト セクションに追加します。

      説明

      移行オブジェクトとして選択できるのはテーブルのみです。ビュー、トリガー、ストアドプロシージャなどの他のオブジェクトはターゲットデータベースに移行されません。

      [選択済みオブジェクト]

      説明
      • オブジェクト名マッピング機能を使用する場合、名前が変更されたオブジェクトに依存する他のオブジェクトの移行が失敗する可能性があります。

      • WHERE 句を指定してデータをフィルターするには、選択中のオブジェクト ボックス内のテーブルを右クリックし、表示されるダイアログボックスでフィルター条件を指定します。詳細については、「SQL ステートメントを使用したタスクデータのフィルター」をご参照ください。

      • テーブル単位で移行する SQL 操作を選択するには、選択中のオブジェクト ボックス内のテーブルを右クリックし、表示されるダイアログボックスで目的の SQL 操作を選択します。

    2. 詳細設定へ をクリックして、詳細パラメーターを構成します。

      パラメーター

      説明

      タスクのスケジュールに使用する専用クラスターの選択

      デフォルトでは、DTS は共有クラスター上でタスクをスケジューリングします。選択する必要はありません。より安定したタスクを実行したい場合は、DTS 移行タスクを実行するための専用クラスターを購入できます。

      失敗した接続の再試行時間

      移行タスク開始後、ソースまたはターゲットデータベースへの接続が失敗した場合、DTS はエラーを報告し、直ちに接続の再試行を開始します。デフォルトの再試行時間は 720 分です。10 ~ 1440 分の範囲で再試行時間をカスタマイズできます。30 分以上に設定することを推奨します。指定された時間内に DTS がソースおよびターゲットデータベースに再接続できた場合、移行タスクは自動的に再開されます。それ以外の場合は、タスクが失敗します。

      説明
      • 同じソースまたはターゲットを共有する複数の DTS インスタンスの場合、ネットワークリトライ時間は最後に作成されたタスクの設定によって決まります。

      • 接続再試行期間中もタスクに対して課金されるため、ビジネス要件に基づいて再試行時間をカスタマイズするか、ソースおよびターゲットデータベースインスタンスをリリースした後はできるだけ早く DTS インスタンスをリリースすることを推奨します。

      移行元データベースと移行先データベースで他の問題が発生した場合の、再試行までの待機時間です。

      移行タスク開始後、ソースまたはターゲットデータベースで DDL または DML 実行例外などの接続以外の問題が発生した場合、DTS はエラーを報告し、直ちに操作の再試行を開始します。デフォルトの再試行時間は 10 分です。1 ~ 1440 分の範囲で再試行時間をカスタマイズできます。10 分以上に設定することを推奨します。指定された再試行時間内に関連操作が成功した場合、移行タスクは自動的に再開されます。それ以外の場合は、タスクが失敗します。

      重要

      移行元データベースと移行先データベースで他の問題が発生した場合の、再試行までの待機時間です。 の値は、失敗した接続の再試行時間 の値より小さくする必要があります。

      完全移行率を制限するかどうか

      完全移行中、DTS はソースおよびターゲットデータベースの読み取りおよび書き込みリソースを消費し、データベースの負荷が増加する可能性があります。必要に応じて、完全移行タスクの速度制限を有効化できます。1 秒あたりのソースデータベースのクエリ率 QPS1 秒あたりの完全移行の行数 RPS、および 1 秒あたりの完全移行データ量 (MB) BPS を設定して、ターゲットデータベースの負荷を軽減できます。

      説明
      • この設定項目は、移行タイプ完全データ移行 を選択した場合にのみ利用可能です。

      • 移行インスタンスの実行後も、完全移行速度を調整できます。

      増分移行率を制限するかどうか

      必要に応じて、増分移行タスクの速度制限を設定することもできます。1 秒あたりの増分移行の行数 RPS および 1 秒あたりの増分移行データ量 (MB) BPS を設定して、ターゲットデータベースの負荷を軽減できます。

      説明
      • この設定項目は、移行タイプ増分データ移行 を選択した場合にのみ利用可能です。

      • 移行インスタンスの実行後も、増分移行速度を調整できます。

      順方向および逆方向タスクのハートビートテーブル SQL を削除

      DTS インスタンス実行中に、ハートビート SQL 情報をソースデータベースに書き込むかどうかを選択します。

      • :ハートビート SQL 情報はソースデータベースに書き込まれません。これにより、DTS インスタンスが遅延を報告する可能性があります。

      • ×:ハートビート SQL 情報をソースデータベースに書き込みます。これにより、ソースデータベースの物理バックアップやクローンなどの機能に干渉する可能性があります。

      環境タグ

      インスタンスを識別するために環境タグを選択します。この例では必須ではありません。

      ETL 機能の設定

      抽出・変換・書き出し (ETL) 機能を有効にするかどうかを選択します。詳細については、「ETL とは」をご参照ください。有効値:

      監視アラート

      ビジネス要件に基づいて、アラートを設定し、アラート通知を受信するかどうかを選択します。

      • ×:アラートを設定しません。

      • アラートのしきい値 および アラート通知 を設定してアラートを構成します。移行が失敗した場合や遅延がしきい値を超えた場合、システムがアラート通知を送信します。

    3. 任意:前述の構成が完了したら、次:データベースおよびテーブルのフィールド設定 をクリックして、ターゲット AnalyticDB for PostgreSQL インスタンスに移行されるテーブルのプライマリキー列および分散キーを構成します。

      説明
      • スキーマ移行 の下で 移行タイプ を選択した場合、AnalyticDB for PostgreSQL インスタンスに移行されるテーブルに対して、タイププライマリキー列の追加、および 配布キー などのパラメーターを構成する必要があります。詳細については、「CREATE TABLE」をご参照ください。

      • プライマリキー列の追加 は複数の列で構成される複合プライマリキーになることができ、プライマリキー列の追加 から 1 つ以上の列を選択して 配布キー として使用する必要があります。

  6. タスクを保存して事前チェックを実行します。

    • このインスタンスを API オペレーションで呼び出す際の構成パラメーターを表示するには、次:タスク設定の保存と事前チェック ボタンにポインターを合わせ、表示される吹き出しで OpenAPI パラメーターのプレビュー をクリックします。

    • API パラメーターを表示する必要がない場合、または表示が完了した場合は、ページ下部の 次:タスク設定の保存と事前チェック をクリックします。

    説明
    • 移行タスク開始前に、DTS は事前チェックを実行します。事前チェックに合格した後でのみ、タスクが開始されます。

    • 事前チェックに失敗した場合は、失敗したチェック項目の横にある 詳細を表示 をクリックし、プロンプトに基づいて問題を修正してから、再度事前チェックを実行してください。

    • 事前チェック中に警告が報告された場合:

      • 無視できないチェック項目の場合は、失敗した項目の横にある 詳細を表示 をクリックし、プロンプトに基づいて問題を修正してから、再度事前チェックを実行してください。

      • 無視可能なチェック項目の場合は、アラートの詳細を確認無視OK、および 再度事前チェックを実行 をクリックして、アラート項目をスキップして再度事前チェックを実行できます。警告を無視することを選択した場合、データの不整合などの問題が発生し、ビジネスにリスクをもたらす可能性があります。

  7. インスタンスを購入します。

    1. 成功率 が 100 % になったら、次:インスタンスの購入 をクリックします。

    2. 購入 ページで、データ移行インスタンスのリンク仕様を選択します。詳細は次の表をご参照ください。

      カテゴリ

      パラメーター

      説明

      新しいインスタンスクラス

      リソースグループの設定

      インスタンスが属するリソースグループを選択します。デフォルト値はデフォルトリソースグループです。詳細については、「Resource Management とは」をご参照ください。

      インスタンスクラス

      DTS は、さまざまなパフォーマンスレベルを持つ移行仕様を提供しています。リンク仕様は移行速度に影響します。ビジネスシナリオに基づいて仕様を選択できます。詳細については、「データ移行リンク仕様」をご参照ください。

    3. 構成が完了したら、Data Transmission Service (従量課金) 利用規約 を読み、同意してください。

    4. 購入して起動 をクリックします。表示される OK ダイアログボックスで、OK をクリックします。

      データ移行タスク リストページで、移行タスクの進行状況を確認できます。

      説明
      • 移行タスクに増分移行が含まれていない場合、完全移行完了後に自動的に停止します。タスクが停止すると、ステータス完了 に変更されます。

      • 移行タスクに増分移行が含まれている場合、自動的に停止しません。増分移行タスクは継続して実行されます。増分移行タスク実行中、タスクの ステータス実行中 です。