ApsaraMQ for RocketMQ：Topic匯入/匯出

注意事項

• Topic匯入或匯出支援跨執行個體系列，例如，您可以將4.x系列執行個體的Topic列表匯出然後匯入至5.x系列的執行個體中。

• Topic匯入或匯出操作僅涉及Topic資源的基礎資訊，例如，Topic名稱、Topic的訊息類型、Topic的描述資訊，不涉及Topic中訊息資料的變更或遷移。

• 匯入Topic時，Topic列表必須符合模板要求，具體規範，請參見Topic列表模板。

Topic匯出

1. 登入雲訊息佇列 RocketMQ 版控制台，在左側導覽列單擊執行個體列表。

2. 在頂部功能表列選擇地區，如華東1（杭州），然後在執行個體列表中，單擊目標執行個體名稱。

3. 在左側導覽列單擊Topic 管理。

4. 在Topic 管理頁面右上方單擊表徵圖。

   系統會自動將該執行個體下的Topic資源清單資料匯出並儲存為.xlsx檔案。

Topic匯入

您可以將已匯出的Topic列表直接匯入至目標執行個體中，也可以根據實際需求更新列表內容再匯入Topic資訊。

1. 登入雲訊息佇列 RocketMQ 版控制台，在左側導覽列單擊執行個體列表。

2. 在頂部功能表列選擇地區，如華東1（杭州），然後在執行個體列表中，單擊目標執行個體名稱。

3. 在左側導覽列單擊Topic 管理。

4. 在Topic 管理頁面右上方單擊表徵圖。

5. 選擇在本地儲存的Topic資源清單檔案，然後單擊開啟。

   待匯入的Topic資源清單的模板規範如下：

   模板參數	說明	取值限制
   TopicName	Topic名稱。	字元限制：支援字母a~z或A~Z、數字0~9以及底線（_）和短劃線（-）。 長度限制： Serverless系列執行個體：1~128個字元。 非Serverless系列執行個體：1~60個字元。 Topic不能使用保留字元或特殊前置詞字元命名，具體限制，請參見參數 限制值 說明 執行個體名稱 字元限制：僅支援中文、字母a~z或A~Z、數字0~9和底線（_）。 長度限制：1~128個字元。 無。 Topic名稱 字元限制：支援字母a~z或A~Z、數字0~9以及底線（_）和短劃線（-）。 長度限制： Serverless系列執行個體：1~128個字元。 非Serverless系列執行個體：1~60個字元。 系統保留字元：Topic名稱不允許使用以下保留字元或含有特殊前、尾碼的字元命名。 保留字元 TBW102 BenchmarkTest SELF_TEST_TOPIC OFFSET_MOVED_EVENT SCHEDULE_TOPIC_XXXX RMQ_SYS_TRANS_HALF_TOPIC RMQ_SYS_TRACE_TOPIC RMQ_SYS_TRANS_OP_HALF_TOPIC 特殊首碼 rmq_sys_ %RETRY% %DLQ% rocketmq-broker- rocketmq-proxy- 特殊尾碼 _REPLY_TOPIC Topic命名應該盡量使用簡短、常用的字元，避免使用特殊字元。特殊字元會導致系統解析出現異常，字元過長可能會導致訊息收發被拒絕。 LiteTopic名稱 字元限制：支援字母a~z或A~Z、數字0~9以及底線（_）和短劃線（-）。 長度限制：1~64個字元。 LiteTopic命名應該盡量使用簡短、常用的字元，避免使用特殊字元。特殊字元會導致系統解析出現異常，字元過長可能會導致訊息收發被拒絕。 LiteTopic到期時間 預設值：使用者必填參數，無預設值。 取值範圍：30~720 或 -1，單位為分鐘，整數。-1 表示不會到期。 當前主題下輕量佈景主題資源到期時間。當該主題下的任意輕量主題持續沒有新的訊息寫入，時間長度達到輕量主題到期時間後，該輕量主題會到期並被自動刪除。如值為 -1 ，則代表輕量主題不會到期，會持續存在不被刪除。當訊息類型為 Lite 時，可以設定此欄位。 ConsumerGroup名稱 字元限制：支援字母a~z或A~Z、數字0~9以及底線（_）和短劃線（-）。 長度限制： Serverless系列執行個體：1~128個字元。 非Serverless系列執行個體：1~60個字元。 系統保留字元：ConsumerGroup不允許使用以下保留字元或含有特殊首碼的字元命名。 保留字元 DEFAULT_CONSUMER DEFAULT_PRODUCER TOOLS_CONSUMER FILTERSRV_CONSUMER __MONITOR_CONSUMER CLIENT_INNER_PRODUCER SELF_TEST_P_GROUP SELF_TEST_C_GROUP CID_ONS-HTTP-PROXY CID_ONSAPI_PERMISSION CID_ONSAPI_OWNER CID_ONSAPI_PULL CID_RMQ_SYS_TRANS 特殊字元 CID_RMQ_SYS_ CID_HOUSEKEEPING 無。 執行個體備忘 字元限制：僅支援中文、字母a~z或A~Z、數字0~9和底線（_）。 長度限制：1~256個字元。 無。 Topic備忘 Group備忘 ACL Credentials 字元限制：AK（AccessKey ID）、SK（AccessKey Secret）和Token僅支援字母a~z或A~Z、數字0~9。 長度限制：不超過1024個字元。 無。 請求逾時時間 預設值：3000毫秒。 取值範圍：該參數為用戶端本地行為，取值範圍不做限制。 請求逾時時間是用戶端本地同步調用的等待時間，請根據實際應用設定合理的取值，避免線程阻塞時間過長。 訊息大小 不超過4 MB。 不涉及訊息壓縮，僅計算訊息體body的大小。 訊息傳輸應盡量壓縮和控制負載大小，避免超大檔案傳輸。若訊息大小不滿足限制要求，可以嘗試分割訊息或使用OSS儲存，用訊息傳輸URL。特殊訊息大小支援，可提工單支援。 訊息自訂屬性 字元限制：所有可見字元。 數量限制：每條訊息最多可設定128個屬性。 長度限制：屬性的Key和Value總長度不超過16 KB。 系統保留屬性：不允許使用以下保留屬性作為自訂屬性的Key。 保留屬性Key TRACE_ON MSG_REGION KEYS TAGS DELAY RETRY_TOPIC REAL_TOPIC REAL_QID TRAN_MSG PGROUP MIN_OFFSET MAX_OFFSET BUYER_ID ORIGIN_MESSAGE_ID TRANSFER_FLAG CORRECTION_FLAG MQ2_FLAG RECONSUME_TIME UNIQ_KEY MAX_RECONSUME_TIMES CONSUME_START_TIME POP_CK POP_CK_OFFSET 1ST_POP_TIME TRAN_PREPARED_QUEUE_OFFSET DUP_INFO EXTEND_UNIQ_INFO INSTANCE_ID CORRELATION_ID REPLY_TO_CLIENT TTL ARRIVE_TIME PUSH_REPLY_TIME CLUSTER MSG_TYPE INNER_MULTI_QUEUE_OFFSET _BORNHOST __LITE_TOPIC 無。 MessageGroup 字元限制：所有可見字元。 長度限制：1~64位元組。 MessageGroup是順序訊息的分組標識。一般設定為需要保證順序的一組訊息標識，例如訂單ID、使用者ID等。 訊息發送重試次數 預設值：3次。 取值範圍：無限制。 訊息發送重試是用戶端SDK內建的重試策略，對應用不可見，建議取值不要過大，避免阻塞業務線程。 如果訊息達到最大重試次數後還未發送成功，建議業務側做好兜底處理，保證訊息可靠性。 訊息消費重試次數 預設值：16次。 最大限制：不超過1000次。 消費重試次數應根據實際業務需求設定合理的參數值，避免使用重試進行無限觸發。重試次數過大容易造成系統壓力過量增加。 事務異常檢查間隔 預設值：60秒。 取值範圍：不支援自訂修改。 事務異常檢查間隔指的是，半事務訊息因系統重啟或異常情況導致沒有提交，生產者用戶端會按照該間隔時間進行事務狀態回查。 間隔時間長度不建議設定過短，否則頻繁的回查調用會影響系統效能。 半事務訊息第一次回查時間 預設值：取值等於[事務異常檢查間隔] 最大限制：不超過1小時。 無。 半事務訊息最大逾時時間長度 預設值：4小時。 取值範圍：不支援自訂修改。 半事務訊息因系統重啟或異常情況導致沒有提交，生產者用戶端會按照事務異常檢查間隔時間進行回查，若超過半事務訊息逾時時間長度後沒有返回結果，半事務訊息將會被強制復原。 您可以通過監控該指標避免異常事務。 定時訊息最大間隔 非Serverless系列（訂用帳戶、隨用隨付） 標準版：7天。 專業版、鉑金版：40天。 Serverless系列 存量標準版、專業版：7天。 共用：7天。 獨享：7天。可提工單修改，修改後不可降配到共用執行個體。 定時訊息間隔時間長度建議使用小時層級的時間區間，避免長時間定時。 PushConsumer消費逾時時間長度 預設值：230分鐘。 取值範圍：系統級配置，不支援修改。 PushConsumer消費逾時時間長度由雲訊息佇列 RocketMQ 版服務端統一控制。 超過消費逾時時間長度訊息還未處理完成，將被系統強制判定為消費失敗並進行重試，因此可能會導致少量訊息重複。 PushConsumer本機快取 預設值： 最大緩衝數量：1024條。 最大緩衝大小：64 M。 取值範圍：支援使用者自訂設定，無限制。 消費者類型為PushConsumer時，為提高消費者輸送量和效能，用戶端會在SDK本機快取部分訊息。緩衝的訊息的數量和大小應設定在系統記憶體允許的範圍內。 PushConsumer稍候再試時間長度 預設值： 非順序性投遞：間隔時間階梯變化，具體取值，請參見。 順序性投遞：1000毫秒。 取值範圍：不支援自訂修改。 無。 PushConsumer消費並發度 預設值：20個線程。 取值範圍：支援使用者自訂設定，無限制。 無。 擷取訊息最大批次 預設值：32條。 取值範圍：系統級配置，不支援修改。 消費者從服務端擷取訊息時，一次擷取到最大訊息條數。建議按照實際業務設定合理的參數值，一次擷取訊息數量過大容易在消費失敗時造成大批量訊息重複。 SimpleConsumer最大不可見時間 預設值：使用者必填參數，無預設值。 取值範圍：最小10秒；最大12小時。 消費不可見時間指的是訊息處理+失敗後稍候再試的總時間長度，建議設定時取值比實際需要耗費的時間稍微長一些。 消費者長輪詢逾時時間 取值範圍：最小值5秒，最大值20秒。 支援使用者在取值範圍內自訂調整。 設定長輪詢逾時時間後，如果當前服務端無已就緒的訊息，用戶端請求會阻塞直到新訊息到達或者逾時時間到達。 消費者使用長輪詢可以在訊息量少的情況下大幅降低無效的空請求，降低用戶端和服務端的壓力。 訂閱關係 過濾運算式長度限制：4000個字元（包括TAG過濾和SQL過濾）。 訂閱關係的詳細資料，請參見。。
   MessageType	Topic的訊息類型。	取值如下： TRANSACTION：事務訊息 DELAY：定時/延時訊息 FIFO：順序訊息 NORMAL：普通訊息
   Remark	Topic的備忘資訊。	長度限制為1~60字元。

   模板內容樣本如下：

   TopicName	MessageType	Remark
   Topic1	TRANSACTION	用於發送事務訊息
   Topic2	NORMAL	用於發送普通訊息
   Topic3	DELAY	用於發送延時訊息

6. 在彈出的匯入資源清單面板中，選中待匯入的Topic，在其操作列單擊確認並匯入。

   您也可以選中多個Topic，然後單擊大量匯入。

   匯入成功後，Topic列表中執行結果列變為已匯入。

7. 在匯入資源清單面板左下角單擊確定完成匯入。

   匯入完成後，選中的待匯入的Topic會出現在Topic列表中。

相關文檔

• 如果您需要同時跨執行個體同步Group的列表資訊，請參見Group匯入/匯出。

• 如果您需要遷移自建RockketMQ叢集的資料到阿里雲的雲訊息佇列 RocketMQ 版上，請參見自建RocketMQ叢集遷移上雲。