ApsaraMQ for RocketMQを使用すると、インスタンスのグループデータをエクスポートしてから、別のApsaraMQ for RocketMQインスタンスにデータをインポートできます。 インスタンスを変更または複製するときに、グループデータのエクスポートおよびインポート機能を使用して、元のインスタンスのグループと同じ基本情報を持つグループをすばやく作成できます。
背景情報
グループデータのエクスポートとインポート機能は、次のシナリオで使用できます。
インスタンスの変更
使用するApsaraMQ for RocketMQインスタンスがビジネス要件を満たさない場合、新しいインスタンスを購入し、この機能を使用して元のインスタンスのグループデータをエクスポートし、新しいインスタンスにデータをインポートできます。 これにより、元のインスタンスで使用するグループが新しいインスタンスに自動的に作成されます。
インスタンスのクローンの作成
この機能は、さまざまなApsaraMQ for RocketMQインスタンスをデプロイし、開発、テスト、および本番環境で同じグループにビジネスがアクセスできるようにする場合に使用できます。 この場合、デプロイされたインスタンスの1つに関連グループを作成し、グループデータのエクスポートおよびインポート機能を使用してグループデータをエクスポートし、データを別のインスタンスにインポートして、既存のインスタンスに同じグループをすばやく作成できます。
使用上の注意
ApsaraMQ for RocketMQ 4.xインスタンスのグループメタデータは、ApsaraMQ for RocketMQ 5.xインスタンスのグループメタデータとは異なります。 グループデータをエクスポートおよびインポートする場合は、次の項目に注意してください。
ApsaraMQ for RocketMQ 5.xインスタンスのグループデータをApsaraMQ for RocketMQ 4.xインスタンスに直接インポートできます。 グループデータをインポートすると、インポートしたファイルの特定のフィールドのみが有効になります。 詳細については、このトピックの「グループデータのインポート」セクションの手順5を参照してください。
ApsaraMQ for RocketMQ 4.xインスタンスのグループデータをApsaraMQ for RocketMQ 5.xインスタンスに直接インポートすることはできません。 データをインポートする前に、グループデータのインポートとエクスポートのトピックの「グループデータのインポート」セクションの手順5の説明に基づいて、インポートするグループデータファイルのパラメーターを変更する必要があります。
グループデータをエクスポートおよびインポートすると、グループID、グループの消費ポリシー、グループの説明など、グループに関する基本情報のみがエクスポートおよびインポートされます。 サブスクリプションおよびメッセージデータは変更または移行されません。
グループデータをインポートする場合、インポートするファイル内のパラメーターの値は、このトピックの「グループデータのインポート」セクションの手順5で指定した要件を満たしている必要があります。
グループデータのエクスポート
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。 [インスタンス] ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、グループ.
グループページの右上隅に
アイコンをクリックします。 システムはインスタンスのグループデータをエクスポートし、データを. xlsxファイルを作成します。
グループデータのインポート
エクスポートしたグループデータを宛先インスタンスに直接インポートできます。 データを移行先インスタンスにインポートする前に、ビジネス要件に基づいて、エクスポートされたグループデータを更新することもできます。 グループデータを宛先インスタンスにインポートするには、次の手順を実行します。
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。 [インスタンス] ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、グループ.
グループページの右上隅に
アイコンをクリックします。 オンプレミスマシンに保存したグループデータファイルを選択し、開く.
インポートするグループデータファイルのパラメーターの値の要件を次の表に示します。
パラメーター
説明
有効値
ConsumerGroupId
グループID。
グループIDには、英数字、アンダースコア (_) 、およびハイフン (-) を使用できます。 グループIDを "GID_" または "GID-" で開始することを推奨します。
グループIDの長さは2 ~ 64文字である必要があります。
ConsumerGroupType
グループによって使用されるプロトコル。
ApsaraMQ for RocketMQでは、HTTPおよびTCPクライアントを使用してメッセージを送受信できます。 異なるタイプのクライアントに対して異なるグループを作成する必要があります。 たとえば、TCPクライアントSDKを使用してメッセージを送受信する場合は、TCPプロトコルを使用するグループを作成する必要があります。
有効な値：
TCP
HTTP
備考
グループの説明。
グループの説明は1 ~ 60文字である必要があります。
例：
ConsumerGroupId
ConsumerGroupType
備考
GID_test1
HTTP
HTTPクライアントに使用されます。
GID_test2
TCP
TCPクライアントに使用されます。
では、リソースリストのインポートパネルで、データをインポートするグループを選択し、確認してインポートで、操作列を作成します。
複数のグループを選択して、一括インポート をクリックすることもできます。
グループデータをインポートすると、グループリストの 実行結果 列の値が インポート済み に変わります。
リソースリストのインポートパネルの左下隅に、確定をクリックしてインポート操作を完了します。
グループデータがインポートされると、データがインポートされたグループがグループリストに表示されます。
関連ドキュメント
インスタンス間でトピックデータを同期する方法については、「トピックデータのエクスポートとインポート」をご参照ください。
セルフマネージド型Apache RocketMQクラスターからApsaraMQ For RocketMQインスタンスにデータを移行する方法については、「セルフマネージド型Apache RocketMQクラスターをApsaraMQ for RocketMQインスタンスに移行」をご参照ください。