Understanding Redis Hashes

Welcome back! We've covered how to connect to Redis, work with numbers, and handle lists. Now, it's time to explore another crucial data structure in Redis: hashes. Hashes are used to store related pieces of information in a single key, making them perfect for representing objects like user profiles or configurations.

In this lesson, you will learn how to:

1. Use the hset command to store fields and values in a Redis hash.
2. Retrieve data from a hash using the hgetall command.

Let's look at an example:

import Redis from 'ioredis';

// Create and connect Redis client
const redis = new Redis();

try {
    // Using hashes to store and retrieve fields and values
    await redis.hset('user:1000', 'username', 'alice');
    await redis.hset('user:1000', 'email', 'alice@example.com');

    let user = await redis.hgetall('user:1000');
    console.log('User details:', user); // User details: { username: 'alice', email: 'alice@example.com' }

    await redis.hdel('user:1000', 'username');
    user = await redis.hgetall('user:1000');
    console.log('User details:', user); // User details: { email: 'alice@example.com' }

} catch (err) {
    console.error('Error:', err);
} finally {
    // Disconnect from Redis
    redis.disconnect();
}

In this example:

• The hset command adds the fields username and email to the hash user:1000.
  • Note that if the field already exists in the hash, hset will overwrite its value without warning.
• The hgetall command retrieves all fields and values from the user:1000 hash.
  • In addition, we can use hget to retrieve a specific field from the hash. For example, to retrieve the username field, we would use await redis.hget('user:1000', 'username');.
• The hdel command deletes the specified field from the hash, in this case, the username field.
  • The hdel command only removes the specified fields, not the entire hash. If all fields are deleted, the hash still exists as an empty key until explicitly removed.
    await redis.hdel('user:1000', 'username', 'email'); // Deletes both fields
    const user = await redis.hgetall('user:1000');
    console.log(user); // Output: {}

  • If you want to completely remove a hash when it is empty, use del:
    await redis.del('user:1000'); // Removes the entire hash key