Skip to main content

Command: EScan By Prefix

Scans ephemeral storage across the cluster and returns key/value pairs whose keys start with the specified prefix.

eset `cache/product/1` "ready"
r0 set 4ms

eset `cache/product/2` "ready"
r0 set 5ms

escan by prefix `cache/product`
r0 cache/product/1 ready
r0 cache/product/2 ready

Assigning Results​

Inside a script, assign the command to a variable with let. The variable receives an array of the returned values.

let products = escan by prefix `cache/product`
return count(products)

EScan By Prefix As Of Timestamp​

escan by prefix also supports snapshot reads:

escan by prefix `cache/product` as of 1718392012345

This returns only the ephemeral keys that were visible under that prefix at the requested snapshot time.

If a key already existed at that time and was updated later, the snapshot still returns the older visible value from the requested time. Keys created after that time are not returned.

Notes​

escan by prefix reads from ephemeral storage and scans across the cluster. Ephemeral keys can expire or be evicted under memory pressure, and a cluster-wide scan can be expensive. Prefer eget by bucket when keys share a bucket and a partition-local read is enough.

The command returns the matching set in one response and is capped at 4096 entries. Use paginated range reads from the .NET client for large or unbounded ordered scans.