XGROUP-DELCONSUMER(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 XGROUP-DELCONSUMER 💖

okay bestie, this one lives in the Valkey Command Manual and it's literally called xgroup-delconsumer — aka deletes a consumer from a consumer group. yes, we're doing spring cleaning on your streams. let's go 🧹✨

✨ SYNOPSIS ✨

XGROUP DELCONSUMER key group consumer

three little words and a whole consumer is gone. iconic. 💅

🌸 DESCRIPTION 🌸

so the XGROUP DELCONSUMER command deletes a consumer from the consumer group. that's it. that's the whole gig. 🎀

sometimes it's genuinely useful to yeet old consumers, because bestie, they are simply no longer used. dead weight. ghost members. we don't need them in the group chat. 🙈

⚠️ BUT WAIT. listen to me. not me being dramatic, this is real: any pending messages that the consumer had will become unclaimable after it was deleted. gone. poof. unclaimable forever. 😭
💀 so it is strongly recommended that any pending messages are claimed or acknowledged prior to deleting the consumer from the group. do the homework first, then delete. periodt. 🫶

💌 REPLY 💌

valkey-protocol(7) Integer reply: the number of pending messages the consumer had before it was deleted. so it does tell you how much you're about to orphan. a little goodbye receipt. 📜💖

🦋 COMPLEXITY 🦋

O(1)

constant time. fast. no thoughts, just vibes. ⚡

👑 ACL CATEGORIES 👑

  • @slow
  • @stream
  • @write

🌈 HISTORY 🌈

  • Available since: 5.0.0

🎀 SEE ALSO 🎀

okay that's the whole page bestie, go forth and clean up your consumer groups responsibly 💖

signed, sealed, delivered from the Valkey Command Manual, version 9.0.0, dated 2025-10-21. mwah. 💅✨🦋

📦 where this page comes from