全部產品
Search
文件中心

ApsaraMQ for RocketMQ:Group匯入/匯出

更新時間:Dec 27, 2024

雲訊息佇列 RocketMQ 版支援將指定執行個體的Group列表資訊匯出,再匯入至其他的雲訊息佇列 RocketMQ 版執行個體,實現Group的跨執行個體遷移。你可以在更換執行個體或者複製執行個體時,使用Group匯入/匯出功能快速大量建立出相同的Group。

背景資訊

您可以在以下情境使用Group匯入或匯出功能:

  • 更換執行個體

    若當前執行個體不滿足您的要求需要使用新的執行個體,您可以將當前執行個體的Group列表匯出,然後再匯入至新購買的執行個體,可在新的執行個體自動建立出相同的Group。

  • 複製執行個體

    開發、測試、以及生產環境需要使用不同的執行個體進行部署,但業務訪問的Group相同。您可以在其中一個執行個體中建立相關的Group,並匯出Group列表,其他執行個體則可以通過匯入該Group列錶快速建立相同的Group。

注意事項

  • 4.x和5.x系列執行個體的Group中繼資料有所差異,因此:

    • 5.x系列執行個體的Group匯入4.x系列執行個體時:匯入操作可以執行;Group匯入成功後,僅部分中繼資料生效,具體生效欄位,以4.x的Group列表模板為準。

    • 4.x系列執行個體的Group匯入5.x系列執行個體時:匯入操作不可執行,您需要按照5.x執行個體的Group列表模板修改待匯入的Group列表才能成功匯入。

  • Group匯入或匯出操作僅涉及Group資源的基礎資訊,例如,Group ID、消費策略、Group的描述資訊等,不涉及訂閱關係和訊息資料的變更或遷移。

  • 匯入Group時,Group列表必須符合模板要求,具體規範,請參見5.x Group列表模板

Group匯出

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

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

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

  4. Group 管理頁面右上方單擊匯出表徵圖。

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

Group匯入

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

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

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

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

  4. Group 管理頁面右上方單擊匯入表徵圖。

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

    待匯入的Group資源清單的模板規範如下:

    模板參數

    說明

    取值限制

    ConsumerGroupId

    Group ID

    • 字元限制:支援字母a~z或A~Z、數字0~9以及底線(_)和短劃線(-)。

    • 長度限制:1~60個字元。

    Group ID不能使用保留字元或特殊前置詞字元命名,具體限制,請參見參數限制

    DeliveryOrderType

    消費者消費訊息時,雲訊息佇列 RocketMQ 版向消費者用戶端投遞訊息的順序性。

    取值如下:

    • Concurrently:並發投遞

    • Orderly:順序投遞

    更多資訊,請參見消費順序

    ConsumeRetryPolicy

    消費者消費訊息失敗時,系統的重試策略。

    取值如下:

    • FixedRetryPolicy:固定間隔重試

    • DefaultRetryPolicy:階梯退避重試

    更多資訊,請參見消費重試

    MaxRetryTimes

    最大重試次數

    不超過1000次。

    DeadLetterTargetTopic

    死信Topic

    • 死信Topic不能和原訊息發送Topic相同。

    • 若不需要使用死信訊息功能,該參數可以為空白。

    更多資訊,請參見死信訊息

    Remark

    Group的備忘資訊。

    長度限制為1~60字元。

    模板內容樣本如下:

    ConsumerGroupId

    DeliveryOrderType

    ConsumeRetryPolicy

    MaxRetryTimes

    DeadLetterTargetTopic

    Remark

    testgroup1

    Orderly

    FixedRetryPolicy

    16

    用於訂閱賬單訊息

    testgroup2

    Concurrently

    DefaultRetryPolicy

    16

    targettopic1

    用於訂閱物流訊息

  6. 在彈出的导入资源列表面板中,選中待匯入的Group,在其操作列單擊确认并导入

    您也可以選中多個Group,然後單擊批量导入

    匯入成功後,Group列表中执行结果列變為已导入

  7. 导入资源列表面板左下角單擊确定完成匯入。

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

相關文檔