Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

NCACHE.LIST

Last updated 
NCACHE.LIST
Group
Keyed caches
Complexity
O(N) where N is the number of namespaces
Arity
1 (exactly, counting the command name)
Flags
read-only, fast
HotKV Cloud
Performance and Scale
On-Premise
requires the negative-cache license feature

The negative cache holds negative results, such as “user not found” or “refused by moderation”, usually with a short TTL, so repeated lookups for the same missing or refused item do not reach your backend or model again. NCACHE.LIST returns the names of all namespaces on the server you are connected to, in no particular order. In a cluster, each node lists only the namespaces it holds.

Return value

Section titled “Return value”
Case RESP2 RESP3
Always Array of bulk strings (empty if there are none) Same

Errors:

  • ERR wrong number of arguments for 'ncache.list' command if the argument count is wrong.
  • NOLICENSE negative-cache requires a HotKV license. Contact sales@hotkv.com if your license does not include the negative-cache feature.

Examples

Section titled “Examples”
127.0.0.1:6379> NCACHE.LIST
1) "lookups"

Compatibility

Section titled “Compatibility”

HotKV-only command. Redis and Valkey have no equivalent.

See also

Section titled “See also”

NCACHE.CREATE, NCACHE.SET, NCACHE.GET, NCACHE.DEL, NCACHE.STATS, NCACHE.FLUSH, NCACHE.DROP, AI features guide