This content originally appeared on DEV Community and was authored by topeogunleye
Welcome back to the second part of our Redis for Beginners series. In Part 1, we covered some basic setups of a Redis database and a couple of fundamental commands. In this second part, we will further explore advanced options for commands while deeply focusing on the difference between lists and sets in Redis.
Command Options
Not all commands have options, but a few, for example, SET, have certain added features that can be essential.
- EX seconds: Sets an expiration time in seconds (must be a positive integer).
- PX milliseconds: Sets an expiration time in milliseconds (must be a positive integer).
- EXAT timestamp-seconds: Sets a specific Unix timestamp for expiration (must be a positive integer).
- NX: Sets the key only if it does not already exist.
- XX: Sets the key only if it already exists.
Note: You can't use NX and XX together because they will conflict with each other. Also, you can use only one option for expiration (EX or PX) at a time.
To learn more about the SET command visit here to check out the Redis documentation page.
Example: SET Command Using the EX Option
When executing the following at your workbench, you will define a key with an expiration in Redis:
SET key value EX seconds
Replace key with the name of the key that contains the string and value with the new value you would like to store. Replace seconds with the amount of time, in seconds, after which the key should expire.
For example: if you want to set your name value to "Yoshi", and you want it to expire after 7 seconds, run:
SET name carint EX 7
This command updates the value of name to "Yoshi" and sets an expiration of 7 seconds from the time the command is executed.
Example: SET Command with NX and XX Options
You can set the key conditionally concerning its existence in Redis by using the options NX, which stands for Not eXists, and XX, which stands for eXists, in the SET command:
Using NX (Not eXists) Option:
SET key value NX
Replace key with the name of the key you want to set and value with the value you want to store in the key. This command sets the value of key to value only if key does not already exist. If key already exists, the command will not perform any action.
Example:
If you want to set a new key username to "alice" only if username does not already exist, you would use:
SET username alice NX
Using XX (eXists) Option:
SET key value XX
This command sets the value of key to value only if key already exists. If key does not exist, the command will not perform any action.
Example:
If you want to update the value of an existing key username to "bob" only if username already exists, you would use:
SET username bob XX
Lists vs. Sets
Lists
- An ordered collection of strings.
- Supports operations like adding elements to the head or tail, trimming based on ranges, etc.
- Useful for maintaining ordered data structures.
-
Commands:
RPUSH,LPUSH,LRANGE,LPOP,RPOP, etc.
Sets
- An unordered collection of unique strings.
- Supports operations like adding, removing, and checking membership.
- Useful for storing unique items and performing set operations.
-
Commands:
SADD,SREM,SMEMBERS,SISMEMBER, etc.
When deciding between lists and sets, consider the order requirements and the need for uniqueness in your data.
RPUSH: Adding Elements to the End of a List
To add one or more elements to the end of a list, use the RPUSH command. Here’s how to use it in your workbench:
RPUSH key element [element ...]
Replace key with the name of the list, and element with the elements you want to add.
For example:
- Create a list named
fruitsand add elements to it:
RPUSH fruits apple banana cherry
This will add "apple", "banana", and "cherry" to the end of the fruits list.
LPUSH: Adding Elements to the Beginning of a List
To add one or more elements to the beginning of a list, use the LPUSH command. Here’s how to use it in your workbench:
LPUSH key element [element ...]
Replace key with the name of the list, and element with the elements you want to add.
For example:
- Add elements to the beginning of the
fruitslist:
LPUSH fruits mango orange
This will add "mango" and "orange" to the beginning of the fruits list.
LRANGE: Retrieving Elements from a List
To retrieve a range of elements from a list, use the LRANGE command. Here’s how to use it in your workbench:
LRANGE key start stop
Replace key with the name of the list, start with the starting index, and stop with the ending index.
For example:
- Retrieve elements from the
fruitslist:
LRANGE fruits 0 2
This will return the first three elements: "mango", "orange", and "apple".
LPOP: Removing the First Element from a List
To remove and return the first element of a list, use the LPOP command. Here’s how to use it in your workbench:
LPOP key
Replace key with the name of the list.
For example:
- Remove the first element from the
fruitslist:
LPOP fruits
This will remove and return "orange".
RPOP: Removing the Last Element from a List
To remove and return the last element of a list, use the RPOP command. Here’s how to use it in your workbench:
RPOP key
Replace key with the name of the list.
For example:
- Remove the last element from the
fruitslist:
RPOP fruits
This will remove and return "cherry".
SADD: Adding Elements to a Set
To add one or more elements to a set, use the SADD command. Here’s how to use it in your workbench:
SADD key member [member ...]
Replace key with the name of the set, and member with the elements you want to add.
For example:
- Create a set named
colorsand add elements to it:
SADD colors red green blue
This will add "red", "green", and "blue" to the colors set.
SREM: Removing Elements from a Set
To remove one or more elements from a set, use the SREM command. Here’s how to use it in your workbench:
SREM key member [member ...]
Replace key with the name of the set, and member with the elements you want to remove.
For example:
- Remove elements from the
colorsset:
SREM colors blue
This will remove "blue" from the colors set.
SMEMBERS: Retrieving All Elements from a Set
To retrieve all the elements of a set, use the SMEMBERS command. Here’s how to use it in your workbench:
SMEMBERS key
Replace key with the name of the set.
For example:
- Retrieve all elements from the
colorsset:
SMEMBERS colors
This will return all elements in the colors set: "red" and “green”.
SISMEMBER: Checking if an Element Exists in a Set
To check if an element is a member of a set, use the SISMEMBER command. Here’s how to use it in your workbench:
SISMEMBER key member
Replace key with the name of the set, and member with the element you want to check.
For example:
- Check if "red" is in the
colorsset:
SISMEMBER colors red
This will return 1 if "red" is a member of the set, and 0 otherwise.
Hashes in Redis
In Redis, hashes are maps between string fields and string values. They are ideal for representing objects or entities with multiple attributes. Unlike sets or lists, which hold single values, hashes store key-value pairs where both the field and the value are strings.
Example: Using HSET Command for Hashes
The HSET command sets a field in the hash stored at key to a specified value. If the key does not exist, it creates an empty hash.
HSET key field value
- Replace
keywith the name of the hash. - Replace
fieldwith the attribute to change. - Replace
valuewith the new value to assign.
Example: Setting Fields in a Hash
Create a hash user:1001 representing a user with attributes:
HSET user:1001 username alice email alice@example.com
This command sets username to "alice" and email to "alice@example.com" in the hash user:1001.
Example: Using HGET Command for Hashes
The HGET command retrieves the value of a field from the hash stored at key.
HGET key field
- Replace
keywith the name of the hash. - Replace
fieldwith the specific field whose value you want to retrieve.
Example: Getting Fields from a Hash
To retrieve the username and email fields from the user:1001 hash:
HGET user:1001 username
HGET user:1001 email
These commands will return "alice" and "alice@example.com" respectively.
Example: Using HDEL Command for Hashes
The HDEL command deletes one or more fields from the hash at key.
HDEL key field [field ...]
- Replace
keywith the name of the hash from which fields are removed. - Replace
fieldwith the field(s) to remove.
Example: Removing Fields from a Hash
To remove the email field from the user:1001 hash:
HDEL user:1001 email
The email field will be removed from the user:1001 hash.
Conclusion
Redis has evolved significantly, positioning itself not just as a caching layer but as a primary database. It offers data persistence, replication for durability and availability, JSON support, and search modules for storing and querying complex data. Redis OM, an Object mapping library, simplifies usage. This series focuses on Redis's core capabilities.
This format organizes the content into sections with headings, subheadings, and clear examples, suitable for readability and reference in Notion.
This content originally appeared on DEV Community and was authored by topeogunleye
topeogunleye | Sciencx (2024-07-25T14:15:40+00:00) Redis for Beginners (Part 2 of 2). Retrieved from https://www.scien.cx/2024/07/25/redis-for-beginners-part-2-of-2/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.