Topic導(dǎo)入/導(dǎo)出
云消息隊(duì)列 RocketMQ 版支持將指定實(shí)例的Topic列表信息導(dǎo)出，再導(dǎo)入至其他的云消息隊(duì)列 RocketMQ 版實(shí)例，實(shí)現(xiàn)Topic的跨實(shí)例遷移。您可以在更換實(shí)例或者克隆實(shí)例時(shí)，使用Topic導(dǎo)入/導(dǎo)出功能快速批量創(chuàng)建出相同的Topic。
背景信息
云消息隊(duì)列 RocketMQ 版支持將指定實(shí)例的Topic資源列表信息導(dǎo)出，并導(dǎo)入至其他的云消息隊(duì)列 RocketMQ 版實(shí)例中，您可以在以下場景使用Topic導(dǎo)入或?qū)С龉δ埽?/p>
更換實(shí)例
若當(dāng)前實(shí)例不滿足您的要求需要使用新的實(shí)例，例如，從4.x實(shí)例變更為5.x實(shí)例，您可以將4.x實(shí)例的Topic列表導(dǎo)出，然后再導(dǎo)入至新的5.x實(shí)例，在5.x實(shí)例中可自動(dòng)創(chuàng)建出相同的Topic。
克隆實(shí)例
開發(fā)、測試、以及生產(chǎn)環(huán)境需要使用不同的實(shí)例進(jìn)行部署，但業(yè)務(wù)訪問的Topic相同。您可以在其中一個(gè)實(shí)例中創(chuàng)建相關(guān)的Topic，并導(dǎo)出Topic列表，其他實(shí)例則可以通過導(dǎo)入該Topic列表快速創(chuàng)建相同的Topic。
注意事項(xiàng)
Topic導(dǎo)入或?qū)С鲋С挚鐚?shí)例系列，例如，您可以將4.x系列實(shí)例的Topic列表導(dǎo)出然后導(dǎo)入至5.x系列的實(shí)例中。
Topic導(dǎo)入或?qū)С霾僮鲀H涉及Topic資源的基礎(chǔ)信息，例如，Topic名稱、Topic的消息類型、Topic的描述信息，不涉及Topic中消息數(shù)據(jù)的變更或遷移。
導(dǎo)入Topic時(shí)，Topic列表必須符合模板要求，具體規(guī)范，請參見Topic列表模板。
Topic導(dǎo)出
登錄云消息隊(duì)列 RocketMQ 版控制臺，在左側(cè)導(dǎo)航欄單擊實(shí)例列表。
在頂部菜單欄選擇地域，如華東1（杭州），然后在實(shí)例列表中，單擊目標(biāo)實(shí)例名稱。
在左側(cè)導(dǎo)航欄單擊Topic 管理。
在Topic 管理頁面右上角單擊
圖標(biāo)。系統(tǒng)會自動(dòng)將該實(shí)例下的Topic資源列表數(shù)據(jù)導(dǎo)出并保存為.xlsx文件。
Topic導(dǎo)入
您可以將已導(dǎo)出的Topic列表直接導(dǎo)入至目標(biāo)實(shí)例中，也可以根據(jù)實(shí)際需求更新列表內(nèi)容再導(dǎo)入Topic信息。
登錄云消息隊(duì)列 RocketMQ 版控制臺，在左側(cè)導(dǎo)航欄單擊實(shí)例列表。
在頂部菜單欄選擇地域，如華東1（杭州），然后在實(shí)例列表中，單擊目標(biāo)實(shí)例名稱。
在左側(cè)導(dǎo)航欄單擊Topic 管理。
在Topic 管理頁面右上角單擊
圖標(biāo)。選擇在本地保存的Topic資源列表文件，然后單擊打開。
待導(dǎo)入的Topic資源列表的模板規(guī)范如下：
模板參數(shù)
說明
取值限制
TopicName
Topic名稱。
字符限制：支持字母a~z或A~Z、數(shù)字0~9以及下劃線（_）和短劃線（-）。
長度限制：1~60個(gè)字符。
Topic不能使用保留字符或特殊前綴字符命名，具體限制，請參見參數(shù)限制。
MessageType
Topic的消息類型。
取值如下：
TRANSACTION：事務(wù)消息
DELAY：定時(shí)/延時(shí)消息
FIFO：順序消息
NORMAL：普通消息
Remark
Topic的備注信息。
長度限制為1~60字符。
模板內(nèi)容示例如下：
TopicName
MessageType
Remark
Topic1
TRANSACTION
用于發(fā)送事務(wù)消息
Topic2
NORMAL
用于發(fā)送普通消息
Topic3
DELAY
用于發(fā)送延時(shí)消息
在彈出的導(dǎo)入資源列表面板中，選中待導(dǎo)入的Topic，在其操作列單擊確認(rèn)并導(dǎo)入。
您也可以選中多個(gè)Topic，然后單擊批量導(dǎo)入。
導(dǎo)入成功后，Topic列表中執(zhí)行結(jié)果列變?yōu)?b id="uicontrol-16w-jyy-r2h" data-tag="uicontrol" data-isbold="true" class="uicontrol">已導(dǎo)入。
在導(dǎo)入資源列表面板左下角單擊確定完成導(dǎo)入。
導(dǎo)入完成后，選中的待導(dǎo)入的Topic會出現(xiàn)在Topic列表中。
相關(guān)文檔
如果您需要同時(shí)跨實(shí)例同步Group的列表信息，請參見Group導(dǎo)入/導(dǎo)出。
如果您需要遷移自建RockketMQ集群的數(shù)據(jù)到阿里云的云消息隊(duì)列 RocketMQ 版上，請參見自建RocketMQ集群遷移上云。