雲訊息佇列 RocketMQ 版支援將指定執行個體的Topic列表資訊匯出,再匯入至其他的雲訊息佇列 RocketMQ 版執行個體,實現Topic的跨執行個體遷移。您可以在更換執行個體或者複製執行個體時,使用Topic匯入/匯出功能快速大量建立出相同的Topic。
背景資訊
雲訊息佇列 RocketMQ 版支援將指定執行個體的Topic資源清單資訊匯出,並匯入至其他的雲訊息佇列 RocketMQ 版執行個體中,您可以在以下情境使用Topic匯入或匯出功能:
更換執行個體
若當前執行個體不滿足您的要求需要使用新的執行個體,例如,從4.x執行個體變更為5.x執行個體,您可以將4.x執行個體的Topic列表匯出,然後再匯入至新的5.x執行個體,在5.x執行個體中可自動建立出相同的Topic。
複製執行個體
開發、測試、以及生產環境需要使用不同的執行個體進行部署,但業務訪問的Topic相同。您可以在其中一個執行個體中建立相關的Topic,並匯出Topic列表,其他執行個體則可以通過匯入該Topic列錶快速建立相同的Topic。
注意事項
Topic匯入或匯出支援跨執行個體系列,例如,您可以將4.x系列執行個體的Topic列表匯出然後匯入至5.x系列的執行個體中。
Topic匯入或匯出操作僅涉及Topic資源的基礎資訊,例如,Topic名稱、Topic的訊息類型、Topic的描述資訊,不涉及Topic中訊息資料的變更或遷移。
匯入Topic時,Topic列表必須符合模板要求,具體規範,請參見Topic列表模板。
Topic匯出
登入雲訊息佇列 RocketMQ 版控制台,在左側導覽列單擊執行個體列表。
在頂部功能表列選擇地區,如華東1(杭州),然後在執行個體列表中,單擊目標執行個體名稱。
在左側導覽列單擊Topic 管理。
在Topic 管理頁面右上方單擊
表徵圖。系統會自動將該執行個體下的Topic資源清單資料匯出並儲存為.xlsx檔案。
Topic匯入
您可以將已匯出的Topic列表直接匯入至目標執行個體中,也可以根據實際需求更新列表內容再匯入Topic資訊。
登入雲訊息佇列 RocketMQ 版控制台,在左側導覽列單擊執行個體列表。
在頂部功能表列選擇地區,如華東1(杭州),然後在執行個體列表中,單擊目標執行個體名稱。
在左側導覽列單擊Topic 管理。
在Topic 管理頁面右上方單擊
表徵圖。選擇在本地儲存的Topic資源清單檔案,然後單擊開啟。
待匯入的Topic資源清單的模板規範如下:
模板參數
說明
取值限制
TopicName
Topic名稱。
字元限制:支援字母a~z或A~Z、數字0~9以及底線(_)和短劃線(-)。
長度限制:1~60個字元。
Topic不能使用保留字元或特殊前置詞字元命名,具體限制,請參見參數限制。
MessageType
Topic的訊息類型。
取值如下:
TRANSACTION:事務訊息
DELAY:定時/延時訊息
FIFO:順序訊息
NORMAL:普通訊息
Remark
Topic的備忘資訊。
長度限制為1~60字元。
模板內容樣本如下:
TopicName
MessageType
Remark
Topic1
TRANSACTION
用於發送事務訊息
Topic2
NORMAL
用於發送普通訊息
Topic3
DELAY
用於發送延時訊息
在彈出的导入资源列表面板中,選中待匯入的Topic,在其操作列單擊确认并导入。
您也可以選中多個Topic,然後單擊批量导入。
匯入成功後,Topic列表中执行结果列變為已导入。
在导入资源列表面板左下角單擊确定完成匯入。
匯入完成後,選中的待匯入的Topic會出現在Topic列表中。
相關文檔
如果您需要同時跨執行個體同步Topic的列表資訊,請參見Group匯入/匯出。
如果您需要遷移自建RockketMQ叢集的資料到阿里雲的雲訊息佇列 RocketMQ 版上,請參見自建RocketMQ叢集遷移上雲。