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