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

Data Transmission Service:ApsaraDB RDS for MySQL インスタンスから ApsaraDB for ClickHouse クラスターへのデータ移行

最終更新日:Nov 09, 2025

Data Transmission Service (DTS) を使用して、自己管理 MySQL データベースや ApsaraDB RDS for MySQL インスタンスなどの MySQL データベースから ApsaraDB for ClickHouse クラスターにデータを移行できます。これにより、データを簡単に転送して一元的に分析できます。このトピックでは、ApsaraDB RDS for MySQL インスタンスを例として、ApsaraDB RDS for MySQL から ApsaraDB for ClickHouse クラスターへのデータ移行を構成する方法を説明します。

前提条件

バージョン 20.8 以降を実行する宛先 ApsaraDB for ClickHouse クラスターが作成されていること。詳細については、「クラスターの作成」をご参照ください。

説明

宛先 ApsaraDB for ClickHouse クラスターのストレージ容量は、ソース ApsaraDB RDS for MySQL インスタンスで使用されるストレージ容量よりも大きい必要があります。

使用上の注意

タイプ

説明

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

  • オブジェクト名マッピング機能の使用など、テーブルレベルでオブジェクトを移行し、編集する必要がある場合、単一のデータ移行タスクは最大 1,000 個のテーブルをサポートします。この制限を超えると、タスクの送信後にリクエストエラーが報告されます。この場合、移行するテーブルを複数のタスクに分割するか、データベース全体を移行するタスクを構成します。

  • 増分移行を実行する場合、バイナリログは:

    • `binlog_format` を `ROW` に、`binlog_row_image` を `FULL` に設定する必要があります。そうしないと、事前チェック中にエラーが報告され、データ移行タスクを開始できません。

      重要

      ソースの自己管理 MySQL データベースが、各インスタンスが他方のプライマリであるデュアルプライマリクラスターである場合、`log_slave_updates` パラメーターを有効にする必要があります。これにより、DTS がすべてのバイナリログを取得できるようになります。

    • RDS for MySQL インスタンスのローカルバイナリログは、少なくとも 3 日間 (7 日間を推奨) 保持する必要があります。自己管理 MySQL データベースのローカルバイナリログは、少なくとも 7 日間保持する必要があります。そうしないと、バイナリログを取得できないため、DTS タスクが失敗する可能性があります。極端な場合、これによりデータの不整合やデータ損失が発生する可能性があります。DTS の要件よりも短いバイナリログ保持期間を設定することによって引き起こされる問題は、DTS の SLA (サービスレベルアグリーメント) の対象外です。

      説明

      RDS for MySQL インスタンスのローカルバイナリログの [保持期間] の設定方法については、「ローカルログの自動削除」をご参照ください。

  • 増分データを移行するには、RDS for MySQL 5.6 の読み取り専用インスタンスなど、トランザクションログを記録しない RDS for MySQL インスタンスをソースとして使用することはできません。

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

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

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

  • 移行中、物理バックアップの復元やカスケード操作によるデータなど、バイナリログに記録されない操作によって生成されたデータは、ターゲットデータベースに移行されません。

    説明

    これが発生した場合、ビジネスが許すときに完全なデータを再度移行できます。

  • ソースデータベースが MySQL 8.0.23 以降で、移行するデータに非表示列が含まれている場合、これらの列のデータは取得できないため、データ損失が発生する可能性があります。

    説明
    • ALTER TABLE <table_name> ALTER COLUMN <column_name> SET VISIBLE; コマンドを実行して、非表示列を表示させることができます。詳細については、「非表示列」をご参照ください。

    • プライマリキーのないテーブルは、自動的に非表示のプライマリキーを生成します。この非表示のプライマリキーも表示させる必要があります。詳細については、「生成された非表示のプライマリキー」をご参照ください。

その他の制限

  • ソース ApsaraDB RDS for MySQL インスタンスの DDL 文が標準の MySQL 構文に従っていない場合、移行タスクが失敗したり、データが失われたりする可能性があります。

  • INDEX、PARTITION、VIEW、PROCEDURE、FUNCTION、TRIGGER、および FK の移行はサポートされていません。

  • RENAME TABLE 操作は移行できません。

  • 複数のテーブルのマージなど、一時テーブルを使用するオンライン DDL 操作がソースデータベースで実行されると、ターゲットデータベースでデータ損失が発生したり、移行インスタンスが失敗したりする可能性があります。

  • DMS または gh-ost ツールを使用してソースでオンライン DDL 変更を実行すると、DTS は元の DDL 文のみを宛先に移行します。このシナリオでは、DTS は大量の一時テーブルデータを移行する必要はありませんが、宛先でテーブルがロックされる可能性があります。

    説明

    ソースで pt-online-schema-change などのツールを使用して実行されたオンライン DDL 変更の移行はサポートされていません。ソースにそのような変更が存在する場合、宛先でデータ損失が発生したり、移行インスタンスが失敗したりする可能性があります。

  • ApsaraDB for ClickHouse の時間型データには範囲制限があります。ApsaraDB RDS for MySQL の時間データがこの範囲外の場合、ApsaraDB for ClickHouse に移行される時間は正しくありません。範囲制限については、「時間情報」をご参照ください。

  • パーティションキー には null 許容フィールドを選択できません。選択すると、移行タスクは失敗します。

    説明

    パーティションキーは、BIGINT、INT、TIMESTAMP、DATETIME、および DATE 型のフィールドのみをサポートします。

  • 移行するデータベースの数は、ApsaraDB for ClickHouse の制限である 256 を超えてはなりません。

  • 移行するデータベース、テーブル、および列の名前は、ApsaraDB for ClickHouse の命名規則に準拠する必要があります。詳細については、「オブジェクトの命名規則」をご参照ください。

  • スキーマ移行中、DTS は _sign_is_deleted、および _version フィールドを宛先テーブルに追加します。移行タイプ を構成するときに スキーマ移行 を選択しない場合は、宛先でデータを受信するためのテーブルを手動で作成し、これらの追加フィールドを追加する必要があります。テーブル作成の要件とフィールドの詳細については、「テーブルとフィールドの情報」をご参照ください。

  • データを移行する前に、ソースデータベースとターゲットデータベースのパフォーマンスを評価してください。オフピーク時にデータ移行を実行することをお勧めします。そうしないと、初期完全同期がソースデータベースとターゲットデータベースの読み取りおよび書き込みリソースを消費し、データベースの負荷が増加する可能性があります。

  • データベース全体ではなく 1 つ以上のテーブルを移行する場合、pt-online-schema-change などのツールを使用してソースデータベースの移行オブジェクトに対してオンライン DDL 操作を実行しないでください。実行すると、移行は失敗します。

    Data Management (DMS) を使用してオンライン DDL 操作を実行できます。詳細については、「ロックフリーのスキーマ変更を実行する」をご参照ください。

  • DTS 移行中、DTS 以外のソースからのデータがターゲットデータベースに書き込まれないようにしてください。そうしないと、ソースデータベースとターゲットデータベースの間でデータ不整合が発生します。

  • RDS for MySQL インスタンスで常時機密機能が有効になっている場合、完全なデータ移行はサポートされません。

    説明

    TDE (透過的データ暗号化) が有効になっている RDS for MySQL インスタンスは、スキーマ移行、完全なデータ移行、および増分データ移行をサポートします。

  • インスタンスが失敗した場合、DTS ヘルプデスクは 8 時間以内にインスタンスを回復しようとします。回復プロセス中に、インスタンスの再起動やパラメーターの調整などの操作が実行される場合があります。

    説明

    パラメーターが調整されるとき、DTS インスタンスのパラメーターのみが変更されます。データベースのパラメーターは変更されません。変更される可能性のあるパラメーターには、「インスタンスパラメーターの変更」で説明されているものが含まれますが、これらに限定されません。

特殊なケース

  • ソースが自己管理 MySQL データベースの場合:

    • 移行中のソースデータベースでのプライマリ/セカンダリフェールオーバーにより、移行タスクが失敗します。

    • DTS の遅延は、最後に移行されたデータレコードの UNIX タイムスタンプと現在の UNIX タイムスタンプを比較することによって計算されます。ソースデータベースで DML 操作が長時間実行されない場合、遅延情報が不正確になることがあります。表示される遅延が長すぎる場合は、ソースデータベースで DML 操作を実行して遅延情報を更新できます。

      説明

      データベース全体を移行する場合は、毎秒更新または書き込みされるハートビートテーブルを作成することもできます。

    • DTS は、ソースデータベースで定期的に CREATE DATABASE IF NOT EXISTS `test` コマンドを実行して、バイナリログオフセットを進めます。

    • ソースデータベースが Amazon Aurora MySQL インスタンスまたは別のクラスター化された MySQL インスタンスである場合、タスク用に構成されたドメイン名または IP アドレスとその解決結果が常に読み取り/書き込み (RW) ノードを指していることを確認してください。そうしないと、移行タスクが期待どおりに実行されない可能性があります。

  • ソースが RDS for MySQL インスタンスの場合:

    • 増分データを移行するには、RDS for MySQL 5.6 の読み取り専用インスタンスなど、トランザクションログを記録しない RDS for MySQL インスタンスをソースとして使用することはできません。

    • DTS は、ソースデータベースで定期的に CREATE DATABASE IF NOT EXISTS `test` コマンドを実行して、バイナリログオフセットを進めます。

課金

移行タイプ

リンクの構成料金

データ転送コスト

スキーマ移行と完全なデータ移行

無料です。

この例では、このコストは発生しません。

増分データ移行

課金されます。詳細については、「課金の概要」をご参照ください。

増分移行をサポートする SQL 操作

操作タイプ

SQL 操作

DML

INSERT、UPDATE、DELETE

DDL

  • CREATE TABLE、DROP TABLE、TRUNCATE TABLE

  • ADD COLUMN、MODIFY COLUMN、DROP COLUMN

データ型のマッピング

MySQL と ClickHouse でサポートされているデータ型は、1 対 1 のマッピングではありません。したがって、初期スキーマ同期中に、DTS はソースデータベースのデータ型をターゲットデータベースの互換性のあるデータ型にマッピングします。詳細については、「異種データベース間のデータ型マッピング」をご参照ください。

データベースアカウントに必要な権限

データベース

必要な権限

権限の作成と付与の方法

ソース ApsaraDB RDS for MySQL

移行するオブジェクトに対する読み取り権限。

アカウントの作成 および アカウント権限の変更

宛先 ApsaraDB for ClickHouse クラスター

  • バージョン 22.8 以降では、ターゲットデータベースに対する読み取りおよび書き込み権限が必要です。特権アカウントはこれらの要件を満たします。

  • バージョン 21.8: [読み取り、書き込み、権限の設定] および [DDL を許可]

Community-compatible Edition クラスターのアカウントを管理する

説明

ApsaraDB RDS for MySQL コンソールを使用してソースデータベースアカウントを作成し、権限を付与しない場合は、アカウントに REPLICATION CLIENT、REPLICATION SLAVE、SHOW VIEW、および SELECT 権限があることを確認してください。

手順

  1. 次のいずれかの方法でデータ移行ページに移動し、データ移行インスタンスが存在するリージョンを選択します。

    DTS コンソール

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

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

    3. ページの左上隅で、データ移行インスタンスが存在するリージョンを選択します。

    DMS コンソール

    説明

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

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

    2. 上部のナビゲーションバーで、ポインターを [データ + AI] > [DTS (DTS)] > [データ移行] に移動します。

    3. [データ移行タスク] の右側にあるドロップダウンリストから、データ同期インスタンスが存在するリージョンを選択します。

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

  3. ソースデータベースとターゲットデータベースを構成します。次の表にパラメーターを示します。

    カテゴリ

    構成

    説明

    なし

    タスク名

    DTS タスクの名前。DTS は自動的にタスク名を生成します。タスクを簡単に識別できるわかりやすい名前を指定することをお勧めします。一意のタスク名を指定する必要はありません。

    移行元データベース

    既存の接続情報の選択

    • DTS に登録されているデータベースインスタンスを使用する場合は、ドロップダウンリストからインスタンスを選択します。DTS は、インスタンスの次のデータベースパラメーターを自動的に入力します。詳細については、「データベース接続の管理」をご参照ください。

      説明

      DMS コンソールでは、[DMS データベースインスタンスの選択] ドロップダウンリストからデータベースインスタンスを選択できます。

    • インスタンスを DTS に登録できない場合、または DTS に登録されているインスタンスを使用する必要がない場合は、次のデータベース情報を構成する必要があります。

    データベースタイプ

    MySQL を選択します。

    アクセス方法

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

    インスタンスのリージョン

    ソース ApsaraDB RDS for MySQL インスタンスが存在するリージョンを選択します。

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

    この例では、同じ Alibaba Cloud アカウント内での移行について説明します。× を選択します。

    RDS インスタンス ID

    ソース ApsaraDB RDS for MySQL インスタンスの ID を選択します。

    データベースアカウント

    ソース ApsaraDB RDS for MySQL インスタンスのデータベースアカウントを入力します。必要な権限については、「データベースアカウントに必要な権限」をご参照ください。

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

    データベースへのアクセスに使用されるパスワード。

    暗号化

    データベースへの接続を暗号化するかどうかを指定します。ビジネス要件に基づいて [非暗号化] または [SSL 暗号化] を選択できます。このパラメーターを [SSL 暗号化] に設定する場合は、DTS タスクを構成する前に ApsaraDB RDS for MySQL インスタンスの SSL 暗号化を有効にする必要があります。詳細については、「クラウド証明書を使用して SSL 暗号化を有効にする」をご参照ください。

    移行先データベース

    既存の接続情報の選択

    • DTS に登録されているデータベースインスタンスを使用する場合は、ドロップダウンリストからインスタンスを選択します。DTS は、インスタンスの次のデータベースパラメーターを自動的に入力します。詳細については、「データベース接続の管理」をご参照ください。

      説明

      DMS コンソールでは、[DMS データベースインスタンスの選択] ドロップダウンリストからデータベースインスタンスを選択できます。

    • インスタンスを DTS に登録できない場合、または DTS に登録されているインスタンスを使用する必要がない場合は、次のデータベース情報を構成する必要があります。

    データベースタイプ

    ClickHouse を選択します。

    アクセス方法

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

    インスタンスのリージョン

    宛先 ApsaraDB for ClickHouse クラスターが存在するリージョンを選択します。

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

    この例では、同じ Alibaba Cloud アカウント内での移行について説明します。× を選択します。

    クラスタータイプ

    必要に応じて ApsaraDB for ClickHouse クラスターのタイプを選択します。

    クラスター ID

    宛先 ApsaraDB for ClickHouse クラスターの ID を選択します。

    データベースアカウント

    宛先 ApsaraDB for ClickHouse クラスターのデータベースアカウントを入力します。必要な権限については、「データベースアカウントに必要な権限」をご参照ください。

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

    データベースへのアクセスに使用されるパスワード。

  4. ページの下部で、[接続をテストして続行] をクリックします。

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

    • ソースまたはターゲットデータベースが自己管理データベースで、その アクセス方法Alibaba Cloud インスタンス に設定されていない場合は、DTS サーバーの CIDR ブロック ダイアログボックスの 接続テスト をクリックします。

  5. 移行するオブジェクトを構成します。

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

      構成

      説明

      移行タイプ

      • 完全なデータ移行のみを実行するには、[スキーマ移行][完全なデータ移行] を選択します。

      • データ移行中のサービス継続性を確保するには、[スキーマ移行][完全なデータ移行]、および [増分データ移行] を選択します。

      説明
      • [スキーマ移行] を選択しない場合は、ターゲットデータベースにデータを受信するためのデータベースとテーブルが作成され、[選択したオブジェクト] でオブジェクト名マッピング機能が有効になっていることを確認してください。

      • [増分データ移行] を選択しない場合は、データ移行中にソースデータベースにデータを書き込まないことをお勧めします。これにより、ソースデータベースとターゲットデータベース間のデータ整合性が確保されます。

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

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

        説明

        ソースデータベースとターゲットデータベースに同じ名前のテーブルが含まれており、ターゲットデータベースのテーブルを削除または名前変更できない場合は、オブジェクト名マッピング機能を使用して、ターゲットデータベースに移行されるテーブルの名前を変更できます。詳細については、「オブジェクト名のマッピング」をご参照ください。

      • エラーを無視して続行: ソースデータベースとターゲットデータベースの同じテーブル名の事前チェックをスキップします。

        警告

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

        • ソースデータベースとターゲットデータベースのスキーマが同じで、データレコードのプライマリキーがターゲットデータベースの既存のデータレコードと同じである場合、次のシナリオが発生する可能性があります。

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

          • 増分データ移行中、DTS はデータレコードをターゲットデータベースに移行します。ターゲットデータベースの既存のデータレコードは上書きされます。

        • ソースデータベースとターゲットデータベースのスキーマが異なる場合、特定の列のみが移行されるか、データ移行タスクが失敗します。注意して進めてください。

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

      宛先インスタンスのデータベース名、テーブル名、および列名の大文字と小文字の区別。デフォルトでは、[DTS のデフォルトポリシー] が選択されています。他のオプションを選択して、オブジェクト名の大文字と小文字の区別がソースまたはターゲットデータベースのものと一致するようにすることができます。詳細については、「宛先インスタンスでのオブジェクト名の大文字と小文字の区別を指定する」をご参照ください。

      ソースオブジェクト

      ソースオブジェクト セクションから 1 つ以上のオブジェクトを選択します。向右小箭头 アイコンをクリックして、オブジェクトを 選択中のオブジェクト セクションに追加します。

      説明

      データベースまたはテーブルレベルでオブジェクトを選択できます。

      選択中のオブジェクト

      • 宛先インスタンスに移行するオブジェクトの名前を変更するには、[選択したオブジェクト] セクションでオブジェクトを右クリックします。詳細については、「単一オブジェクトの名前をマッピングする」をご参照ください。

      • 一度に複数のオブジェクトの名前を変更するには、[選択したオブジェクト] セクションの右上隅にある [一括編集] をクリックします。詳細については、「一度に複数のオブジェクト名をマッピングする」をご参照ください。

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

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

    2. 次へ:詳細設定 をクリックして詳細設定を構成します。

      構成

      説明

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

      デフォルトでは、専用クラスターを指定しない場合、DTS はデータ移行タスクを共有クラスターにスケジュールします。データ移行タスクの安定性を向上させたい場合は、専用クラスターを購入してください。詳細については、「DTS 専用クラスターとは」をご参照ください。

      ターゲットデータベースのタイムゾーン

      ApsaraDB for ClickHouse クラスターに書き込まれる DateTime データのタイムゾーンを選択できます。

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

      失敗した接続のリトライ時間範囲。データ移行タスクが開始された後、ソースまたはターゲットデータベースへの接続に失敗した場合、DTS はリトライ時間範囲内で直ちに接続をリトライします。有効値: 10 ~ 1,440。単位: 分。デフォルト値: 720。パラメーターを 30 より大きい値に設定することをお勧めします。指定されたリトライ時間範囲内に DTS がソースおよびターゲットデータベースに再接続されると、DTS はデータ移行タスクを再開します。それ以外の場合、データ移行タスクは失敗します。

      説明
      • 同じソースまたはターゲットデータベースを共有する複数のデータ移行タスクに異なるリトライ時間範囲を指定した場合、後で指定された値が優先されます。

      • DTS が接続をリトライすると、DTS インスタンスに対して課金されます。ビジネス要件に基づいてリトライ時間範囲を指定することをお勧めします。ソースデータベースと宛先インスタンスがリリースされた後、できるだけ早く DTS インスタンスをリリースすることもできます。

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

      その他の問題のリトライ時間範囲。たとえば、データ移行タスクが開始された後に DDL または DML 操作の実行に失敗した場合、DTS はリトライ時間範囲内で直ちに操作をリトライします。有効値: 1 ~ 1440。単位: 分。デフォルト値: 10。パラメーターを 10 より大きい値に設定することをお勧めします。指定されたリトライ時間範囲内に失敗した操作が正常に実行されると、DTS はデータ移行タスクを再開します。それ以外の場合、データ移行タスクは失敗します。

      重要

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

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

      完全なデータ移行のスロットリングを有効にするかどうかを指定します。完全なデータ移行中、DTS はソースデータベースとターゲットデータベースの読み取りおよび書き込みリソースを使用します。これにより、データベースサーバーの負荷が増加する可能性があります。ビジネス要件に基づいて、完全なデータ移行のスロットリングを有効にすることができます。スロットリングを構成するには、1 秒あたりのソースデータベースのクエリ率 QPS1 秒あたりの完全移行の行数 RPS、および 1 秒あたりの完全移行データ量 (MB) BPS パラメーターを構成する必要があります。これにより、ターゲットデータベースサーバーの負荷が軽減されます。

      説明

      このパラメーターは、移行タイプ パラメーターに 完全データ移行 を選択した場合にのみ構成できます。

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

      増分データ移行のスロットリングを有効にするかどうかを指定します。スロットリングを構成するには、1 秒あたりの増分移行の行数 RPS および 1 秒あたりの増分移行データ量 (MB) BPS パラメーターを構成する必要があります。これにより、ターゲットデータベースサーバーの負荷が軽減されます。

      説明

      このパラメーターは、移行タイプ パラメーターに 増分データ移行 を選択した場合にのみ構成できます。

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

      DTS インスタンスの実行中にハートビートテーブルに対する SQL 操作をソースデータベースに書き込むかどうかを指定します。有効な値:

      • [はい]: ハートビートテーブルに対する SQL 操作を書き込みません。この場合、DTS インスタンスの遅延が表示されることがあります。

      • [いいえ]: ハートビートテーブルに対する SQL 操作を書き込みます。この場合、ソースデータベースの物理バックアップやクローン作成などの機能が影響を受ける可能性があります。

      環境タグ

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

      ETL の設定

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

      監視アラート

      データ移行タスクのアラートを構成するかどうかを指定します。タスクが失敗した場合、または移行遅延が指定されたしきい値を超えた場合、アラート連絡先は通知を受け取ります。有効な値:

      • [いいえ]: アラートを構成しません。

      • [はい]: アラートを構成します。この場合、アラートのしきい値と アラート通知設定も構成する必要があります。詳細については、「DTS タスク作成時のモニタリングとアラートの設定」トピックの「DTS タスク作成時のモニタリングとアラートの設定」セクションをご参照ください。

    3. 次:データベースおよびテーブルのフィールド設定 をクリックして、ClickHouse の宛先テーブルの タイププライマリキー列の追加ソートキー配布キー、および パーティションキー を構成します。

      • DTS はデフォルトの構成を提供します。この構成を変更するには、定義ステータスすべて に設定します。

      • プライマリキー列の追加ソートキー は複合キーにすることができます。プライマリキー列の追加 または ソートキー の対応するドロップダウンリストから複数のフィールドを選択できます。パーティションキー として機能させるには、プライマリキー列の追加 から 1 つ以上の列を選択する必要があります。配布キー には 1 つのフィールドしか選択できません。プライマリキー、ソートキー、およびパーティションキーの詳細については、「CREATE TABLE」をご参照ください。

        説明
        • パーティションキー は未構成のままにできますが、null 許容フィールドを選択することはできません。選択すると移行タスクが失敗します。

        • パーティションキーは、BIGINT、INT、TIMESTAMP、DATETIME、および DATE データ型のフィールドのみをサポートします。その計算ロジックの詳細については、「パーティションキーの計算ロジック」をご参照ください。

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

    • 関連する API 操作を呼び出して DTS タスクを構成するときに指定するパラメーターを表示するには、ポインターを 次:タスク設定の保存と事前チェック の上に移動し、OpenAPI パラメーターのプレビュー をクリックします。

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

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

    • タスクが事前チェックに合格しなかった場合は、失敗した各項目の横にある [詳細の表示] をクリックします。チェック結果に基づいて原因を分析した後、問題をトラブルシューティングします。その後、再度事前チェックを実行します。

    • 事前チェック中に項目のアラートがトリガーされた場合:

      • アラート項目を無視できない場合は、失敗した項目の横にある [詳細の表示] をクリックして問題をトラブルシューティングします。その後、再度事前チェックを実行します。

      • アラート項目を無視できる場合は、[アラート詳細の確認] をクリックします。[詳細の表示] ダイアログボックスで、[無視] をクリックします。表示されるメッセージで、[OK] をクリックします。次に、[再度事前チェック] をクリックして再度事前チェックを実行します。アラート項目を無視すると、データ不整合が発生し、ビジネスに潜在的なリスクが伴う可能性があります。

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

    1. [成功率][100%] になるまで待ちます。次に、[次へ: インスタンスの購入] をクリックします。

    2. [インスタンスの購入] ページで、データ移行インスタンスのインスタンスクラスパラメーターを構成します。次の表にパラメーターを示します。

      セクション

      パラメーター

      説明

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

      リソースグループ

      データ移行インスタンスが属するリソースグループ。デフォルト値: [デフォルトのリソースグループ]。詳細については、「Resource Management とは」をご参照ください。

      インスタンスクラス

      DTS は、移行速度が異なるインスタンスクラスを提供します。ビジネスシナリオに基づいてインスタンスクラスを選択できます。詳細については、「データ移行インスタンスのインスタンスクラス」をご参照ください。

    3. チェックボックスをオンにして、[Data Transmission Service (従量課金) 利用規約] を読んで同意します。

    4. [購入して開始] をクリックします。表示されるメッセージで、[OK] をクリックします。

      [データ移行] ページでタスクの進行状況を表示できます。

      説明
      • データ移行タスクを使用して増分データを移行できない場合、タスクは自動的に停止します。[ステータス] セクションに [完了] が表示されます。

      • データ移行タスクを使用して増分データを移行できる場合、タスクは自動的に停止しません。増分データ移行タスクは停止も完了もしません。[ステータス] セクションに [実行中] が表示されます。

付録

時間情報

データの型

最小値

最大値

Date

1970-01-01 00:00:00

2149-06-06 00:00:00

Date32

1925-01-01 00:00:00

2283-11-11 00:00:00

DateTime

1970-01-01 08:00:00

2106-02-07 14:28:15

DateTime64

1925-01-01 08:00:00

2283-11-12 07:59:59

テーブルとフィールドの情報

テーブル情報

オブジェクト名マッピング機能を使用しない場合、作成するテーブルは次の要件を満たす必要があります。

重要

宛先テーブルに ENGINE が含まれている場合、それは ENGINE = ReplicatedReplacingMergeTree(_version, _is_deleted) である必要があります。そうでない場合、データ不整合が発生する可能性があります。

  • ClickHouse Community Edition インスタンス: 1 つのローカルテーブルと 1 つの分散テーブルを作成する必要があります。分散テーブルの名前はソーステーブル名と同じでなければなりません。ローカルテーブルの名前は <distributed_table_name>_local でなければなりません。

  • ClickHouse Enterprise Edition インスタンス: ソーステーブルと同じ名前のテーブルを作成する必要があります。

フィールド情報

説明

ClickHouse インスタンスでは、select * from table_name final where _sign>0; 文を実行してデータをクエリできます。where 条件は削除されたデータをフィルタリングし、テーブル名の後の final キーワードは同じソートキーを持つデータをフィルタリングします。

バージョン

名前

データの型

デフォルト値

説明

Community Edition 23.8 より前

_sign

Int8

1

DML 操作のタイプ。

  • INSERT: レコードは 1 です。

  • UPDATE: レコードは 1 です。

  • DELETE: レコードは -1 です。

_version

UInt64

1

データが ClickHouse に書き込まれたときのタイムスタンプ。

Enterprise Edition および Community Edition 23.8 以降

_sign

Int8

1

DML 操作のタイプ。

  • INSERT: レコードは 1 です。

  • UPDATE: レコードは 1 です。

  • DELETE: レコードは -1 です。

_is_deleted

UInt8

0

レコードが削除されたかどうかを示します:

  • 挿入: レコードは 0 です。

  • 削除: レコードは 1 です。

  • 更新: レコードは 0 です。

_version

UInt64

1

データが ClickHouse に書き込まれたときのタイムスタンプ。

パーティションキーの計算ロジック

ソースフィールドタイプ

パーティションキーの計算ロジック

BIGINT

intDiv(" + tablePartKey + ", 18014398509481984)

INT

intDiv(" + tablePartKey + ", 4194304)

TIMESTAMP

toYYYYMM(" + tablePartKey + ")

DATETIME

DATE