Returns the internal encoding of an object.
OBJECT
ENCODING
key
Returns the internal encoding for the Valkey object stored at
<key>
Valkey objects can be encoded in different ways:
Strings can be encoded as:
raw
, normal string encoding.int
, strings representing integers in a 64-bit signed
interval, encoded in this way to save space.embstr
, an embedded string, which is an object where
the internal simple dynamic string, sds
, is an unmodifiable
string allocated in the same chuck as the object itself.
embstr
can be strings with lengths up to the hardcoded
limit of OBJ_ENCODING_EMBSTR_SIZE_LIMIT
or 44 bytes.Lists can be encoded as:
linkedlist
, simple list encoding. No longer used, an
old list encoding.listpack
, a space-efficient encoding used for small
lists.quicklist
, encoded as linked list of ziplists or
listpacks.Sets can be encoded as:
hashtable
, normal set encoding.intset
, a special encoding used for small sets composed
solely of integers.listpack
, a space-efficient encoding used for small
sets.Hashes can be encoded as:
zipmap
, no longer used, an old hash encoding.hashtable
, normal hash encoding.listpack
, a space-efficient encoding used for small
hashes.Sorted Sets can be encoded as:
skiplist
, normal sorted set encoding.listpack
, a space-efficient encoding used for small
sorted sets.Streams can be encoded as:
stream
, encoded as a radix tree of listpacks.All the specially encoded types are automatically converted to the general type once you perform an operation that makes it impossible for Valkey to retain the space saving encoding.
One of the following:
Nil reply: if the key doesn’t exist.
Bulk string reply: the encoding of the object.
One of the following:
Null reply: if the key doesn’t exist.
Bulk string reply: the encoding of the object.
O(1)
@keyspace @read @slow
COPY, DEL, DUMP, EXISTS, EXPIRE, EXPIREAT, EXPIRETIME, KEYS, MIGRATE, MOVE, OBJECT, OBJECT FREQ, OBJECT HELP, OBJECT IDLETIME, OBJECT REFCOUNT, PERSIST, PEXPIRE, PEXPIREAT, PEXPIRETIME, PTTL, RANDOMKEY, RENAME, RENAMENX, RESTORE, SCAN, SORT, SORT_RO, TOUCH, TTL, TYPE, UNLINK, WAIT, WAITAOF.