ApsaraMQ for RocketMQ インスタンスの置き換えや環境間での構成の複製を行う際、コンシューマーグループを手動で再作成するのは時間がかかり、エラーが発生しやすくなります。グループデータのエクスポートおよびインポート機能を使用すると、あるインスタンスからグループ構成を .xlsx ファイルとしてエクスポートし、別のインスタンスにインポートすることで、すべてのグループを同じ設定で自動的に再作成できます。
エクスポートされるのはグループメタデータ (グループ ID、配信順序タイプ、リトライポリシー、説明) のみです。サブスクリプションおよびメッセージデータはエクスポートされず、変更もされません。
ユースケース
インスタンスの置き換え：元のインスタンスからグループデータをエクスポートし、新しいインスタンスにインポートします。すべてのグループが自動的に再作成されます。
環境のクローン作成：開発、テスト、本番環境のインスタンス間でグループ構成を 1 回のインポート操作で複製できます。
バージョン間の互換性
グループメタデータは、ApsaraMQ for RocketMQ 4.x インスタンスと 5.x インスタンスで異なります。
| 移行パス | 必要な操作 |
|---|---|
| 5.x から 4.x | 直接インポートできます。4.x インスタンスでは特定のフィールドのみが有効になります。 |
| 4.x から 5.x | インポートする前に、データファイル内のパラメーターを 5.x 形式に合わせて更新する必要があります。「パラメーター要件」をご参照ください。 |
グループデータのエクスポート
ApsaraMQ for RocketMQ コンソールにログインします。左側のナビゲーションペインで、[インスタンス] をクリックします。
上部のナビゲーションバーで、[中国 (杭州)] などのリージョンを選択します。インスタンスページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションペインで、グループ をクリックします。
グループ ページの右上隅で、
アイコンをクリックします。すべてのグループデータがインスタンスからエクスポートされ、.xlsx ファイルとして保存されます。
グループデータのインポート
エクスポートしたファイルを直接インポートすることも、事前に編集してグループを更新してからインポートすることもできます。
ApsaraMQ for RocketMQ コンソールにログオンします。左側のナビゲーションペインで、[インスタンス] をクリックします。
トップナビゲーションバーで、[中国 (杭州)] などのリージョンを選択します。インスタンスページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションペインで、グループ をクリックします。
グループ ページの右上隅で、
アイコンをクリックします。ローカルマシンからグループデータファイルを選択し、[開く] をクリックします。
リソースリストのインポート パネルで、インポートするグループを選択し、操作 列の 確認してインポート をクリックします。 複数のグループを一度にインポートするには、それらを選択して 一括インポート をクリックします。 各グループが処理されると、その 実行結果 列に インポート済み と表示されます。
リソースリストのインポート パネルの左下隅で、完了 をクリックしてインポートを完了します。 インポートされたグループがグループリストに表示されます。
パラメーター要件
インポートファイルの各行は、以下の要件を満たす必要があります。
| パラメーター | 説明 | 有効な値 |
|---|---|---|
| ConsumerGroupId | グループ ID。英字、数字、アンダースコア (_)、ハイフン (-) のみ使用可能です。1~60 文字。システム予約文字や特殊なプレフィックスを含めることはできません。「パラメーターの制限」をご参照ください。 | 英字、数字、アンダースコア、ハイフン |
| DeliveryOrderType | メッセージ配信順序。「順序付きメッセージ」をご参照ください。 | Concurrently (並列配信) または Orderly (順序付き配信) |
| ConsumeRetryPolicy | メッセージ消費失敗時のリトライポリシー。「メッセージのリトライ」をご参照ください。 | FixedRetryPolicy (固定間隔リトライ) または DefaultRetryPolicy (エクスポネンシャルバックオフリトライ) |
| MaxRetryTimes | 最大リトライ回数。 | 1,000 以下 |
| DeadLetterTargetTopic | リトライ制限を超えたメッセージの送信先 Topic。ソース Topic をデッドレタートピックとして使用することはできません。無効にするには空白のままにします。「デッドレターメッセージ」をご参照ください。 | 有効な Topic 名、または空白 |
| Remark | グループの説明。 | 1~60 文字 |
データファイルの例
| ConsumerGroupId | DeliveryOrderType | ConsumeRetryPolicy | MaxRetryTimes | DeadLetterTargetTopic | Remark |
|---|---|---|---|---|---|
| testgroup1 | Orderly | FixedRetryPolicy | 16 | 課金メッセージのサブスクリプションに使用されます。 | |
| testgroup2 | Concurrently | DefaultRetryPolicy | 16 | targettopic1 | 物流メッセージのサブスクリプションに使用されます。 |