close icon
Redis

Introduction to Redis: Installation, CLI Commands, and Data Types

In this Redis tutorial, learn how to install and setup Redis as well as commands to write, read, update, and delete data from the store using its core data structures.

August 08, 2018

What's Redis?

Redis is an in-memory key-value store that can be used as a database, cache, and message broker. The project is open source and it's currently licensed under the BSD license.

Fun Fact: Redis means "REmote DIctionary Server."

Redis delivers sub-millisecond response times that enable millions of requests per second to power demanding real-time applications such as games, ad brokers, financial dashboards, and many more!

It supports basic data structures such as strings, lists, sets, sorted sets with range queries, and hashes. More advanced data structures like bitmaps, hyperloglogs, and geospatial indexes with radius queries are also supported.

Alex Stanciu, a Product Owner from the Identity Governance Team at Auth0, explains one of our use cases for Redis:

"We use Redis as a caching layer and a session store for our Slack Bot conversation engine. Because it stores data in memory (RAM), it provides ultra-fast read and write speeds; responses are usually in the single-digit milliseconds."

In this Redis tutorial, we'll learn how to set up Redis in our systems and how to store data in Redis using its core and most frequently used data structures. With this foundation, in future posts we'll learn how to use Redis for caching, session storage, messaging, and real-time analytics. Let's get started!

Installing Redis

The first thing that we need to do is install Redis. If you have it already running in your system, feel free to skip this part of the post.

The Redis documentation recommends installing Redis by compiling it from sources as Redis has no dependencies other than a working GCC compiler and libc. We can either download the latest Redis tarball from redis.io, or we can use a special URL that always points to the latest stable Redis version: http://download.redis.io/redis-stable.tar.gz.

Windows users: The Redis project does not officially support Windows. But, if you are running Windows 10, you can Install the Windows Subsystem for Linux to install and run Redis. When you have the Windows Subsystem for Linux up and running, please follow any steps in this post that apply to Linux (when specified) from within your Linux shell.

To compile Redis follow these simple steps:

  • Create a redis directory and make it the current working directory:

macOS/Linux:

mkdir redis && cd redis
  • Fetch the latest redis tarball:

macOS/Linux:

curl -O http://download.redis.io/redis-stable.tar.gz
  • Unpack the tarball:

macOS/Linux:

tar xvzf redis-stable.tar.gz
  • Make the unpacked redis-stable directory the current working directory:

macOS/Linux:

cd redis-stable
  • Compile Redis:

macOS/Linux:

make

If the make package is not installed in your system, please follow the instructions provided by the CLI to install it. In macOS, you may need to download XCode to have access to the command line tools which include make and a C compiler. For a fresh installation of Ubuntu, for example, you may want to run the following commands to update the package manager and install core packages:

Ubuntu:

sudo apt update
sudo apt upgrade
sudo apt install build-essential
sudo apt-get install tcl8.5
make

tcl 8.5 or newer is needed to run the Redis test in the next step.

  • Test that the build works correctly:

macOS/Linux:

make test

Once the compilation is done, the src directory within redis-stable is populated with different executables that are part of Redis. The Redis docs explain the functionality of each Redis exectuble:

  • redis-server: runs the Redis Server itself.
  • redis-sentinel: runs Redis Sentinel, a tool for monitoring and failover.
  • redis-cli: runs a command line interface utility to interact with Redis.
  • redis-benchmark: checks Redis performance.
  • redis-check-aof and redis-check-dump: used for the rare cases when there are corrupted data files.

We are going to be using the redis-server and redis-cli executable frequently. For convenience, let's copy both to a location that will let us access them system-wide. This can be done manually by running:

macOS/Linux:

sudo cp src/redis-server /usr/local/bin/
sudo cp src/redis-cli /usr/local/bin/

While having redis-stable as the current working directory, this can also be done automatically by running the following command:

macOS/Linux:

 sudo make install

We need to restart our shell for these changes to take effect. Once we do that, we are ready to start running Redis.

Running Redis

Starting Redis

The easiest way to start the Redis server is by running the redis-server command. In a fresh shell window, type:

redis-server

If everything is working as expected, the shell will receive as outline a giant ASCII Redis logo that shows the Redis version installed, the running mode, the port where the server is running and it's PID (process identification number).

                _._
           _.-``__ ''-._
      _.-``    `.  `_.  ''-._           Redis 4.0.10 (00000000/0) 64 bit
  .-`` .-```.  ```\/    _.,_ ''-._
 (    '      ,       .-`  | `,    )     Running in standalone mode
 |`-._`-...-` __...-.``-._|'` _.-'|     Port: 6379
 |    `-._   `._    /     _.-'    |     PID: 22394
  `-._    `-._  `-./  _.-'    _.-'
 |`-._`-._    `-.__.-'    _.-'_.-'|
 |    `-._`-._        _.-'_.-'    |           http://redis.io
  `-._    `-._`-.__.-'_.-'    _.-'
 |`-._`-._    `-.__.-'    _.-'_.-'|
 |    `-._`-._        _.-'_.-'    |
  `-._    `-._`-.__.-'_.-'    _.-'
      `-._    `-.__.-'    _.-'
          `-._        _.-'
              `-.__.-'

We started Redis without any explicit configuration file; therefore, we'll be using the internal default configuration. This is acceptable for the scope of this blog post: understanding and using the basic Redis data structures.

As a first step, we always need to get the Redis server running as the CLI and other services depend on it to work.

How to Check if Redis is Working

As noted in the Redis docs, external programs talk to Redis using a TCP socket and a Redis specific protocol. The Redis protocol is implemented by Redis client libraries written in many programming languages, like JavaScript. But we don't need to use a client library directly to interact with Redis. We can use the redis-cli to send a command to it directly. To test that Redis is working properly, let's send it the ping command. Open a new shell window and execute the following command:

redis-cli ping

If everything is working well, we should get PONG as a reply in the shell.

When we issued redis-cli ping, we invoked the redis-cli executable followed by a command name, ping. A command name and its arguments are sent to the Redis instance running on localhost:6379 for it to be processed and send a reply.

The host and port of the instance can be changed. Use the --help option to check all the commands that can be used with redis-cli:

redis-cli --help

If we run redis-cli without any arguments, the program will start in interactive mode. Similar to the Read–Eval–Print Loop (REPL) of programming languages like Python, we can type different Redis commands in the shell and get a reply from the Redis instance. What those commands are and what they do is the core learning objective of this post!

Let start first by learning how to manipulate data in Redis using commands!

"Redis is a key-value store that let us store some data, the value, inside a key. It offers ultra-fast performance to satisfy demanding real-time applications like video games 🎮."

Tweet

Tweet This

Write, Read, Update, and Delete Data in Redis

As we learned earlier, Redis is a key-value store that let us associate some data called a value with a key. We can later retrieve the stored data if we know the exact key that was used to store it.

In case that you haven't done so already, run the Redis CLI in interactive mode by executing the following command:

redis-cli

We'll know the interactive CLI is working when we see the Redis instance host and port in the shell prompt:

127.0.0.1:6379>

Once there, we are ready to issue commands.

Writing Data

To store a value in Redis, we can use the SET command which has the following signature:

SET key value

In English, it reads like "set key to hold value." It's important to note that if the key already holds a value, SET will overwrite it no matter what.

Let's look at an example. In the interactive shell type:

SET service "auth0"

Notice how, as you type, the interactive shell suggests the required and optional arguments for the Redis command.

Redis CLI showing syntax suggestions

Press enter to send the command. Once Redis stores "auth0" as the value of service, it replies with OK, letting us know that everything went well. Thank you, Redis!

Reading Data

We can use the GET command to ask Redis for the value of a key:

GET key

Let's retrieve the value of service:

GET service

Redis replies with "auth0".

What if we ask for the value of a key that has never been set?

GET users

Redis replies with (nil) to let us know that the key doesn't exist in memory.

In a classic API that connects to a database, we'd like to perform CRUD operations: create, read, update, and delete. We have covered how to create (write) and read data in Redis by using the SET and GET commands respectively. Let's cover the rest.

Updating Data

We can update the value of a key simply by overwriting its data as mentioned earlier.

Lets create a new key-value pair:

SET framework angular

But, we change our mind and now we want the value to be "react". We can overwrite it like this:

SET framework react

Did Redis get it right? Let's ask for it!

GET framework

Redis indeed replies with "react". We are being a bit indecisive and now we want to set the framework key to hold the value of "vue":

SET framework vue

If we run GET framework again, we get "vue". The update/overwrite works as excepted.

Deleting Data

But, we don't want to actually set any framework for now and we need to delete that key. How do we do it? We use the DEL command:

DEL key

Let's run it:

DEL framework

Redis replies with (integer) 1 to let us know the number of keys that were removed.

With just three commands, SET, GET, and DEL, we are able to comply with the four CRUD operations!

Wrapping Strings with Quotation Marks

Notice something curious: we did not have to put quotation marks around a single string value we wanted to store. SET framework angular and SET framework "angular" are both accepted by Redis as an operation to store the string "angular" as the value of the key framework.

Redis automatically wraps single string arguments in quotation marks. Since both key and value are strings, the same applies for the key name. We could have used SET "framework" angular and it would have worked as well. However, if we plan to use more than one string as the key or value, we do need to wrap the strings in quotation marks:

SET "the frameworks" "angular vue react"

Replies with OK.

SET the frameworks "angular vue react"

Replies with (error) ERR syntax error

SET "the frameworks" angular vue react

Also replies with (error) ERR syntax error

Finally, to retrieve the value, we must use the exact key string:

GET "the frameworks"

Replies with "angular vue react".

Non-Destructive Write

Redis is compassionate and lets us write data with care. Imagine that we wanted to create a services key to hold the value "heroku aws" but instead of typing SET services "heroku aws", we typed SET service "heroku aws". This last command would overwrite the current value of service without mercy. However, Redis gives us a non-destructive version of SET called SETNX:

SETNX key value

SETNX creates a key in memory if and only if the key does not exist already (SET if Not eXists). If the key already exists, Redis replies with 0 to indicate a failure to store the key-value pair and with 1 to indicate success. Let's try out this previous scenario but using SETNX instead of SET:

SETNX service "heroku aws"

The reply is (integer) 0 as we expected.

SETNX services "heroku aws"

This time, the reply is (integer) 1. Great!

We can use SETNX to prevent us from mutating data accidentally.

Expiring Keys

When creating a key with Redis, we can specify how long that key should stay stored in memory. Using the EXPIRE command, we can set a timeout on a key and have the key be automatically deleted once the timeout expires:

EXPIRE key seconds

Let's create a notification key that we want to delete after 30 seconds:

SET notification "Anomaly detected"
EXPIRE notification 30

This schedules the notification key to be deleted in 30 seconds. We could look at a clock and check after 30 seconds have elapsed if notification is still available but we don't have to do that! Redis offers the TTL command that tells us how many seconds a key has left before it expires and gets deleted:

TTL key

It's possible that more than 30 seconds have already passed so let's try the above example again, but this time calling TTL as soon as we execute EXPIRE:

SET notification "Anomaly detected"
EXPIRE notification 30
TTL notification

Redis replied with (integer) 27 to me, indicating that notification is still available for 27 more seconds. Let's wait a bit and run TTL again:

TTL notification

This time, Redis replied with (integer) -2. Starting with Redis 2.8, TTL returns:

  • The timeout left in seconds.
  • -2 if the key doesn't exist (either it has not been created or it was deleted).
  • -1 if the key exists but has no expiry set.

I made sure that 30 seconds had passed so -2 was expected. Let's see the error message when the key exists but has no expiry set:

SET dialog "Continue?"
TTL dialog

As expected, with no expiry set, Redis replies with (integer) -1.

It's important to note that we can reset the timeout by using SET with the key again:

SET notification "Anomaly detected"
EXPIRE notification 30
TTL notification
// (integer) 27
SET notification "No anomaly detected"
TTL notification
// (integer) -1

We learned earlier that using SET is the same as creating the key again, which for Redis also involves resetting any timeouts currently assigned to it.

We have a solid foundation now on manipulating data in Redis. With this knowledge under our belt, we are ready to now explore the data types that Redis offers.

Redis Data Types

Far from being a plain key-value store, Redis is an actual data structure server that supports different kinds of values. Traditionally, key-value stores allow us to map a string key to a string value and nothing else. In Redis, the string key can be mapped to more than just a simple string.

Being a data structure server, we can also refer to the data types as data structures. We can use these more complex data structures to store multiple values in a key at once. Let's look at these types at a high level. We'll explore each type in detail in subsequent sections.

  • Binary-safe Strings

The most basic kind of Redis value. Being "binary-safe" means that the string can contain any type of data represented as a string: PNG images or serialized objects, for example.

  • Lists

In essence, Redis Lists are linked lists. They are collections of string elements that are sorted based on the order that they were inserted.

  • Sets

They represent collections of unique and unsorted string elements.

  • Sorted Sets

Like Sets, they represent a collection of unique string elements; however, each string element is linked to a floating number value, referred to as the element score. When querying the Sorted Set, the elements are always taken sorted by their score, which enables us to consistently present a range of data from the Set.

  • Hashes

These are maps made up of string fields linked to string values.

  • Bit arrays

Also known as bitmaps. They let us handle string values as if they were an array of bits.

  • HyperLogLogs

A probabilistic data structure used to estimate the cardinality of a set, which is a measure of the "number of elements of the set."


We have already covered Strings during the "Write, Read, Update, and Delete Data in Redis" section. For the rest of this tutorial, we are going to focus on all the Redis types except bitmaps and hyperloglogs. We'll visit those on a future post handling an advanced Redis use case.

Lists

A List is a sequence of ordered elements. For example, 1 2 4 5 6 90 19 3 is a List of numbers. In Redis, it's important to note that Lists are implemented as linked lists. This has some important implications regarding performance. It is fast to add elements to the head and tail of the List but it's slower to search for elements within the List as we do not have indexed access to the elements (like we do in an array).

A List is created by using a Redis command that pushes data followed by a key name. There are two commands that we can use: RPUSH and LPUSH. If the key doesn't exist, these commands will return a new List with the passed arguments as elements. If the key already exists or it is not a List, an error is returned.

RPUSH

RPUSH inserts a new element at the end of the List (at the tail):

RPUSH key value [value ...]

Let's create an engineers key that represents a List:

RPUSH engineers "Alice"
// 1
RPUSH engineers "Bob"
// 2
RPUSH engineers "Carmen"
// 3

Each time we insert an element, Redis replies with the length of the List after that insertion. We would expect the users list to resemble this:

Alice Bob Carmen

How can we verify that? We can use the LRANGE command.

LRANGE

LRANGE returns a subset of the List based on a specified start and stop index. Although these indexes are zero-based, they are no the same as array indexes. Given a full List, they simply indicate where to partition the List: make a slice from here (start) to here (stop):

LRANGE key start stop

To see the full List, we can use a neat trick: go from 0 to the element just before it, -1.

LRANGE engineers 0 -1

Redis returns:

1) "Alice"
2) "Bob"
3) "Carmen"

The index -1 will always represent the last element in the List.

To get the first two elements of engineers we can issue the following command:

LRANGE engineers 0 1

LPUSH

LPUSH behaves the same as RPUSH except that it inserts the element at the front of the List (at the header):

LPUSH key value [value ...]

Let's insert Daniel at the front of the engineers list:

LPUSH engineers "Daniel"
// 4

We now have four engineers. Let's verify that the order is correct:

LRANGE engineers 0 -1

Redis replies with:

1) "Daniel"
2) "Alice"
3) "Bob"
4) "Carmen"

It's the same List we had before but with "Daniel" as the first element, which is exactly what was expected.

Multiple Element Insertions

We saw in the signatures of RPUSH and LPUSH that we can insert more than one element through each command. Let's see that in action.

Based on our existing engineers list, let's issue this command:

RPUSH engineers "Eve" "Francis" "Gary"
// 7

Since we are inserting them at the end of the List, we expect these three new elements to show up in the same order in which they are listed as arguments. Let's verify:

LRANGE engineers 0 -1

To what Redis returns:

1) "Daniel"
2) "Alice"
3) "Bob"
4) "Carmen"
5) "Eve"
6) "Francis"
7) "Gary"

What about if we do the same with LPUSH:

LPUSH engineers "Hugo" "Ivan" "Jess"
// 10

Will Redis insert these three new elements one by one or will it insert them as a bundle, all three at once?

Let's see:

LRANGE 0 -1

Reply:

 1) "Jess"
 2) "Ivan"
 3) "Hugo"
 4) "Daniel"
 5) "Alice"
 6) "Bob"
 7) "Carmen"
 8) "Eve"
 9) "Francis"
10) "Gary"

When listing multiple arguments for LPUSH and RPUSH, Redis inserts the elements one by one, thus, "Hugo", "Ivan", and "Jess" appear in the reverse order from which they were listed as arguments.

LLEN

We can find the length of a List at any time by using the LLEN command:

LLEN key

Let's verify that the length of engineers is indeed 10:

LLEN engineers

Redis replies with (integer) 10. Perfect.

Removing Elements from a Redis List

Similar to how we can "pop" elements in arrays, we can pop an element from the head or the tail of a Redis List.

LPOP removes and returns the first element of the List:

LPOP key

We can use it to remove "Jess", the first element, from the List:

LPOP engineers

Redis indeed replies with "Jess" to indicate it is the element that was removed.

RPOP removes and returns the last element of the List:

RPOP key

It's time to say goodbye to "Gary", the last element of the List:

RPOP engineers

The reply from Redis is "Gary".

It's very useful to be able to get the element that was removed from the List as we may want to do something special with it.

Redis Lists are implemented as linked lists because its engineering team envisioned that for a database system it is crucial to be able to add elements to a very long list in a very fast way.

Sets

In Redis, a Set is similar to a List except that it doesn't keep any specific order for its elements and each element must be unique.

SADD

We create a Set by using the SADD command that adds the specified members to the key:

SADD key member [member ...]

Specified members that are already part of the Set are ignored. If the key doesn't exist, a new Set is created and the unique specified members are added. If the key already exists or it is not a Set, an error is returned.

Let's create a languages set:

SADD languages "english"
// 1
SADD languages "spanish"
// 1
SADD languages "french"
// 1

In this case, on each member addition Redis returns the number of members that were added with the SADD command, not the size of the Set. Let's see this in action:

SADD languages "chinese" "japanese" "german"
// 3
SADD languages "english"
// 0

The first command returned 3 as we were adding three unique members to the Set. The second command returned 0 as "english" was already a member of the Set.

SREM

We can remove members from a Set by using the SREM command:

SREM key member [member ...]

We can remove one or more members at the same time:

SREM languages "english" "french"
// 2
SREM languages "german"
// 0

SREM returns the number of members that were removed.

SISMEMBER

To verify that a member is part of a Set, we can use the SISMEMBER command:

SISMEMBER key member

If the member is part of the Set, this command returns 1; otherwise, it returns 0:

SISMEMBER languages "spanish"
// 1
SISMEMBER languages "german"
// 0

Since we removed "german" in the last section, we get 0.

SMEMBERS

To show all the members that exist in a Set, we can use the SMEMBERS command:

SMEMBERS key

Let's see what language values we currently have in the languages set:

SMEMBERS languages

Redis returns:

1) "chinese"
2) "japanese"
3) "spanish"

As Sets are not ordered, Redis is free to return the elements in any order at every call. They have no guarantees about element ordering.

SUNION

Something really powerful that we can do with Sets very fast is to combine them using the SUNION command:

SUNION key [key ...]

Each argument to SUNION represents a Set that we can merge into a larger Set. It is important to notice that any overlapping members will be listed once.

To see this in action, let's first create an ancient-languages set:

SADD ancient-languages "greek"
SADD ancient-languages "latin"
SMEMBERS ancient-languages

Now, let's create a union of languages and ancient-languages to see all of them at once:

SUNION languages ancient-languages

We get the following reply:

1) "greek"
2) "spanish"
3) "japanese"
4) "chinese"
5) "latin"

If we pass to SUNION a key that doesn't exist, it considers that key to be an empty set (a set that has nothing in it).

Hashes

In Redis, a Hash is a data structure that maps a string key with field-value pairs. Thus, Hashes are useful to represent objects. They key is the name of the Hash and the value represents a sequence of field-name field-value entries. We could describe a computer object as follows:

computer name "MacBook Pro" year 2015 disk 512 ram 16

The "properties" of the object are defined as sequences of "property name" and "property value" after the name of the object, computer. Recall that Redis is all about sequential strings so we have to be careful when creating these string objects that we use the proper string sequencing to define our objects correctly.

To manipulate Hashes, we use commands that are similar to what we used with strings, after all, they are strings.

Writing and Reading Hash Data

HSET

The command HSET sets field in the Hash to value. If key does not exist, a new key storing a hash is created. If field already exists in the hash, it is overwritten.

HSET key field value

Let's create the computer hash:

HSET computer name "MacBook Pro"
// 1
HSET computer year 2015
// 1
HSET computer disk 512
// 1
HSET computer ram 16
// 1

For each HSET command, Redis replies with an integer as follows:

  • 1 if field is a new field in the hash and value was set.
  • 0 if field already exists in the hash and the value was updated.

Let's update the value of the year field to 2018:

HSET computer year 2018
// 0

HGET

HGET returns the value associated with field in a Hash:

HGET key field

Let's verify that we are getting 2018 as the value of year instead of 2015:

HGET computer year

Redis replies with "2018". It checks out fine.

HGETALL

A fast way to get all the fields with their values from the hash is to use HGETALL:

HGETALL key

Let's test it out:

HGETALL computer

Reply:

1) "name"
2) "MacBook Pro"
3) "year"
4) "2018"
5) "disk"
6) "512"
7) "ram"
8) "16"

HGETALL replies with an empty list when the provided key argument doesn't exist.

HMSET

We can also set multiple fields at once using HMSET:

HMSET key field value [field value ...]

Let's create a tablet hash with it:

HMSET tablet name "iPad" year 2016 disk 64 ram 4

HMSET returns OK to let us know the tablet hash was created successfully.

HMGET

What if we want to get just two fields? We use HMGET to specify from which fields in the hash we want to get a value:

HMGET key field [field ...]

Let's get the disk and ram fields of the tablet hash:

HMGET tablet disk ram

Effectively we get the values of disk and ram as replies:

1) "64"
2) "4"

That's pretty much the gist of using Hashes in Redis. You may explore the full list of Hash commands and try them out.

Sorted Sets

Introduced in Redis 1.2, a Sorted Set is, in essence, a Set: it contains unique, non-repeating string members. However, while members of a Set are not ordered (Redis is free to return the elements in any order at every call of a Set), each member of a Sorted Set is linked to a floating point value called the score which is used by Redis to determine the order of the Sorted Set members. Since, every element of a Sorted Set is mapped to a value, it also has an architecture similar to Hash.

In Redis, a Sorted Set could be seen as a hybrid of a Set and a Hash.

How is the order of members of a Sorted Set determined? As stated in the Redis documentation:

  • If A and B are two members with a different score, then A > B if A.score is > B.score.
  • If A and B have exactly the same score, then A > B if the A string is lexicographically greater than the B string. A and B strings can't be equal since Sorted Sets only have unique elements.

Some of the commands that we use to interact with Sorted Sets are similar to the commands we used with Sets: we replace the S in the Set command and replace it with a Z. For example, SADD => ZADD. However, we have commands that are unique to both. Let's check them out.

ZADD

Using ZADD adds all the specified members with specified scores to the Sorted Set:

ZADD key [NX|XX] [CH] [INCR] score member [score member ...]

As with Sets, if key does not exist, a new Sorted Set with the specified members as only members is created. If the key exists but does not hold a Sorted Set, an error is returned.

Starting in Redis 3.0.2, ZADD has optional arguments that gives us control of insertions:

  • XX: Only update members that already exist. Never add members.
  • NX: Don't update already existing members. Always add new members.
  • CH: Modify the return value from the number of new members added, to the total number of members changed (CH is an abbreviation of changed). Changed members are new members added and members already existing for which the score was updated. So members specified in the command line having the same score as they had in the past are not counted.
  • INCR: When this option is specified ZADD acts like ZINCRBY. Only one score-members pair can be specified in this mode.

It's good to know that these optional arguments are there and what they do, but for this introduction, we are going to focus on adding members without using any of them, but feel free to explore them! In future posts, we are going to revisit them in more complex use cases!

Let's create a Sorted Set to store Help Desk Support tickets. Support tickets are meant to be unique but also need to be sorted, hence, this data structure is a great choice:

ZADD tickets 100 HELP204
// 1
ZADD tickets 90 HELP004
// 1
ZADD tickets 180 HELP330
// 1

ZADD returns a count the number of new elements added. In the commands above, we used the position of the ticket in a queue as the score value followed by the ticket number (all fictional).

ZRANGE

We'd like now to see how our Sorted Set looks. With Sets, we used SMEMBERS to list the unordered members. With Sorted Sets, we use a command that is more in tune with what we used with Lists, a command that shows us a range of elements.

ZRANGE returns the specified range of members in the Sorted Set:

ZRANGE key start stop [WITHSCORES]

It behaves very similarly to LRANGE for Lists. We can use it to get a subset of the Sorted Set. To get the full Sorted Set, we can use the 0 -1 range again:

ZRANGE tickets 0 -1

Redis replies with:

1) "HELP004"
2) "HELP204"
3) "HELP330"

We can pass ZRANGE the WITHSCORES argument to also include the score of each member:

ZRANGE tickets 0 -1 WITHSCORES

Reply:

1) "HELP004"
2) "90"
3) "HELP204"
4) "100"
5) "HELP330"
6) "180"

Notice how the member and the score are listed in sequence and not next to each other. As we can see, the members are stored in tickets in ascending order based on their score.

Using Redis as a Session Store

The most relevant use of Redis in the authentication and authorization workflows of a web application is to serve as a session store.

As recognized by Amazon Web Services, the in-memory architecture of Redis provides developers with high availability and persistence that makes it a popular choice to store and manage session data for internet-scale applications. Its lightning-fast performance provides us with the super low latency, optimal scale, and resiliency that we need to manage session data such as user profiles, user settings, session state, and credential management.

Roshan Kumar, from Redis Labs, explains on his "Cache vs. Session Store" article that a session-oriented web application starts a session when the user logs in. The session is active until the user logs out or the session times out. During the session lifecycle, the web application stores all session-related data in the main memory (RAM) or in a session store that doesn't lose the data when the application goes down. This session store can be implemented using Redis that, despite being an in-memory store, is able to persist data by writing transaction logs sequentially in the disk.

A session-oriented application diagram

Source: Redis Labs: Cache vs. Session Store

Roshan further explains that session stores rely on reading and writing data to the in-memory database. The session store data isn’t temporary and it becomes the only source of truth when the session is live. For that reason, the session store needs to meet the "data durability requirements of a true database."

"According to @RedisLabs, a session store requires high availability and durability to support transactional data and uninterrupted user engagement. You can achieve that easily using #Redis."

Tweet

Tweet This

Conclusion

Redis is a powerful, nimble, and flexible database that can speed up your architecture. It has a lot to offer including caching, data replication, pub/sub messaging systems, session storage, and much more. Redis has a multitude of clients that cover all of the popular programming languages. I hope that you try it out whenever you have a use case that fits its value propositions.

About Auth0

Auth0 by Okta takes a modern approach to customer identity and enables organizations to provide secure access to any application, for any user. Auth0 is a highly customizable platform that is as simple as development teams want, and as flexible as they need. Safeguarding billions of login transactions each month, Auth0 delivers convenience, privacy, and security so customers can focus on innovation. For more information, visit https://auth0.com.

  • Twitter icon
  • LinkedIn icon
  • Faceboook icon