ApsaraMQ for RocketMQでは、インスタンスのトピックデータをエクスポートし、そのデータを別のApsaraMQ for RocketMQインスタンスにインポートして、インスタンス間でトピックデータを同期できます。 インスタンスを変更または複製するときに、トピックデータのエクスポートおよびインポート機能を使用して、元のインスタンスのトピックと同じ基本情報を持つトピックをすばやく作成できます。
背景情報
ApsaraMQ for RocketMQでは、特定のインスタンスのトピックデータをエクスポートし、そのデータを別のApsaraMQ for RocketMQインスタンスにインポートできます。 トピックデータのエクスポートとインポート機能は、次のシナリオで使用できます。
インスタンスの変更
この機能は、インスタンスを変更するときに使用できます。 たとえば、ApsaraMQ For RocketMQ 4.xインスタンスがビジネス要件を満たさず、インスタンスをApsaraMQ for RocketMQ 5.xインスタンスに変更する場合、この機能を使用して4.xインスタンスのトピックデータをエクスポートし、5.xインスタンスにデータをインポートできます。 これにより、4.xインスタンスで使用するトピックを5.xインスタンスで自動的に作成できます。
インスタンスのクローンの作成
この機能は、さまざまなApsaraMQ for RocketMQインスタンスをデプロイし、開発、テスト、および本番環境で同じトピックにビジネスがアクセスできるようにするときに使用できます。 この場合、デプロイされたインスタンスの1つで関連トピックを作成し、この機能を使用してトピックデータをエクスポートし、そのデータを他のインスタンスにインポートして同じトピックをすばやく作成できます。
使用上の注意
トピックデータのエクスポートとインポート機能は、バージョン間のインポートとエクスポートをサポートします。 たとえば、ApsaraMQ For RocketMQ 4.xインスタンスのトピックデータをエクスポートし、ApsaraMQ for RocketMQ 5.xインスタンスにデータをインポートできます。
トピックデータをエクスポートまたはインポートすると、トピックの名前、メッセージタイプ、説明など、トピックに関する基本情報のみがエクスポートまたはインポートされます。 トピック内のメッセージは変更も移行もされません。
トピックデータをインポートする場合、インポートするファイル内のパラメーターの値が特定の要件を満たしている必要があります。 詳細については、このトピックの「トピックデータのインポート」セクションの手順5を参照してください。
トピックデータのエクスポートExport topic data
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。 [インスタンス] ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、トピック.
の右上隅にトピックページをクリックし、
アイコンが表示されます。 システムはインスタンスのトピックデータをエクスポートし、データを. xlsxファイルを作成します。
トピックデータのインポート
エクスポートされたトピックデータを宛先インスタンスに直接インポートできます。 データをターゲットインスタンスにインポートする前に、ビジネス要件に基づいてエクスポートされたトピックデータを更新することもできます。
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。 [インスタンス] ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、トピック.
トピックページの右上隅に、
アイコンをクリックします。 保存したトピックデータファイルを選択し、開く.
インポートするトピックデータファイルのパラメーター値の要件を次の表に示します。
パラメーター
説明
有効値
TopicName
トピック名。
トピック名には、英数字、アンダースコア (_) 、およびハイフン (-) を使用できます。
トピック名は1 ~ 60文字である必要があります。
トピック名には、システム用に予約されている文字列または特殊なプレフィックスを含む文字列を含めることはできません。 詳細については、「パラメーターの制限」をご参照ください。
MessageType
トピックのメッセージタイプ。
有効な値：
TRANSACTION: トランザクションメッセージ
DELAY: スケジュールまたは遅延メッセージ
FIFO: 順序付けられたメッセージ
NORMAL: 通常のメッセージ
備考
トピックの説明。
トピックの説明は1 ~ 60文字である必要があります。
例：
TopicName
MessageType
備考
トピック1
トランザクション
トランザクションメッセージの送信に使用されます。
Topic2
NORMAL
通常のメッセージを送信するために使用されます。
トピック3
DELAY
遅延メッセージの送信に使用されます。
では、リソースリストのインポートパネルで、データをインポートするトピックを選択し、確認してインポートで、操作列を作成します。
複数のトピックを選択して、一括インポート をクリックすることもできます。
トピックデータがインポートされると、トピックリストの 実行結果 列の値が インポート済み に変わります。
リソースリストのインポートパネルの左下隅に、インポートを完了するため確定をクリックします。
トピックデータがインポートされると、データがインポートされたトピックがトピックリストに表示されます。
関連ドキュメント
インスタンス間でグループデータを同期する方法については、「グループデータのエクスポートとインポート」をご参照ください。
セルフマネージド型Apache RocketMQクラスターからApsaraMQ For RocketMQインスタンスにデータを移行する方法については、「セルフマネージド型Apache RocketMQクラスターをApsaraMQ for RocketMQインスタンスに移行」をご参照ください。