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

:MySQL データベース全体を DataHub にリアルタイムで同期する

最終更新日:Nov 09, 2025

Data Integration は、MySQL、Oracle、PolarDB、およびその他のソースから DataHub へのデータベース全体のリアルタイム同期をサポートしています。このトピックでは、MySQL データベース全体から DataHub に、フルモードと増分モードの両方でデータを同期する方法について説明します。

前提条件

手順

ステップ 1: 同期タスクのタイプを選択する

  1. Data Integration ページに移動します。

    DataWorks コンソールにログインします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションウィンドウで、[Data Integration] > [Data Integration] を選択します。表示されたページで、ドロップダウンリストから目的のワークスペースを選択し、[Data Integration に移動] をクリックします。

  2. 左側のナビゲーションウィンドウで [Sync Tasks] をクリックし、ページの上部にある [Create Sync Task] をクリックして同期タスク作成ページに移動します。次の基本情報を設定します:

    • データソースと宛先: MySQLDataHub

    • 新しいタスク名: 同期タスクの名前をカスタマイズします。

    • 同期タイプ: データベース全体のリアルタイム

    • 同期ステップ: [フル同期][増分同期] を選択します。

ステップ 2: ネットワークとリソースを設定する

  1. [ネットワークとリソースの設定] セクションで、同期タスクの [リソースグループ] を選択します。[タスクリソースの使用量] に CU 数を割り当てることができます。

  2. [ソースデータソース] で、追加した MySQL データソースを選択します。[宛先データソース] で、追加した DataHub データソースを選択し、[接続性のテスト] をクリックします。

    image

  3. ソースと宛先の両方のデータソースが正常に接続されたことを確認したら、[次へ] をクリックします。

3. データを同期するテーブルを選択する

このステップでは、[ソーステーブル] リストでデータを同期するテーブルを選択し、image アイコンをクリックして選択したテーブルを [選択したテーブル] リストに移動できます。

image

ステップ 4: 宛先テーブルをマッピングする

データを同期するテーブルを選択すると、選択したテーブルが [宛先テーブルのマッピングルール] セクションに自動的に表示されます。宛先テーブルのプロパティはマッピングされるのを待っています。ソーステーブルと宛先テーブル間のマッピングを手動で定義して、データの読み取りと書き込みの関係を決定する必要があります。その後、[アクション] 列の [リフレッシュ] をクリックできます。ソーステーブルと宛先テーブル間のマッピングを直接リフレッシュできます。また、宛先テーブルに関連する設定を行った後で、ソーステーブルと宛先テーブル間のマッピングをリフレッシュすることもできます。

説明
  • 同期するテーブルを選択し、[マッピングの一括リフレッシュ] をクリックできます。マッピングルールが設定されていない場合、デフォルトの Topic 名のルールは ${source_database_name}_${source_table_name} です。宛先に同じ名前の Topic が存在しない場合、新しい Topic が自動的に作成されます。

  • [宛先 Topic 名のカスタムマッピング] 列で、[編集] ボタンをクリックして、宛先テーブル名のルールをカスタマイズできます。

    組み込み変数と手動で入力した文字列を使用して、最終的な宛先 Topic 名を作成できます。組み込み変数は編集できます。たとえば、新しいテーブル名ルールを作成して、ソーステーブル名にサフィックスを追加して宛先 Topic 名とすることができます。

a. フィールドのデータ型マッピングを変更する

ソースフィールドのデータ型と宛先フィールドのデータ型の間には、デフォルトのマッピングが存在します。[宛先テーブルのマッピングルール] セクションの右上隅にある [フィールドデータ型のマッピングを編集] をクリックして、ビジネス要件に基づいてソースフィールドと宛先フィールド間のデータ型マッピングを設定できます。設定が完了したら、[適用してマッピングをリフレッシュ] をクリックします。

b. 宛先テーブルのスキーマを変更してテーブルにフィールドを追加し、フィールドに値を割り当てる

宛先テーブルが [作成予定] 状態の場合、次の手順を実行してテーブルにフィールドを追加し、フィールドに値を割り当てることができます:

  1. 1 つ以上の宛先テーブルにフィールドを追加します。

    • 単一の宛先テーブルにフィールドを追加する: フィールドを追加する宛先テーブルを見つけ、[宛先テーブル名] 列の image.png アイコンをクリックします。表示されるダイアログボックスで、フィールドを追加します。

    • 一度に複数の宛先テーブルにフィールドを追加する: 一度にフィールドを追加する宛先テーブルを選択し、ページの下部にある [一括変更] をクリックしてから、[宛先テーブルスキーマ - フィールドの一括変更と追加] をクリックします。

  2. フィールドに値を割り当てます。次のいずれかの操作を実行して、フィールドに値を割り当てることができます:

    • 単一の宛先テーブルに追加されたフィールドに値を割り当てる: 新しく追加されたフィールドに値を割り当てる宛先テーブルを見つけ、[値の割り当て] 列の [設定] をクリックします。[追加フィールド] ダイアログボックスで、フィールドに値を割り当てます。

    • 一度に複数の宛先テーブルに追加されたフィールドに値を割り当てる: 新しく追加されたフィールドに値を割り当てる宛先テーブルを選択し、ページの下部にある [一括変更] をクリックしてから、[値の割り当て] をクリックして、選択した宛先テーブルの同じフィールドに一度に値を割り当てます。

    説明

    image アイコンをクリックして値の割り当て方法を切り替え、宛先テーブルに追加されたフィールドに定数と変数を割り当てることができます。

3. 高度なパラメーターをカスタマイズする

カスタム同期要件を満たすためにタスクの詳細な設定を行う必要がある場合は、[カスタム詳細パラメーター] 列の [設定] ボタンをクリックして高度なパラメーターを変更できます。

重要

高度なパラメーターの設定を変更する前に、予期しないエラーやデータ品質の問題を防ぐために、パラメーターの意味を理解していることを確認してください。

5. アラートルールを設定する

同期タスクの失敗がビジネスデータの同期に遅延を引き起こすのを防ぐために、同期タスクに異なるアラートルールを設定できます。

  1. ページの右上隅にある [アラートルールの設定] をクリックして、[アラートルールの設定] パネルに移動します。

  2. [アラートルールの設定] パネルで、[アラートルールの追加] をクリックします。[アラートルールの追加] ダイアログボックスで、パラメーターを設定してアラートルールを設定します。

    説明

    このステップで設定するアラートルールは、同期タスクによって生成されるリアルタイム同期サブタスクに対して有効になります。同期タスクの設定が完了したら、「リアルタイム同期タスクの管理」をご参照いただき、リアルタイム同期タスクページに移動して、リアルタイム同期サブタスクに設定されたアラートルールを変更できます。

  3. アラートルールを管理します。

    作成されたアラートルールを有効または無効にできます。また、アラートの重大度レベルに基づいて、異なるアラート受信者を指定することもできます。

6. 高度なパラメーターを設定する

ビジネス要件に基づいて、同期タスクに設定された特定のパラメーターの値を変更できます。たとえば、[最大読み取り接続数] パラメーターに適切な値を指定して、現在の同期タスクがソースデータベースに過度の負荷をかけ、データ生成に影響が及ぶのを防ぐことができます。

説明

予期しないエラーやデータ品質の問題を防ぐために、パラメーターの値を変更する前に、パラメーターの意味を理解することをお勧めします。

  1. 設定ページの右上隅にある [高度なパラメーターの設定] をクリックします。

  2. [高度なパラメーターの設定] パネルで、目的のパラメーターの値を変更します。

7. DDL 処理ルールを設定する

ソースで DDL 操作が実行される場合があります。ページの右上隅にある [DDL 機能の設定] をクリックして、ビジネス要件に基づいてソースからの DDL メッセージを処理するルールを設定できます。

説明

詳細については、「DDL メッセージを処理するルールを設定する」をご参照ください。

8. リソースグループの表示と変更

ページの右上隅にある [リソースグループの設定] をクリックして、現在の同期タスクの実行に使用されるリソースグループを表示および変更できます。

9. 同期タスクを実行する

  1. 同期タスクの設定が完了したら、ページの下部にある [完了] をクリックします。

  2. [Data Integration] ページの [ノード] セクションで、作成した同期タスクを見つけ、[アクション] 列の [開始] をクリックします。

  3. [タスク] セクションで同期タスクの [名前または ID] をクリックし、同期タスクの詳細な実行プロセスを表示します。

データ同期ソリューションの O&M 操作を実行する

データ同期ソリューションのステータスを表示する

同期タスクを作成した後、同期タスクページで作成された同期タスクのリストと各タスクの基本情報を表示できます。image

  • [操作] 列で同期タスクの [開始] または [停止] をクリックできます。[その他] メニューでは、同期タスクの [編集][表示]、およびその他の操作を実行できます。

  • 開始されたタスクについては、[実行概要] で基本的な実行ステータスを確認したり、対応する概要エリアをクリックして実行詳細を表示したりできます。image

    データベース全体の MySQL から DataHub へのリアルタイム同期タスクは、次の 3 つのステップで構成されます:

    • スキーマ移行: このタブには、宛先テーブルが新しく作成されたテーブルか既存のテーブルかなどの情報が表示されます。新しく作成されたテーブルの場合、テーブルの作成に使用された DDL 文が表示されます。

    • 完全なデータ初期化: このタブには、バッチ同期に関与するソーステーブルと宛先テーブル、同期の進行状況、同期されたデータレコードの数などの情報が表示されます。

    • リアルタイムデータ同期: このタブには、リアルタイム同期の統計情報 (実行情報、DDL レコード、アラート情報) が表示されます。

同期タスクを再実行する

特別なケースでは、ソースにテーブルを追加またはソースからテーブルを削除した場合、または宛先テーブルのスキーマまたは名前を変更した場合、同期タスクの [アクション] 列で [その他] をクリックし、[再実行] をクリックして変更後にタスクを再実行できます。再実行プロセス中、同期タスクは、新しく追加されたテーブルから宛先へのデータのみ、またはマッピングされたソーステーブルからスキーマまたは名前が変更された宛先テーブルへのデータのみを同期します。

  • タスクの設定を変更せずに同期タスクを再実行する場合は、[アクション] 列で [その他] をクリックし、[再実行] をクリックしてタスクを再実行し、完全同期と増分同期を再度実行します。

  • タスクにテーブルを追加またはタスクからテーブルを削除した後に同期タスクを再実行する場合は、変更後に [完了] をクリックします。この場合、同期タスクの [アクション] 列に [更新の適用] が表示されます。[更新の適用] をクリックして、システムに同期タスクの再実行をトリガーさせます。再実行プロセス中、同期タスクは新しく追加されたテーブルから宛先にデータを同期します。元のテーブルのデータは再度同期されません。