Redis Command to RESP

Type commands as you would in redis-cli and get the RESP bytes that go on the wire. Useful for writing a client, for building a test fixture, and for working out why a command with quotes is not doing what you expected.

Paste below, or drop a file anywhere on this panel

Or drop a file anywhere on this panel. Nothing is uploaded: the analysis runs in this tab.

The answer appears here

Paste on the left and press Encode. Nothing leaves this tab.

Examples

Real input you can load into the tool above. Each one shows a different thing going wrong, because that is what the tool is for.

Quoted argument

A value containing a space is one argument, and the byte count reflects it

SET greeting "hello world"

Unclosed quote

The quoting mistake behind most wrong number of arguments errors

SET greeting "hello world

Common mistakes

These are the ones that fail silently. The config is accepted, nothing raises an error, and the consequence arrives later.

  1. Leaving a value with spaces unquoted

    `SET k hello world` is four arguments and an error. redis-cli splits on whitespace outside quotes, which is where wrong number of arguments comes from.

    Instead:Quote it: `SET k "hello world"`.

  2. Using the inline command form in a client

    It cannot carry a value containing a space, a newline or a null byte, and it cannot express an empty argument. It exists for telnet, not for clients.

    Instead:Send the array-of-bulk-strings form, which has none of those limits.

A client always sends an array of bulk strings

Whatever the reply will look like, the request is uniform: an array whose elements are the command name and its arguments, each as a length-prefixed bulk string. There is no separate syntax for different commands.

Why not the inline form

Redis does accept a plain whitespace-delimited line, which is how you can talk to it over telnet. No client uses it, because an inline command cannot carry a value containing a space, a newline or a null byte, and it has no way to express an empty argument. The array form has none of those limits.

Quoting decides the argument count

SET k hello world is four arguments and an error; SET k "hello world" is three and works. redis-cli splits on whitespace outside quotes, honours single and double quotes, and processes backslash escapes inside double quotes only. Getting this wrong is the usual cause of a wrong number of arguments error.

The byte count is the cost

Every command carries roughly fourteen bytes of framing plus the length prefix of each argument. For large values that is noise, but for a pipeline of small commands it is most of the traffic, which is the real argument for MSET over repeated SET and for pipelining over round trips.

Command names are case insensitive, keys are not

set and SET are the same command. mykey and MyKey are two different keys. This bites hardest when a config file or an environment variable changes case somewhere in a deployment pipeline.

What this cannot see

It does not validate the command. An unknown command, a wrong argument count for a real command, or a key of the wrong type all encode perfectly here and fail at the server. It also does not know your server version, so it cannot say whether a command exists yet.

More redis tools

Redis Hash Slot Calculator Which of the 16,384 slots does this key land in? Redis Hash Tag Tester Will these keys survive a multi-key command? Redis RESP Protocol Decoder Read what the server actually sent Redis RESP2 vs RESP3 Reply Decoder What the same reply looks like on each protocol Redis Glob Pattern Tester Redis globs are not shell globs Redis Connection URL Parser The path is the database number Redis Memory Unit Converter 1g and 1gb are not the same number Redis TTL Converter -1 and -2 are not durations Redis Stream ID Parser The first half is a millisecond timestamp redis.conf Validator Will Redis start with this file? Redis Production Config Linter The settings that cause incidents redis.conf to CONFIG SET Which of these can you change without a restart? Redis ACL Rule Decoder What does this user actually get? Redis ACL Validator Find the rule that does nothing Redis INFO Analyzer The numbers INFO does not print Redis SLOWLOG Analyzer What blocked everyone else Redis CLUSTER NODES Parser Read the topology, and find the gap Redis Cluster Slot Distribution Who owns how much, and what is missing Redis Keyspace Notification Flags Why your events never arrive Redis Memory Calculator The encoding decides, not the data Redis Key Count to Memory The fixed cost per key Redis Encoding Threshold Calculator One field more, several times the memory Redis Bitmap Memory Calculator Sized by the highest bit, not the set ones Redis HyperLogLog Calculator 12 KB whether you count a thousand or a billion Redis Cluster Sizing Only 60% of each node is usable Redis RDB and AOF Size Calculator The fork needs memory, not disk Redis Replication Bandwidth Calculator How long the backlog actually covers Redis Connection Pool Calculator More connections is not more throughput Redis Pipeline Calculator It removes round trips, not work Redis Cache Hit Rate Calculator 99% to 90% is ten times the backend load Redis Eviction Policy Simulator volatile- with no TTLs is noeviction Redis Cost Estimator Your rates, so nothing goes stale Redis Config File Generator A redis.conf with the reasons in it Redis ACL Generator A user that can do exactly one job Redis Maxmemory Config Generator The limit, and the headroom it needs Redis Persistence Config Generator How much you can afford to lose Redis Lua Script Generator Atomic, and short enough to stay that way Redis TLS Config Generator Encrypted, and the old port actually closed Redis Sentinel Config Generator Failover that can actually be authorised Redis Cluster Config Generator Three primaries, and the bus port open Redis Docker Compose Generator Local Redis that is not on the internet Redis Client Config Generator Timeouts on both sides, and a sane pool Redis MEMORY STATS Analyzer Which number actually matters Redis Bigkeys Output Analyzer Elements are not bytes Redis CLIENT LIST Analyzer Find the connection hurting you Redis LATENCY Report Analyzer An empty report may mean nothing was recorded Redis Keyspace Prefix Analyzer Which key family is growing Redis SET Command Builder A plain SET clears the TTL Redis ZRANGE Query Builder REV reverses the argument order Redis SCAN Iteration Planner COUNT is a hint, not a page size Redis Key Name Validator Legal is not the same as workable Redis Cluster Compatibility Checker Works now, breaks when you shard

Elsewhere on the site