CLUSTER...YSINSLOT(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 CLUSTER GETKEYSINSLOT 💖

okay bestie, so this one's from the Valkey Command Manual (the 3valkey section, iykyk) and it's genuinely one of those lowkey-underrated cluster commands. Let me put you on. ✨

🌸 NAME 🌸

cluster-getkeysinslot — returns the key names in a hash slot. that's it, that's the whole job. simple, effective, iconic. 💅

✨ SYNOPSIS ✨

CLUSTER GETKEYSINSLOT slot count

two args, no drama. we love a low-maintenance queen. 👑

🦋 DESCRIPTION 🦋

so what this does is it hands you back an array of key names — and these are keys stored on the node you contacted, the ones that hash to the hash slot you specified, in the currently selected database. 🌈

the max number of keys you get back is whatever you pass as count, which is the whole point — it means you, the user of this API, can batch-process keys like a boss instead of yanking the entire slot at once. very demure, very mindful. 🎀

⚠️ BUT. listen. this only actually works when you're deleting keys, because the same count keys get returned on every single call unless you remove them. so if you're just sitting there calling it over and over and not deleting anything? you're gonna get the same lil guys back every time. no cap. 😭

the main usage of this command is during rehashing of cluster slots from one node to another. the way that rehashing is performed is exposed in the Valkey Cluster specification, or, in a more simple to digest form, as an appendix of the valkey-cluster-setslot(7) CLUSTER SETSLOT command documentation. 📚

like, look at her go:

> CLUSTER GETKEYSINSLOT 7000 3
1) "key_39015"
2) "key_89793"
3) "key_92937"

three keys, one slot, zero stress. she ate. 🔥

💌 REPLY 💌

valkey-protocol(7) Array reply: an array with up to count elements. (note the up to — don't come for her if you get fewer. 🙈)

⚡ COMPLEXITY ⚡

O(N) where N is the number of requested keys. so like, the more you ask for, the more work it is. math is mathing. 💀

🔐 ACL CATEGORIES 🔐

  • @slow

she's in the slow girlies category. she takes her time. respect it. 🐌✨

📜 HISTORY 📜

  • Available since: 3.0.0 — a true veteran, been serving looks since day one. 👑

👀 SEE ALSO 👀

the whole friend group, fr fr:

okay that's the whole page, bestie!! go forth and migrate your slots responsibly 💖

this has been version 9.0.0, dated 2025-10-21. mwah, love u, bye!! 🫶🌸

📦 where this page comes from