すべてのプロダクト
Search

このプロダクト

    ApsaraMQ for RocketMQ:トピックデータのエクスポートおよびインポート

    ドキュメントセンター

    ApsaraMQ for RocketMQ:トピックデータのエクスポートおよびインポート

    最終更新日:Mar 12, 2026

    ApsaraMQ for RocketMQ のインスタンス間での移行、または開発・テスト・本番環境間で同一のトピック構成を維持する場合、トピックを手動で再作成するのは煩雑であり、ミスが発生しやすくなります。トピックデータのエクスポートおよびインポート機能では、ソースインスタンスからトピックのメタデータを .xlsx ファイル形式でエクスポートし、宛先インスタンスにインポートすることで、トピックを自動的に再作成できます。

    エクスポートおよびインポートでは、トピック名、メッセージタイプ、説明文といったトピックのメタデータのみが転送されます。トピック内に保存されたメッセージは一切影響を受けず、移行されません。また、バージョンを跨いだエクスポートおよびインポートもサポートされています。たとえば、4.x インスタンスからエクスポートしたデータを 5.x インスタンスにインポートできます。

    適用範囲

    • インスタンスの移行：ApsaraMQ for RocketMQ 4.x インスタンスからトピックデータをエクスポートし、5.x インスタンスにインポートします。新規インスタンス上ですべてのトピックが自動的に再作成されます。

    • 環境の複製：トピックを一度定義した後、開発・テスト・本番環境の各インスタンス間でエクスポートおよびインポートを実行し、構成の一貫性を保ちます。

    前提条件

    開始する前に、以下の条件を満たしていることを確認してください。

    • 既存のトピックを持つ ApsaraMQ for RocketMQ インスタンス（ソース）

    • トピックを受信する ApsaraMQ for RocketMQ インスタンス（宛先）

    • ApsaraMQ for RocketMQ コンソール へのアクセス権限

    トピックデータのエクスポート

    1. ApsaraMQ for RocketMQ コンソール にログインします。左側ナビゲーションウィンドウで、[インスタンス] をクリックします。

    2. 上部ナビゲーションバーでリージョン（例：[中国 (杭州)]）を選択します。インスタンス一覧ページで、ソースインスタンスの名前をクリックします。

    3. 左側ナビゲーションウィンドウで、トピック をクリックします。

    4. トピック ページの右上隅にある Export アイコンをクリックします。

    トピックデータが、ローカルマシンに .xlsx ファイルとして保存されます。

    トピックデータのインポート

    エクスポートした .xlsx ファイルをそのままインポートするか、業務要件に応じてファイル内容を編集してからインポートしてください。

    ファイルフォーマットの要件

    .xlsx ファイルには、以下の列を含める必要があります。

    パラメーター説明有効な値
    TopicNameトピック名。英字、数字、アンダースコア (\_)、ハイフン (-) のみ使用可能。長さは 1～60 文字。予約済みのシステム文字列や特殊なプレフィックスを含めることはできません。詳細については、「パラメーターの使用制限」をご参照ください。
    MessageTypeトピックのメッセージタイプ。TRANSACTION：トランザクションメッセージ。DELAY：スケジュールまたは遅延メッセージ。FIFO：順序付きメッセージ。NORMAL：通常メッセージ。
    Remarkトピックの説明文。1～60 文字。

    サンプル：

    TopicNameMessageTypeRemark
    Topic1TRANSACTIONトランザクションメッセージの送信に使用。
    Topic2NORMAL通常メッセージの送信に使用。
    Topic3DELAY遅延メッセージの送信に使用。

    インポート手順

    1. ApsaraMQ for RocketMQ コンソール にログインします。左側ナビゲーションウィンドウで、[インスタンス] をクリックします。

    2. 上部ナビゲーションバーでリージョン（例：[中国 (杭州)]）を選択します。インスタンス一覧ページで、宛先インスタンスの名前をクリックします。

    3. 左側ナビゲーションウィンドウで、トピック をクリックします。

    4. トピック ページの右上隅にある Import アイコンをクリックします。

    5. .xlsx ファイルを選択し、[開く] をクリックします。

    6. リソースリストのインポート パネルで、インポート対象のトピックを選択し、確認してインポート をクリックします（操作 列）。複数のトピックを一度にインポートする場合は、対象トピックを選択したうえで、一括インポート をクリックします。

    7. 実行結果 列に各トピックについて インポート済み と表示されたら、リソースリストのインポート パネルの左下にある 確定 をクリックします。

    インポートされたトピックが、宛先インスタンスのトピック一覧に表示されます。

    関連トピック