全部產品
Search
文件中心

ApsaraMQ for RocketMQ:Topic管理

更新時間:Mar 29, 2025

Topic是雲訊息佇列 RocketMQ 版裡對訊息的一級歸類。雲訊息佇列 RocketMQ 版支援發布和訂閱模型,通過Topic完成訊息的發布和訂閱。訊息生產者將訊息發送到Topic中,而訊息消費者則通過訂閱該Topic來消費訊息。本文介紹如何在雲訊息佇列 RocketMQ 版控制台上建立、刪除、更新和查詢Topic。

注意事項

  • Topic不能跨執行個體使用,例如在執行個體A中建立的Topic A不能在執行個體B中使用。

  • Topic類型和訊息類型必須一致不能混用。例如,您需要建立一個Topic用於收發普通訊息,則該Topic的訊息類型必須為普通訊息類型,不能選擇順序訊息、事務訊息等,否則會導致營運事件(如節點更換,執行個體遷移時定時訊息丟失)。

計費說明

雲訊息佇列 RocketMQ 版會對已建立的每一個Topic收取Topic資源佔用費,即使Topic未使用也會產生費用,建議您及時刪除不需要使用的Topic。更多計費資訊,請參見訊息收發定價詳情企業鉑金版計費說明

Topic命名規範

  • Topic名稱長度限制為3~64個字元,只能包含英文、數字、短劃線(-)以及底線(_)。

  • 如果Topic所在的執行個體有命名空間,則Topic的名稱需要保證執行個體內唯一,不能和本執行個體下已有的Topic名稱或Group ID重複;跨執行個體之間可以重名,例如執行個體A的Topic名稱可以和執行個體B的Topic名稱重複,也可以和執行個體B的Group ID重複。

  • 如果Topic所在的執行個體無命名空間,則Topic的名稱需要保證跨執行個體和跨地區全域唯一,在全域範圍內不能和已有的Topic名稱或Group ID重複。

說明

執行個體是否有命名空間,可以在雲訊息佇列 RocketMQ 版控制台实例详情頁面的基础信息地區查看。

建立Topic

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

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

  3. 在左側導覽列,單擊Topic 管理,然後在頁面左上方單擊創建 Topic

  4. 创建 Topic面板中,輸入該Topic的名稱描述,選擇該Topic的訊息類型,然後單擊確定

    重要

    Topic的訊息類型不能混用,例如您建立的Topic的訊息類型為普通訊息,則該Topic只能收發普通訊息,不能用來收發順序訊息。更多資訊,請參見訊息類型列表

    建立Topic

刪除Topic

警告

Topic刪除後,相關的生產者、消費者將會立即停止服務,Topic中繼資料和Topic的訊息資料也會被同時刪除且不可恢複,請您謹慎執行該操作。

  1. 執行個體列表頁面單擊目標執行個體名稱,然後在左側導覽列,單擊Topic 管理

  2. 在Topic列表中找到您需要刪除的Topic,在其操作列單擊更多,然後在彈出的下拉式功能表中選擇删除

  3. 在彈出的對話方塊中單擊確認

更新Topic

  1. 執行個體列表頁面單擊目標執行個體名稱,然後在左側導覽列,單擊Topic 管理

  2. 在Topic列表中找到您需要更新的Topic,在其操作列單擊详情,進入Topic 详情頁面。

  3. 基础信息地區中,單擊Topic 描述後的编辑,在文字框中輸入修改後的Topic描述,並單擊确定完成修改。更新Topic

查詢Topic

  1. 執行個體列表頁面單擊目標執行個體名稱,然後在左側導覽列,單擊Topic 管理

  2. 在Topic列表中單擊您需要查詢的Topic的名稱或在其操作列單擊详情

相關文檔

Topic的相關操作也可以通過調用API完成: