データ統合は、ApsaraDB for OceanBase、MySQL、Oracle、PolarDB などのデータソースから Hologres へのデータベース全体のリアルタイム同期をサポートしています。このトピックでは、MySQL をソース、Hologres を宛先として使用し、MySQL データベース全体から完全データと増分データの両方を Hologres に同期する方法について説明します。
前提条件
サーバーレスリソースグループまたはデータ統合専用リソースグループを購入済みであること。
MySQL および Hologres データソースを作成済みであること。詳細については、「Data Integration でのデータソースの作成」をご参照ください。
リソースグループとデータソース間のネットワーク接続を確立済みであること。詳細については、「ネットワーク接続ソリューション」をご参照ください。
注意事項
MySQL から Hologres にデータを同期する場合、子パーティションテーブルにのみデータを書き込むことができます。
手順
1. 同期タイプの選択
データ統合ページに移動します。
DataWorks コンソールにログインします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションウィンドウで、 を選択します。表示されたページで、ドロップダウンリストから目的のワークスペースを選択し、[データ統合に移動] をクリックします。
左側のナビゲーションウィンドウで [同期タスク] をクリックし、ページの上部にある [同期タスクの作成] をクリックして、同期タスク作成ページに移動します。次の基本情報を設定します。
[ソースと宛先]:
MySQL→Hologres[新しいノード名]: 同期タスクの名前を指定します。
[同期方法]:
データベース全体のリアルタイム移行。[同期モード]: [完全初期化] と [増分同期] を選択します。
2. ネットワークとリソースの設定
[ネットワークとリソースの設定] セクションで、同期タスクの [リソースグループ] を選択します。[タスクリソース使用量] に計算ユニット (CU) の数を割り当てることができます。
[ソース] で、追加した
MySQLデータソースを選択し、[宛先] で、追加したHologresデータソースを選択して、[接続テスト] をクリックします。
ソースと宛先の両方のデータソースが正常に接続されたことを確認したら、[次へ] をクリックします。
3. 同期するデータを含むテーブルの選択
このステップでは、[ソーステーブル] セクションでデータを同期するテーブルを選択し、
アイコンをクリックして右側の [選択したテーブル] セクションに移動できます。
[特定のテーブルを選択]:
ソーステーブルの [データベースフィルター] および [テーブルフィルター] フィールドで、データベース名またはテーブル名の特徴的な情報を入力して、データベースとテーブルをフィルターできます。同期するすべてのデータベースとテーブルを選択し、
アイコンをクリックして [選択したテーブル] セクションに移動します。[選択したテーブル] セクションで、[データベースフィルター] および [テーブルフィルター] フィールドに特徴的な情報を入力して、同期したくないデータベースとテーブルをフィルターできます。同期したくないすべてのデータベースとテーブルを選択し、
アイコンをクリックして [ソーステーブル] セクションに戻します。
[正規表現を使用してテーブルを選択 (実行時に正規表現によるテーブルの追加または削除をサポート)]:
[データベースフィルター] および [テーブルフィルター] フィールドで設定された正規表現を使用してテーブルをフィルターします。[選択の確認] をクリックして、同期するデータを含むデータベースとテーブルを選択します。
説明たとえば、プレフィックスが
aの名前を持つデータベースと、プレフィックスがorderの名前を持つテーブルをフィルターして同期する場合、[データベースフィルター] フィールドにa.*を、[テーブルフィルター] フィールドにorder.*を入力できます。
4. 宛先に関連する設定の構成
同期するデータを含むテーブルを選択すると、選択したテーブルが [宛先テーブルのマッピングルール] セクションに自動的に表示されます。宛先テーブルのプロパティはマッピングを待機しています。ソーステーブルと宛先テーブル間のマッピングを手動で定義して、データの読み取りと書き込みの関係を決定する必要があります。その後、[アクション] 列の [リフレッシュ] をクリックできます。ソーステーブルと宛先テーブル間のマッピングを直接リフレッシュできます。宛先テーブルに関連する設定を構成した後に、ソーステーブルと宛先テーブル間のマッピングをリフレッシュすることもできます。
同期するテーブルを選択し、[マッピング結果の一括リフレッシュ] をクリックできます。マッピングルールが設定されていない場合、デフォルトのテーブル名ルールは
${Table name}です。宛先に同じ名前のテーブルが存在しない場合、システムは自動的にテーブルを作成します。[宛先スキーマ名のマッピングルールのカスタマイズ] 列の [設定] をクリックして、宛先スキーマ名ルールをカスタマイズできます。
組み込み変数と手動で入力した文字列を連結して、最終的な [宛先スキーマ名] を作成できます。組み込み変数を編集できます。たとえば、ソースデータベース名にサフィックスを追加して [宛先スキーマ名] を形成する新しいスキーマ名ルールを作成できます。
[宛先テーブル名のマッピングルールのカスタマイズ] 列の [編集] をクリックして、ビジネス要件に基づいて宛先テーブル名のマッピングルールを設定できます。
組み込み変数と特定の文字列を連結して、宛先テーブル名を作成できます。組み込み変数を編集できます。たとえば、マッピングルールを作成するときに、ソーステーブル名を示す変数にサフィックスを追加して、宛先テーブル名を形成できます。
a. フィールドのデータ型マッピングの変更
ソースフィールドのデータ型と宛先フィールドのデータ型の間には、デフォルトのマッピングが存在します。[宛先テーブルのマッピングルール] セクションの右上隅にある [フィールドデータ型のマッピングを編集] をクリックして、ビジネス要件に基づいてソースフィールドと宛先フィールド間のデータ型マッピングを設定できます。設定が完了したら、[適用してマッピングをリフレッシュ] をクリックします。
b. 宛先テーブルのスキーマを変更してテーブルにフィールドを追加し、フィールドに値を割り当てる
宛先テーブルが [作成予定] 状態の場合、次の手順を実行してテーブルにフィールドを追加し、フィールドに値を割り当てることができます。
1つ以上の宛先テーブルにフィールドを追加します。
単一の宛先テーブルにフィールドを追加：フィールドを追加する宛先テーブルを見つけ、[宛先テーブル名] 列の
アイコンをクリックします。 表示されるダイアログボックスで、フィールドを追加します。一度に複数の宛先テーブルにフィールドを追加する: 一度にフィールドを追加する宛先テーブルを選択し、ページの下部にある [一括変更] をクリックしてから、[宛先テーブルスキーマ - フィールドの一括変更と追加] をクリックします。
フィールドに値を割り当てます。次のいずれかの操作を実行して、フィールドに値を割り当てることができます。
単一の宛先テーブルに追加されたフィールドに値を割り当てる: 新しく追加されたフィールドに値を割り当てる宛先テーブルを見つけ、[値の割り当て] 列の [設定] をクリックします。[追加フィールド] ダイアログボックスで、フィールドに値を割り当てます。
一度に複数の宛先テーブルに追加されたフィールドに値を割り当てる: 新しく追加されたフィールドに値を割り当てる宛先テーブルを選択し、ページの下部にある [一括変更] をクリックしてから、[値の割り当て] をクリックして、選択した宛先テーブルの同じフィールドに一度に値を割り当てます。
説明
アイコンをクリックして値の割り当て方法を切り替え、宛先テーブルに追加されたフィールドに定数と変数を割り当てることができます。
c. DML 処理ルールの設定
データ統合は、デフォルトの DML 処理ルールを提供します。ビジネス要件に基づいて、宛先テーブルの DML 処理ルールを設定することもできます。
単一の宛先テーブルの DML 処理ルールを設定する: DML 処理ルールを設定する宛先テーブルを見つけ、[DML ルールの設定] 列の [設定] をクリックして、テーブルの DML 処理ルールを設定します。
一度に複数の宛先テーブルの DML 処理ルールを設定する: DML 処理ルールを設定する宛先テーブルを選択し、ページの下部にある [一括変更] をクリックしてから、[DML ルールの設定] をクリックします。
4. 詳細パラメーターの設定
ビジネス要件を満たすために詳細な設定を行う場合は、[カスタム詳細パラメーター] 列の [設定] をクリックして詳細パラメーターを変更できます。
詳細パラメーターの設定を変更する前に、パラメーターの意味を理解して、予期しないエラーやデータ品質の問題を防ぐようにしてください。
5. ソース分割列の設定
[ソース分割列] ドロップダウンリストからソーステーブルのフィールドを選択するか、[分割なし] を選択できます。
6. 完全同期を実行するかどうかの指定
同期タイプを選択したときに [同期モード] パラメーターに [完全初期化] を選択した場合、ここで特定のテーブルの完全同期を無効にできます。
5. アラートルールの設定
同期タスクの失敗によるビジネスデータ同期の遅延を防ぐために、同期タスクに異なるアラートルールを設定できます。
ページの右上隅にある [アラートルールの設定] をクリックして、[アラートルールの設定] パネルに移動します。
[アラートルールの設定] パネルで、[アラートルールの追加] をクリックします。[アラートルールの追加] ダイアログボックスで、パラメーターを設定してアラートルールを設定します。
説明このステップで設定するアラートルールは、同期タスクによって生成されるリアルタイム同期サブタスクに対して有効になります。同期タスクの設定が完了したら、リアルタイム同期タスクの管理 を参照して [リアルタイム同期タスク] ページに移動し、リアルタイム同期サブタスクに設定されたアラートルールを変更できます。
アラートルールを管理します。
作成されたアラートルールを有効または無効にできます。また、アラートの重大度レベルに基づいて、異なるアラート受信者を指定することもできます。
6. 詳細パラメーターの設定
ビジネス要件に基づいて、同期タスクに設定された特定のパラメーターの値を変更できます。たとえば、[最大読み取り接続数] パラメーターに適切な値を指定して、現在の同期タスクがソースデータベースに過度の圧力をかけるのを防ぎ、データ生成が影響を受けないようにすることができます。
予期しないエラーやデータ品質の問題を防ぐために、パラメーターの値を変更する前に、パラメーターの意味を理解することをお勧めします。
設定ページの右上隅にある [詳細パラメーターの設定] をクリックします。
[詳細パラメーターの設定] パネルで、目的のパラメーターの値を変更します。
7. DDL 処理ルールの設定
ソースで DDL 操作が実行される場合があります。ページの右上隅にある [DDL 機能の設定] をクリックして、ビジネス要件に基づいてソースからの DDL メッセージを処理するルールを設定できます。
詳細については、「DDL メッセージを処理するルールの設定」をご参照ください。
8. リソースグループの表示と変更
ページの右上隅にある [リソースグループの設定] をクリックして、現在の同期タスクの実行に使用されるリソースグループを表示および変更できます。
9. 同期タスクの実行
同期タスクの設定が完了したら、ページの下部にある [完了] をクリックします。
[データ統合] ページの [ノード] セクションで、作成した同期タスクを見つけ、[アクション] 列の [開始] をクリックします。
[タスク] セクションで同期タスクの [名前または ID] をクリックし、同期タスクの詳細な実行プロセスを表示します。
同期タスクの O&M 操作の実行
同期タスクのステータスの表示
同期タスクを作成した後、[同期タスク] ページで作成された同期タスクのリストと各同期タスクの基本情報を表示できます。
[アクション] 列で同期タスクを [開始] または [停止] できます。また、[その他] ドロップダウンリストから、同期タスクの [編集]、[表示]、およびその他の操作を実行することもできます。
開始されたタスクについては、[実行概要] セクションでタスクの基本ステータスを確認できます。対応する概要エリアをクリックして、実行の詳細を表示することもできます。
MySQL から Hologres へのリアルタイム同期タスクは、3 つのステージで構成されます。
スキーマ移行: このタブには、宛先テーブルが新しく作成されたテーブルか既存のテーブルかなどの情報が表示されます。新しく作成されたテーブルの場合、テーブルの作成に使用される DDL 文が表示されます。
完全データ初期化: このタブには、バッチ同期に関与するソーステーブルと宛先テーブル、同期の進行状況、同期されたデータレコードの数などの情報が表示されます。
リアルタイム同期: このタブには、同期の進行状況、DDL レコード、DML レコード、アラート情報など、リアルタイム同期に関する統計情報が表示されます。
同期タスクの再実行
特別なケースでは、ソースにテーブルを追加または削除したり、宛先テーブルのスキーマまたは名前を変更したりした場合、同期タスクの [アクション] 列で [その他] をクリックし、[再実行] をクリックして変更後にタスクを再実行できます。再実行プロセス中、同期タスクは、新しく追加されたテーブルから宛先へのデータのみ、またはスキーマまたは名前が変更された宛先テーブルにマッピングされたソーステーブルからのデータのみを同期します。
タスクの設定を変更せずに同期タスクを再実行する場合は、[アクション] 列で [その他] をクリックし、[再実行] をクリックしてタスクを再実行し、完全同期と増分同期を再度実行します。
タスクにテーブルを追加または削除した後に同期タスクを再実行する場合は、変更後に [完了] をクリックします。この場合、同期タスクの [アクション] 列に [更新の適用] が表示されます。[更新の適用] をクリックして、システムに同期タスクの再実行をトリガーします。再実行プロセス中、同期タスクは新しく追加されたテーブルから宛先にデータを同期します。元のテーブルのデータは再度同期されません。