ある ApsaraMQ for RocketMQ インスタンスから別のインスタンスへ移行する場合や、開発環境、テスト環境、本番環境で同一のトピック設定を維持する場合、手動でトピックを再作成する作業は煩雑でエラーが発生しやすくなります。トピックデータのエクスポートおよびインポート機能を使用すると、ソースインスタンスからトピックメタデータを .xlsx ファイルとしてエクスポートし、移行先インスタンスにインポートしてトピックを自動的に再作成できます。
エクスポートとインポートでは、トピックメタデータ (名前、メッセージタイプ、説明) のみが転送されます。トピックに保存されているメッセージは影響を受けず、移行されません。バージョン間のエクスポートおよびインポートがサポートされています。たとえば、4.x インスタンスからエクスポートして 5.x インスタンスにインポートできます。
ユースケース
インスタンス移行：ApsaraMQ for RocketMQ 4.x インスタンスからトピックデータをエクスポートし、5.x インスタンスにインポートします。すべてのトピックが新しいインスタンスで自動的に再作成されます。
環境クローニング：トピックを一度定義し、開発環境、テスト環境、本番環境のインスタンス間でエクスポートおよびインポートすることで、設定の同期を維持できます。
前提条件
作業を開始する前に、以下が必要です。
既存のトピックがある ApsaraMQ for RocketMQ インスタンス (ソース)
トピックの移行先となる ApsaraMQ for RocketMQ インスタンス (移行先)
トピックデータのエクスポート
ApsaraMQ for RocketMQ コンソールにログインします。 左側のナビゲーションペインで、[インスタンス] をクリックします。
トップナビゲーションバーで、[中国 (杭州)] などのリージョンを選択します。 インスタンス ページで、ソースインスタンスの名前をクリックします。
左側のナビゲーションペインで、トピック をクリックします。
トピック ページの右上隅で、
アイコンをクリックします。
トピックデータがローカルマシンの .xlsx ファイルに保存されます。
トピックデータのインポート
エクスポートした .xlsx ファイルを直接インポートするか、ビジネス要件に基づいて更新してからインポートできます。
ファイル形式の要件
.xlsx ファイルは、次の列を含む必要があります。
| パラメータ | 説明 | 有効な値 |
|---|---|---|
| TopicName | トピック名。 | 英字、数字、アンダースコア (_)、ハイフン (-) を使用し、長さは 1～60 文字である必要があります。予約されたシステム文字列や特殊なプレフィックスを含めることはできません。詳細については、「パラメータの制限」をご参照ください。 |
| MessageType | トピックのメッセージタイプ。 | TRANSACTION：トランザクションメッセージ。DELAY：スケジュール設定済みメッセージまたは遅延メッセージ。FIFO：順序付きメッセージ。NORMAL：通常メッセージ。 |
| Remark | トピックの説明。 | 1～60 文字。 |
例：
| TopicName | MessageType | Remark |
|---|---|---|
| Topic1 | TRANSACTION | トランザクションメッセージの送信に使用されます。 |
| Topic2 | NORMAL | 通常メッセージの送信に使用されます。 |
| Topic3 | DELAY | 遅延メッセージの送信に使用されます。 |
インポート手順
ApsaraMQ for RocketMQ コンソールにログオンします。左側のナビゲーションペインで、[インスタンス] をクリックします。
トップナビゲーションバーで、[中国 (杭州)] などのリージョンを選択します。 インスタンスページで、宛先インスタンスの名前をクリックします。
左側のナビゲーションペインで、トピック をクリックします。
トピック ページの右上隅で、
アイコンをクリックします。.xlsx ファイルを選択し、[開く] をクリックします。
リソースリストのインポート パネルで、インポートするトピックを選択し、操作 列の 確認してインポート をクリックします。複数のトピックをまとめてインポートするには、それらを選択して 一括インポート をクリックします。
各トピックの実行結果列にインポート済みと表示されたら、リソースリストのインポートパネルの左下隅にある完了をクリックします。
インポートされたトピックが、移行先インスタンスのトピックリストに表示されます。