e-Book - Redis in Action

This book covers the use of Redis, an in-memory database/data structure server.
  • Foreword
  • Preface
  • Acknowledgments
  • About this Book
  • About the Cover Illustration
  • Part 1: Getting Started
  • Part 2: Core concepts
  • Part 3: Next steps
  • Appendix A
  • Appendix B
  • Buy the paperback

    1.2.3 Sets in Redis

    Figure 1.3An example of a SET with three items under the key, set-key

    In Redis, SETs are similar to LISTs in that they’re a sequence of strings, but unlike LISTs, Redis SETs use a hash table to keep all strings unique (though there are no associated values). My visual representation of SETs will be similar to LISTs, and figure 1.3 shows an example SET with three items.

    Because Redis SETs are unordered, we can’t push and pop items from the ends like we did with LISTs. Instead, we add and remove items by value with the SADD and SREM commands. We can also find out whether an item is in the SET quickly with SISMEMBER, or fetch the entire set with SMEMBERS (this can be slow for large SETs, so be careful). You can follow along with listing 1.3 in your Redis client console to get a feel for how SETs work, and table 1.5 describes the commands used here.

    Table 1.5 Commands used on SET values


    What it does


    Adds the item to the set


    Returns the entire set of items


    Checks if an item is in the set


    Removes the item from the set, if it exists

    Listing 1.3
    The SADD, SMEMBERS, SISMEMBER, and SREM commands in Redis
    redis> sadd set-key item
    (integer) 1
    redis> sadd set-key item2
    (integer) 1
    redis> sadd set-key item3
    (integer) 1
    redis> sadd set-key item
    (integer) 0

    When adding an item to a SET, Redis will return a 1 if the item is new to the set and 0 if it was already in the SET.

    redis> smembers set-key
    1) "item"
    2) "item2"
    3) "item3"

    We can fetch all of the items in the SET, which returns them as a sequence of items, which is turned into a Python set from Python.

    redis> sismember set-key item4
    (integer) 0
    redis> sismember set-key item
    (integer) 1

    We can also ask Redis whether an item is in the SET, which turns into a Boolean in Python.

    redis> srem set-key item2
    (integer) 1
    redis> srem set-key item2
    (integer) 0

    When we attempt to remove items, our commands return the number of items that were removed.

    redis> smembers set-key
    1) "item"
    2) "item3"

    As you can probably guess based on the STRING and LIST sections, SETs have many other uses beyond adding and removing items. Three commonly used operations with SETs include intersection, union, and difference (SINTER, SUNION, and SDIFF, respectively). We’ll get into more detail about SET commands in chapter 3, and over half of chapter 7 involves problems that can be solved almost entirely with Redis SETs. But let’s not get ahead of ourselves; we’ve still got two more structures to go. Keep reading to learn about Redis HASHes.