本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業務造成影響,請務必仔細閱讀。
Group表示一類Producer或Consumer,這類Producer或Consumer通常生產或消費同一類消息,且消息發布或訂閱的邏輯一致。使用云消息隊列 RocketMQ 版進行消息收發,您需要創建Group ID用于標識同一類生產者實例或者同一類消費者實例。本文介紹如何在云消息隊列 RocketMQ 版控制臺上創建、刪除和查詢Group。
使用限制
單實例下最多創建1000個Group,建議您盡量復用或及時刪除不需要的Group。若您對Group數量有特殊需求,請聯系云消息隊列 RocketMQ 版技術支持申請。
Group ID不能跨實例使用,例如實例A中創建的Group ID不能在實例B中使用。
云消息隊列 RocketMQ 版支持HTTP協議和TCP協議的Group,不同的消費Group ID可以使用不同類型的協議消費消息,建議您分別為兩種協議創建對應類型的Group ID。
若多個消費者使用同一個Group ID消費消息,其中部分消費者使用TCP協議,部分消費者使用HTTP協議,可能會導致消費失敗、部分消息重復或丟失。
同一Group ID不能平滑地從一個消費協議切換到另一個協議,切換過渡時間大概需要1~2小時。
如果Group ID實際消費使用的協議和控制臺上展示的協議不一致,會導致控制臺上展示的相關數據不準確,但不會影響實際的消息收發。您可以聯系云消息隊列 RocketMQ 版技術支持申請將控制臺上Group ID的協議類型訂正為您實際使用的協議類型。
消費者必須有對應的Group ID,生產者不作強制要求。
Group ID命名規范
Group ID推薦以“GID_”或“GID-”開頭,長度限制為2~64個字符,只能包含英文、數字、短劃線(-)以及下劃線(_)。
如果Group所在實例有命名空間,則Group ID需要保證實例內唯一,不能和本實例下已有的Group ID或Topic名稱重復;跨實例之間可以重名,例如實例A的Group ID可以和實例B的Group ID重復,也可以和實例B的Topic名稱重復。
如果Group所在實例無命名空間,則Group ID需要保證跨實例和跨地域全局唯一,在全局范圍內不能和已有的Group ID或Topic名稱重復。
實例是否有命名空間,可以在云消息隊列 RocketMQ 版控制臺實例詳情頁面的基礎信息區域查看。
創建Group
登錄云消息隊列 RocketMQ 版控制臺,在左側導航欄單擊實例列表。
在頂部菜單欄選擇地域,如華東1(杭州),然后在實例列表中,單擊目標實例名稱。
在左側導航欄,單擊Group 管理。
在Group 管理頁面選擇客戶端SDK的協議,然后單擊創建 Group。
云消息隊列 RocketMQ 版支持的客戶端SDK協議有TCP 協議和HTTP 協議。
在創建Group面板中,輸入該Group的Group ID和描述,然后單擊確定。
刪除Group
刪除Group ID后,由該Group ID標識的消費者實例將立即停止接收消息,Group的相關資源也同時被刪除且不可恢復,請您謹慎執行該操作。
在實例列表頁面單擊目標實例名稱,然后在左側導航欄,單擊Group 管理。
在Group列表中找到您需要刪除的Group,在其操作列單擊更多,然后在彈出的下拉菜單中選擇刪除。
在彈出的對話框中單擊確認。
查詢Group
在實例列表頁面單擊目標實例名稱,然后在左側導航欄,單擊Group 管理。
在Group列表中找到您需要查看的目標Group,單擊Group的ID或在其操作列單擊詳情,進入Group詳情頁面。
更多操作
在Group 管理頁面,您還可以執行其他相關操作。
在左側導航欄,單擊Group 管理。
在Group列表中找到您需要操作的Group,在其操作列單擊更多,然后在彈出的下拉菜單中選擇以下操作:
快速接入:查看云消息隊列 RocketMQ 版提供的多語言SDK參考。
重置消費位點:通過重置消費位點,按需清除堆積的或不想消費的這部分消息再開始消費,或直接跳轉到某個時間點消費該時間點之后的消息(不論是否消費過該時間點之前的消息)。更多信息,請參見重置消費位點。
云監控:查看當前Group下的消息監控數據。
儀表盤:查看當前Group的相關消費指標統計數據。
相關文檔
Group的相關操作也可以通過調用API完成。
創建Group:OnsGroupCreate
刪除Group:OnsGroupDelete
查詢Group列表:OnsGroupList
查詢Group的訂閱關系:OnsGroupSubDetail
配置Group的讀寫權限:OnsGroupConsumerUpdate