すべてのプロダクト
Search

このプロダクト

    Data Transmission Service:PolarDB-X 2.0 から DataHub への移行

    ドキュメントセンター

    Data Transmission Service:PolarDB-X 2.0 から DataHub への移行

    最終更新日:Jul 18, 2026

    Data Transmission Service (DTS) を使用して、PolarDB-X 2.0 インスタンスから DataHub プロジェクトへデータを移行できます。

    前提条件

    制限事項

    種別

    説明

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

    • ソースデータベースをホストするサーバーは、十分なアウトバウンド帯域幅を確保する必要があります。帯域幅が不足すると、データ移行が遅延します。

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

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

    • テーブルレベルでオブジェクトを移行し、列名のマッピングなど編集を行う場合、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 インスタンスのブロードキャストテーブルのタイプを変更する（たとえば、ブロードキャストテーブルを通常のテーブルまたはシャードテーブルに変更する）ことはサポートされていません。テーブルタイプを変更するには、まず移行タスクを停止し、変更完了後に移行タスクを再構成してください。

    その他の制限事項

    • テーブルレベルの移行のみがサポートされています。

    • ターゲット DataHub トピックにおける文字列フィールドの最大長は 2 MB です。

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

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

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

      説明

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

    その他の注意事項

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

    課金

    移行タイプ

    リンク構成料金

    インターネットトラフィック料金

    スキーマ移行

    無料です。

    本例では無料です。

    増分データ移行

    有料機能です。詳細については、「課金概要」をご参照ください。

    移行タイプ

    • スキーマ移行

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

    • 増分移行

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

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

    操作タイプ

    SQL ステートメント

    DML

    INSERT、UPDATE、DELETE

    DDL

    ADD COLUMN

    重要

    ターゲットデータベースのテーブル構造を手動で変更した場合は、タスクを再起動してください：一時停止 してから 開始 します。

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

    データベース

    スキーマ移行

    増分移行

    PolarDB-X 2.0 インスタンス

    SELECT 権限

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

    説明

    権限の付与方法については、「データ同期のためのアカウント権限」をご参照ください。

    データ型マッピング

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

    操作手順

    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 データベースインスタンスの選択 です。

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

      データベースタイプ

      DataHub を選択します。

      アクセス方法

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

      インスタンスリージョン

      ターゲット DataHub プロジェクトが配置されているリージョンを選択します。

      プロジェクト

      ターゲット DataHub プロジェクトの ID を選択します。

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

      説明

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

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

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

        パラメーター

        説明

        移行タイプ

        PolarDB-X 2.0 から DataHub へのデータ移行では、スキーマ移行 および 増分データ移行 のみがサポートされています。ビジネス要件に基づいて移行タイプを選択してください。

        説明

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

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

        追加列の命名規則

        DTS が DataHub にデータを移行する際、ターゲットテーブルに追加カラムが追加されます。これらの新しいカラム名が既存のカラム名と競合する場合、データ移行が失敗します。ビジネス要件に基づいて、新規ルール または 前のルール のいずれかを選択する必要があります。

        警告

        追加カラムのルールを選択する前に、追加カラムの名前がターゲットテーブルの既存カラムと競合しないかどうかを確認する必要があります。追加カラムのルールおよび定義の詳細については、「追加カラムの名前と定義」をご参照ください。

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

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

          説明

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

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

          警告

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

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

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

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

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

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

        宛先インスタンスにおいて、データベース、テーブル、カラムなどの移行対象オブジェクト名について、大文字・小文字の区別ポリシーを設定できます。デフォルトでは、DTS のデフォルトポリシー が選択されています。また、ソースまたはターゲットデータベースのデフォルトポリシーに合わせて大文字・小文字の区別を維持することも可能です。詳細については、「宛先データベースにおけるオブジェクト名の大文字・小文字の区別」をご参照ください。

        ソースオブジェクト

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

        説明

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

        選択中のオブジェクト
        説明

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

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

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

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

        パラメーター

        説明

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

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

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

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

        説明

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

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

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

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

        重要

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

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

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

        説明

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

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

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

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

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

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

        環境タグ

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

        ETL 機能の設定

        ビジネス要件に基づいて、データを処理するためにETL 機能を構成するかどうかを選択します。

        • ○：ETL 機能を構成します。また、テキストボックスにデータ処理ステートメントを入力する必要があります。

        • ×：ETL 機能を構成しません。

        監視アラート

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

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

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

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

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

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

      説明

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

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

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

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

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

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

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

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

        カテゴリ

        パラメーター

        説明

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

        リソースグループの設定

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

        インスタンスクラス

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

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

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

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

        説明

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

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