ApsaraMQ for RocketMQを使用すると、インスタンスのグループデータをエクスポートしてから、別のApsaraMQ for RocketMQインスタンスにデータをインポートできます。 インスタンスを変更または複製するときに、グループデータのエクスポートおよびインポート機能を使用して、元のインスタンスのグループと同じ基本情報を持つグループをすばやく作成できます。
背景情報
グループデータのエクスポートとインポート機能は、次のシナリオで使用できます。
インスタンスの変更
使用するApsaraMQ for RocketMQインスタンスがビジネス要件を満たさない場合、新しいインスタンスを購入し、この機能を使用して元のインスタンスのグループデータをエクスポートし、新しいインスタンスにデータをインポートできます。 これにより、元のインスタンスで使用するグループが新しいインスタンスに自動的に作成されます。
インスタンスのクローンの作成
この機能は、さまざまなApsaraMQ for RocketMQインスタンスをデプロイし、開発、テスト、および本番環境で同じグループにビジネスがアクセスできるようにする場合に使用できます。 この場合、デプロイされたインスタンスの1つに関連グループを作成し、グループデータのエクスポートおよびインポート機能を使用してグループデータをエクスポートし、データを別のインスタンスにインポートして、既存のインスタンスに同じグループをすばやく作成できます。
使用上の注意
ApsaraMQ for RocketMQ 4.xインスタンスのグループメタデータは、ApsaraMQ for RocketMQ 5.xインスタンスのグループメタデータとは異なります。 グループデータをエクスポートおよびインポートする場合は、次の項目に注意してください。
5.xインスタンスのグループデータを4.xインスタンスに直接インポートできます。 グループデータをインポートすると、インポートしたファイルの特定のフィールドのみが有効になります。 詳細については、「グループデータのインポートとエクスポート」トピックの「グループデータのインポート」セクションの手順5を参照してください。
4.xインスタンスのグループデータを5.xインスタンスに直接インポートすることはできません。 データをインポートする前に、このトピックの「グループデータのインポート」セクションの手順5の説明に基づいて、インポートするグループデータファイルのパラメーターを変更する必要があります。
グループデータをエクスポートおよびインポートすると、グループのID、消費ポリシー、説明など、グループに関する基本情報のみがエクスポートおよびインポートされます。 サブスクリプションおよびメッセージデータは変更または移行されません。
グループデータをインポートする場合、インポートするファイル内のパラメーターの値は、このトピックの「グループデータのインポート」セクションの手順5で指定した要件を満たしている必要があります。
グループデータのエクスポート
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。 [インスタンス] ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、グループ.
グループページの右上隅に、
アイコンをクリックします。 システムはインスタンスのグループデータをエクスポートし、データを. xlsxファイルを作成します。
グループデータのインポート
エクスポートしたグループデータを宛先インスタンスに直接インポートできます。 データを移行先インスタンスにインポートする前に、ビジネス要件に基づいて、エクスポートされたグループデータを更新することもできます。
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。 [インスタンス] ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、グループ.
グループページの右上隅に、
アイコンをクリックします。 オンプレミスマシンに保存したグループデータファイルを選択し、開く.
インポートするグループデータファイルのパラメーター値の要件を次の表に示します。
パラメーター
説明
有効値
ConsumerGroupId
グループID。
グループIDには、英数字、アンダースコア (_) 、およびハイフン (-) を使用できます。
グループIDの長さは1 ~ 60文字である必要があります。
グループIDには、システム用に予約されている文字または特殊なプレフィックスを含めることはできません。 詳細については、「パラメーターの制限」をご参照ください。
DeliveryOrderType
ApsaraMQ for RocketMQがコンシューマークライアントにメッセージを配信する順序。
有効な値：
同時に: 同時配信
注文: 注文配達
詳細については、「注文メッセージ」をご参照ください。
ConsumeRetryPolicy
コンシューマーがメッセージの消費に失敗した場合に使用される再試行ポリシー。
有効な値：
FixedRetryPolicy: 固定間隔の再試行
DefaultRetryPolicy: 指数バックオフの再試行
詳細は、「消費の再試行」をご参照ください。
MaxRetryTimes
リトライの最大回数は 10 回です。
このパラメーターを1000以下の値に設定します。
DeadLetterTargetTopic
デッドレターのトピック。
デッドレターメッセージの送信元のトピックは、デッドレタートピックとして使用できません。
デッドレターメッセージ機能を使用しない場合は、このパラメーターを空のままにします。
詳細については、「デッドレターメッセージ」をご参照ください。
備考
グループの説明。
グループの説明は1 ~ 60文字である必要があります。
例：
ConsumerGroupId
DeliveryOrderType
ConsumeRetryPolicy
MaxRetryTimes
DeadLetterTargetTopic
備考
testgroup1
秩序ある
FixedRetryPolicy
16
課金メッセージをサブスクライブするために使用されます。
testgroup2
同時に
DefaultRetryPolicy
16
targettopic1
物流メッセージを購読するために使用されます。
では、リソースリストのインポートパネルで、データをインポートするグループを選択し、確認してインポートで、操作列を作成します。
複数のグループを選択して、一括インポート をクリックすることもできます。
グループデータをインポートすると、グループリストの 実行結果 列の値が インポート済み に変わります。
リソースリストのインポートパネルの左下隅に、インポート操作を完了するため確定をクリックします。
グループデータがインポートされると、データがインポートされたグループがグループリストに表示されます。
関連ドキュメント
インスタンス間でトピックデータを同期する方法については、「トピックデータのエクスポートとインポート」をご参照ください。
セルフマネージド型Apache RocketMQクラスターからApsaraMQ For RocketMQインスタンスにデータを移行する方法については、「セルフマネージド型Apache RocketMQクラスターをApsaraMQ for RocketMQインスタンスに移行」をご参照ください。