Data Transmission Service:PolarDB-X 2.0インスタンスからElasticsearchクラスターへのデータの同期

前提条件

• MySQL 5.7と互換性のあるソースPolarDB-Xインスタンスが作成されました。

• 移行先のElasticsearchクラスターが作成されました。 詳細については、「Elasticsearchクラスターの作成」をご参照ください。

• 移行元インスタンスと移行先クラスターのエンジンバージョンがサポートされています。 詳細については、「データ同期シナリオの概要」をご参照ください。

• 移行先Elasticsearchクラスターの使用可能なストレージ容量が、移行元PolarDB-Xインスタンスのデータの合計サイズよりも大きいこと。

制限事項

課金

サポートしている同期トポロジ

• 一方向の 1 対 1 の同期

• 一方向の 1 対多の同期

• 一方向の多対 1 の同期

DTSでサポートされている同期トポロジの詳細については、「同期トポロジ」をご参照ください。

同期可能なSQL操作

マッピング

PolarDB-XでサポートされているMySQLデータ型は、Elasticsearchでサポートされているデータ型と一致しません。 DTSは、スキーマ同期のデータ型マッピングに基づいて、スキーマ同期中にソースデータベースのデータ型をElasticsearchクラスターのデータ型に変換します。 詳細については、「スキーマ同期のためのデータ型マッピング」をご参照ください。

手順

1. [データ同期タスク] ページに移動します。

   1. データ管理 (DMS) コンソールにログインします。

   2. 上部のナビゲーションバーで、DTSをクリックします。

   3. 左側のナビゲーションウィンドウで、DTS (DTS) > データ同期を選択します。

   説明

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

   • 新しいDTSコンソールのデータ同期タスクページに行くこともできます 。

2. データ同期タスクの右側で、データ同期インスタンスが存在するリージョンを選択します。

   説明

   新しいDTSコンソールを使用する場合は、上部のナビゲーションバーでデータ同期インスタンスが存在するリージョンを選択する必要があります。

3. [タスクの作成] をクリックします。 [データ同期タスクの作成] ページで、ソースデータベースとターゲットデータベースを設定します。 次の表にパラメーターを示します。

   警告

   ソースデータベースとターゲットデータベースを設定した後、ページに表示される制限を読むことを推奨します。 そうしないと、タスクが失敗したり、データの不一致が発生します。

   セクション	パラメーター	説明
   非該当	タスク名	DTSタスクの名前。 タスク名は自動生成されます。 タスクを簡単に識別できるように、わかりやすい名前を指定することをお勧めします。 一意のタスク名を指定する必要はありません。
   ソースデータベース	データベースタイプ	移行元ディスクのタイプを設定します。 [PolarDB-X 2.0] を選択します。
   	アクセス方法	ソースデータベースのアクセス方法。 [Alibaba Cloudインスタンス] を選択します。
   	インスタンスリージョン	ソースPolarDB-Xインスタンスが存在するリージョン。
   	インスタンスID	ソースPolarDB-XインスタンスのID。
   	データベースアカウント	ソースPolarDB-Xインスタンスのデータベースアカウント。 アカウントには、同期するオブジェクトに対するSELECT権限、およびREPLICATION CLIENT権限とREPLICATION SLAVE権限が必要です。 説明 データベースアカウントに権限を付与する方法の詳細については、「PolarDB-Xのデータ同期ツール」をご参照ください。
   	データベースパスワード	データベースインスタンスへのアクセスに使用されるパスワード。
   宛先データベース	データベースタイプ	ターゲットデータベースのタイプ。 [Elasticsearch] を選択します。
   	アクセス方法	ターゲットデータベースのアクセス方法。 [Alibaba Cloudインスタンス] を選択します。
   	インスタンスリージョン	ターゲットElasticsearchクラスターが存在するリージョン。
   	インスタンスID	移行先のElasticsearchクラスターのID。
   	データベースアカウント	移行先Elasticsearchクラスターのデータベースアカウント。 Elasticsearchクラスターのデフォルトのデータベースアカウントは柔軟であり、同期するオブジェクトに対する読み取りおよび書き込み権限が必要です。
   	データベースパスワード	データベースインスタンスへのアクセスに使用されるパスワード。

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

   ソースまたはターゲットデータベースがAlibaba Cloudデータベースインスタンス (ApsaraDB RDS for MySQLインスタンスやApsaraDB for MongoDBインスタンスなど) の場合、DTSは自動的にDTSサーバーのCIDRブロックをインスタンスのホワイトリストに追加します。 ソースデータベースまたはターゲットデータベースがElastic Compute Service (ECS) インスタンスでホストされている自己管理データベースの場合、DTSサーバーのCIDRブロックがECSインスタンスのセキュリティグループルールに自動的に追加されます。ECSインスタンスがデータベースにアクセスできることを確認する必要があります。 データベースが複数のECSインスタンスにデプロイされている場合、DTSサーバーのCIDRブロックを各ECSインスタンスのセキュリティグループルールに手動で追加する必要があります。 ソースデータベースまたはターゲットデータベースが、データセンターにデプロイされているか、サードパーティのクラウドサービスプロバイダーによって提供される自己管理データベースである場合、DTSサーバーのCIDRブロックをデータベースのホワイトリストに手動で追加して、DTSがデータベースにアクセスできるようにする必要があります。 詳細については、「DTSサーバーのCIDRブロックの追加」トピックの「DTSサーバーのCIDRブロック」セクションをご参照ください。

   警告

   DTSサーバーのCIDRブロックがデータベースまたはインスタンスのホワイトリスト、またはECSセキュリティグループルールに自動的または手動で追加されると、セキュリティリスクが発生する可能性があります。 したがって、DTSを使用してデータを同期する前に、潜在的なリスクを理解して認識し、次の対策を含む予防策を講じる必要があります。VPNゲートウェイ、またはSmart Access Gateway。

5. 同期するオブジェクトと詳細設定を設定します。

   パラメーター	説明
   同期タイプ	同期タイプ。 デフォルトでは、増分データ同期が選択されています。 [スキーマ同期] および [完全データ同期] も選択する必要があります。 事前チェックが完了すると、DTSは選択したオブジェクトの履歴データをソースデータベースからターゲットクラスターに同期します。 履歴データは、その後の増分同期の基礎となる。
   競合テーブルの処理モード	エラーの事前チェックと報告: ターゲットデータベースに、ソースデータベースのテーブルと同じ名前のテーブルが含まれているかどうかを確認します。 ソースデータベースとターゲットデータベースに同じテーブル名のテーブルが含まれていない場合は、事前チェックに合格します。 それ以外の場合、事前チェック中にエラーが返され、データ同期タスクを開始できません。 説明 ソースデータベースとターゲットデータベースに同じ名前のテーブルが含まれていて、ターゲットデータベース内のテーブルを削除または名前変更できない場合は、オブジェクト名マッピング機能を使用して、ターゲットデータベースに同期されるテーブルの名前を変更できます。 詳細については、「マップオブジェクト名」をご参照ください。 エラーを無視して続行: ソースデータベースとターゲットデータベースの同じテーブル名の事前チェックをスキップします。 警告 エラーを無視して続行 を選択すると、データの不整合が発生し、ビジネスが潜在的なリスクにさらされる可能性があります。 ソースデータベースとターゲットデータベースが同じスキーマを持ち、ターゲットデータベースのデータレコードがソースデータベースのデータレコードと同じ主キー値または一意キー値を持つ場合: 完全データ同期中、DTSはデータレコードをターゲットデータベースに同期しません。 ターゲットデータベースの既存のデータレコードが保持されます。 増分データ同期中、DTSはデータレコードをターゲットデータベースに同期します。 ターゲットデータベースの既存のデータレコードが上書きされます。 ソースデータベースとターゲットデータベースのスキーマが異なる場合、データの初期化に失敗する可能性があります。 この場合、一部の列のみが同期されるか、データ同期タスクが失敗します。 作業は慎重に行ってください。
   インデックス名	テーブル名 [テーブル名] を選択した場合、ターゲットElasticsearchクラスターに作成されたインデックス名はテーブル名と同じになります。 この例では、orderが使用されます。 DatabaseName_TableName [データベース名_テーブル名] を選択した場合、ターゲットElasticsearchクラスターに作成されたインデックス名は、[データベース名_テーブル名] の形式になります。 この例では、dtstest_orderが使用されます。
   ソースオブジェクト	ソースオブジェクト セクションから1つ以上のオブジェクトを選択し、アイコンをクリックして 選択中のオブジェクト セクションにオブジェクトを追加します。 説明 同期するオブジェクトとして、列、テーブル、またはデータベースを選択できます。 同期するオブジェクトとしてテーブルまたは列を選択した場合、DTSはビュー、トリガー、ストアドプロシージャなどの他のオブジェクトをターゲットデータベースに同期しません。
   [選択済みオブジェクト]	同期先のインスタンスに同期するオブジェクトの名前を変更するには、選択中のオブジェクト セクションでオブジェクトを右クリックします。 詳細については、「オブジェクト名のマップ」トピックの「単一オブジェクトの名前のマップ」セクションをご参照ください。 一度に複数のオブジェクトの名前を変更するには、選択中のオブジェクト セクションの右上隅にある 一括編集 をクリックします。 詳細については、「オブジェクト名のマップ」トピックの「一度に複数のオブジェクト名をマップする」セクションをご参照ください。 説明 特定のデータベースまたはテーブルで実行されるSQL操作を選択するには、次の手順を実行します。[選択されたオブジェクト] セクションで、オブジェクトを右クリックします。 表示されるダイアログボックスで、同期するSQL操作を選択します。 同期できるSQL操作の詳細については、このトピックの「同期できるSQL操作」をご参照ください。 データをフィルタリングするWHERE条件を指定するには、[選択済みオブジェクト] セクションでオブジェクトを右クリックします。 表示されるダイアログボックスで、条件を指定します。 詳細については、「フィルター条件の指定」をご参照ください。 オブジェクト名マッピング機能を使用してオブジェクトの名前を変更すると、そのオブジェクトに依存する他のオブジェクトの同期が失敗する可能性があります。

6. [次へ：詳細設定] をクリックして詳細設定を構成します。

   パラメーター	説明
   Set Alerts	データ同期タスクのアラートを設定するかどうかを指定します。 タスクが失敗するか、同期レイテンシが指定されたしきい値を超えると、アラート送信先は通知を受け取ります。 有効な値： No: アラートを有効にしません。 Yes: アラートを設定します。 この場合、アラートしきい値と アラート通知設定 詳細については、「モニタリングとアラートの設定」トピックの「DTSタスクを作成するときのモニタリングとアラートの設定」をご参照ください。
   失敗した接続のリトライ時間範囲の指定	失敗した接続のリトライ時間範囲。 データ同期タスクの開始後にソースデータベースまたはターゲットデータベースの接続に失敗した場合、DTSはその時間範囲内ですぐに接続を再試行します。 有効な値: 10 ~ 1440 単位は分です。 デフォルト値: 720 このパラメーターを30より大きい値に設定することを推奨します。 DTSが指定された時間範囲内にソースデータベースとターゲットデータベースに再接続すると、DTSはデータ同期タスクを再開します。 それ以外の場合、データ同期タスクは失敗します。 説明 ソースまたはターゲットデータベースが同じである複数のデータ同期タスクに対して異なるリトライ時間範囲を指定した場合、最も短いリトライ時間範囲が優先されます。 DTSが接続を再試行すると、DTSインスタンスに対して課金されます。 業務要件に基づいて再試行時間範囲を指定することを推奨します。 ソースインスタンスとターゲットインスタンスがリリースされた後、できるだけ早くDTSインスタンスをリリースすることもできます。
   シャード設定	ターゲットElasticsearchクラスターのインデックスのシャード構成に基づくプライマリシャードとレプリカシャードの数。
   文字列インデックス	ターゲットElasticsearchクラスターのインデックスに文字列をコンパイルするために使用されるメソッドです。 analyzed: インデックス作成前に文字列が分析されます。 特定のアナライザーを選択する必要があります。 アナライザーの種類の詳細については、「組み込みアナライザーリファレンス」をご参照ください。 not analyze: 文字列は元の値でインデックスされます。 no: 文字列はインデックス付けされません。
   タイムゾーン	DATETIMEやTIMESTAMPなどの日付と時刻のデータ型のタイムゾーン。 移行先Elasticsearchクラスターへのデータ同期中にタイムゾーンを選択できます。 説明 移行先クラスターの日付と時刻のデータ型にタイムゾーンが必要ない場合は、日付と時刻のデータ型にドキュメントタイプを指定する必要があります。
   DOCID	パラメーターのデフォルト値は、Elasticsearchクラスターのテーブルのプライマリキーです。 テーブルにプライマリキーがない場合、パラメーターの値は、Elasticsearchによって自動的に生成されるID列になります。

7. ページの下部で、[次へ]: [データベースフィールドとテーブルフィールドの設定] をクリックします。 表示されるページで、同期先のElasticsearchクラスターに同期するテーブルの_ルーティングポリシーと_id値を設定します。

   カテゴリ	説明
   Set _routing	ターゲットElasticsearchクラスターのシャードにドキュメントを保存するかどうかを指定します。 詳細については、「 _routing」をご参照ください。 有効な値： Yes: ルーティングのカスタム列を指定できます。 No :_id値はルーティングに使用されます。 説明 ターゲットElasticsearchクラスターのバージョンが7. xの場合、[いいえ] を選択する必要があります。
   _idの値	主キー列 複合プライマリキーは 1 つの列にマージされます。 ビジネスキー ビジネスキーを選択する場合は、ビジネスキー列を指定する必要があります。

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

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

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

   説明

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

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

   • 事前チェック中にアイテムに対してアラートがトリガーされた場合:

     • アラートアイテムを無視できない場合は、失敗したアイテムの横にある [詳細の表示] をクリックして、問題のトラブルシューティングを行います。 次に、もう一度プレチェックを実行します。

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

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

10. 購入ページで、データ同期インスタンスの課金方法とインスタンスクラスのパラメーターを設定します。 下表にパラメーターを示します。

    セクション	パラメーター	説明
    新しいインスタンスクラス	Billing Method	サブスクリプション: データ同期インスタンスの作成時にサブスクリプションの料金を支払います。 サブスクリプションの課金方法は、長期使用の場合、従量課金の課金方法よりも費用対効果が高くなります。 従量課金: 従量課金インスタンスは1時間ごとに課金されます。 従量課金方法は、短期使用に適しています。 従量課金データ同期インスタンスが不要になった場合は、インスタンスをリリースしてコストを削減できます。
    	リソースグループの設定	データ同期インスタンスが属するリソースグループ。 デフォルト値: Default resource group 詳細については、「リソース管理とは 」をご参照ください。
    	インスタンスクラス	DTSは、同期速度が異なるインスタンスクラスを提供します。 ビジネス要件に基づいてインスタンスクラスを選択できます。 詳細については、「データ同期インスタンスのインスタンスクラス」をご参照ください。
    	サブスクリプション期間	サブスクリプションの課金方法を選択した場合は、サブスクリプション期間と作成するデータ同期インスタンスの数を指定します。 サブスクリプション期間は、1〜9か月、1年、2年、3年、または5年とすることができる。 説明 このパラメーターは、サブスクリプション の課金方法を選択した場合にのみ使用できます。

11. データ伝送サービス (従量課金) サービス規約を読んで選択します。

12. [購入して開始] をクリックします。 表示されるダイアログボックスで、OK をクリックします。

    タスクリストでタスクの進行状況を確認できます。

インデックスとデータを確認する

データ同期タスクの状態が [実行中] に変わった後、データ視覚化ツールKibanaを使用してElasticsearchクラスターに接続できます。 これにより、インデックスが作成され、データが期待どおりに同期されているかどうかを確認できます。 Kibanaコンソールへのログイン方法の詳細については、「Kibanaコンソールへのログイン」をご参照ください。