CommandReference

= Redis Command Reference =

Every command name links to a specific wiki page describing the behavior of the command.

Connection handling

• QUIT close the connection
• AUTH simple password authentication if enabled

Commands operating on all the kind of values

• EXISTS key test if a key exists
• DEL key delete a key
• TYPE key return the type of the value stored at key
• KEYS pattern return all the keys matching a given pattern
• RANDOMKEY return a random key from the key space
• RENAME oldname newname rename the old key in the new one, destroing the newname key if it already exists
• RENAMENX oldname newname rename the old key in the new one, if the newname key does not already exist
• DBSIZE return the number of keys in the current db
• EXPIRE set a time to live in seconds on a key
• TTL get the time to live in seconds of a key
• SELECT index Select the DB having the specified index
• MOVE key dbindex Move the key from the currently selected DB to the DB having as index dbindex
• FLUSHDB Remove all the keys of the currently selected DB
• FLUSHALL Remove all the keys from all the databases

Commands operating on string values

• SET key value set a key to a string value
• GET key return the string value of the key
• GETSET key value set a key to a string returning the old value of the key
• MGET key1 key2 ... keyN multi-get, return the strings values of the keys
• SETNX key value set a key to a string value if the key does not exist
• MSET key1 value1 key2 value2 ... keyN valueN set a multiple keys to multiple values in a single atomic operation
• MSETNX key1 value1 key2 value2 ... keyN valueN set a multiple keys to multiple values in a single atomic operation if none of the keys already exist
• INCR key increment the integer value of key
• INCRBY key integer increment the integer value of key by integer
• DECR key decrement the integer value of key
• DECRBY key integer decrement the integer value of key by integer

Commands operating on lists

• RPUSH key value Append an element to the tail of the List value at key
• LPUSH key value Append an element to the head of the List value at key
• LLEN key Return the length of the List value at key
• LRANGE key start end Return a range of elements from the List at key
• LTRIM key start end Trim the list at key to the specified range of elements
• LINDEX key index Return the element at index position from the List at key
• LSET key index value Set a new value as the element at index position of the List at key
• LREM key count value Remove the first-N, last-N, or all the elements matching value from the List at key
• LPOP key Return and remove (atomically) the first element of the List at key
• RPOP key Return and remove (atomically) the last element of the List at key
• RPOPLPUSH srckey dstkey Return and remove (atomically) the last element of the source List stored at _srckey_ and push the same element to the destination List stored at _dstkey_

Commands operating on sets

• SADD key member Add the specified member to the Set value at key
• SREM key member Remove the specified member from the Set value at key
• SPOP key Remove and return (pop) a random element from the Set value at key
• SMOVE srckey dstkey member Move the specified member from one Set to another atomically
• SCARD key Return the number of elements (the cardinality) of the Set at key
• SISMEMBER key member Test if the specified value is a member of the Set at key
• SINTER key1 key2 ... keyN Return the intersection between the Sets stored at key1, key2, ..., keyN
• SINTERSTORE dstkey key1 key2 ... keyN Compute the intersection between the Sets stored at key1, key2, ..., keyN, and store the resulting Set at dstkey
• SUNION key1 key2 ... keyN Return the union between the Sets stored at key1, key2, ..., keyN
• SUNIONSTORE dstkey key1 key2 ... keyN Compute the union between the Sets stored at key1, key2, ..., keyN, and store the resulting Set at dstkey
• SDIFF key1 key2 ... keyN Return the difference between the Set stored at key1 and all the Sets key2, ..., keyN
• SDIFFSTORE dstkey key1 key2 ... keyN Compute the difference between the Set key1 and all the Sets key2, ..., keyN, and store the resulting Set at dstkey
• SMEMBERS key Return all the members of the Set value at key
• SRANDMEMBER key Return a random member of the Set value at key

Commands operating on sorted sets (zsets, Redis version >

1.1) ==

• ZADD key score member Add the specified member to the Sorted Set value at key or update the score if it already exist
• ZREM key member Remove the specified member from the Sorted Set value at key
• ZINCRBY key increment member If the member already exists increment its score by _increment_, otherwise add the member setting _increment_ as score
• ZRANGE key start end Return a range of elements from the sorted set at key
• ZREVRANGE key start end Return a range of elements from the sorted set at key, exactly like ZRANGE, but the sorted set is ordered in traversed in reverse order, from the greatest to the smallest score
• ZRANGEBYSCORE key min max Return all the elements with score >= min and score <= max (a range query) from the sorted set
• ZCARD key Return the cardinality (number of elements) of the sorted set at key
• ZSCORE key element Return the score associated with the specified element of the sorted set at key
• ZREMRANGEBYSCORE key min max Remove all the elements with score >= min and score <= max from the sorted set

Sorting

• SORT key BY pattern LIMIT start end GET pattern ASC|DESC ALPHA Sort a Set or a List accordingly to the specified parameters

Persistence control commands

• SAVE Synchronously save the DB on disk
• BGSAVE Asynchronously save the DB on disk
• LASTSAVE Return the UNIX time stamp of the last successfully saving of the dataset on disk
• SHUTDOWN Synchronously save the DB on disk, then shutdown the server
• BGREWRITEAOF Rewrite the append only file in background when it gets too big

Remote server control commands

• INFO Provide information and statistics about the server
• MONITOR Dump all the received requests in real time
• SLAVEOF Change the replication settings