13 hash 相关操作

Posted 2021-08-30 蓝风9

前言

相关介绍主要围绕着如下的一些常用的命令, 来看看 hash 相关操作的具体 api 

如下常用的命令来自于我们常见的教程 : https://www.runoob.com/redis/redis-hashes.html 

本文的相关代码 拷贝自 redis-6.2.0  

代码来自于 https://redis.io/ 

数据存储

当数据元素小于等于 hash_max_ziplist_entries(默认为512) 的时候使用的是 ziplist 来存储数据 

超过了 hash_max_ziplist_entries 之后, 数据结构更新为 dict 

HDEL key field1 [field2] - 执行 hdel user name age

这里可以看出的是 参数的数量要求大于等于 3 个, 也就是可以删除同一个 hash 的多个 key 

我们来看一下 hdelCommand 

获取 key 对应的 entry, 并确保类型为 HASH, 返回给客户端错误信息 

遍历 fieldList, 从 entry 里面删除 field 的数据 

如果当前 entry 有改动, 发送 db key 的更新通知 

返回给客户端的是 当前 entry 中删除的 key 的数据 

具体的处理删除 field 的方法如下 

如果 encoding 为 ZIPLIST, 首先找到 field 对应的位置, 删除 field & fieldValue 

如果 encoding 为 HASHTABLE, 从 dict 里面删除 field 对应的 entry  

最终客户端这边展示的结果如下, 返回的是 user 这个 hash 下面删除的元素的数量, 这里删除了 name -> jerry, age -> 77 两个元素  

HEXISTS key field - 执行 hexists user name 

这里可以看出的是 参数的数量要求等于 3 个 

我们来看一下 hexistsCommand 

获取 key 对应的 entry 

判断给定的 field 在 entry 中是否存在 

o 的类型为 HASH, encoding 为 ZIPLIST, ptr 指向了一个 ziplist 

具体的业务处理的方式为 

如果是 ziplist, 获取 field 对应的元素信息, 如果存在 返回 1 

如果是 hashtable, 获取 field 对应的 entry 的信息, 如果存在 返回 1  

最终客户端这边展示的结果如下, 返回的是 user 这个 hash 下面 name 这个 field 是否存在 

HGET key field - 执行 hget user name

这里可以看出的是 参数的数量要求等于 3 个 

我们来看下 hgetCommand 

获取 key 对应的 entry 

获取给定的 field 对应的值 

具体的业务处理的方式为 

如果是 ziplist, 获取 field 对应的元素信息, 返回 field 紧接着的 fieldValue 

如果是 hashtable, 获取 field 对应的 entry 的 value 返回 

这里获取到的是 len 为 5, 数据为 jerrry 

最终客户端这边展示的结果如下, 返回的是 user 这个 hash 下面 name 这个 field 对应的值 

HGETALL key - 执行 hgetall user

这里可以看出的是 参数的数量要求等于 2 个 

我们来看一下 hgetallCommand 

响应元素长度给客户端 

遍历给定的 entry, 响应 key, value 给客户端 

哈希的具体的迭代方式 

创建迭代器, 封装 subject, encoding, 如果是 hashtable, 获取迭代器

迭代数据, 如果 ziplist 编码, 基于 ziplistNext 进行迭代, 如果是 hashtable 编码, 基于 dictNext 进行迭代 

最终客户端这边展示的结果如下, 返回的是 user 这个 hash 下面 field & fieldValue 列表 

HINCRBY key field increment - 执行 hincrby user counter 2

这里可以看出的是 参数的数量要求等于 4 个 

我们来看一下 hincrbyCommand 

这里的相关操作 和字符串的 incr 的相关业务是相同的, 这里不多赘述 

最终客户端这边展示的结果如下, user 这个 entry 下面 counter 不存在, 这里累增了 2, 返回的是 counter 累增之后的结果 2 

HKEYS key - 执行 hkeys user

这里可以看出的是 参数的数量要求等于 2 个 

我们来看一下 hkeysCommand 

同样是类似于上面的 hgetall user 

最终客户端这边展示的结果如下, user 这个 entry 下面 所有的 key 列表 

HLEN key - 执行 hlen user

这里可以看出的是 参数的数量要求等于 2 个 

我们来看一下 hlenCommand 

获取到 key 对应的 entry 

获取 entry 里面元素的数量返回 

元素个数的具体计算方式 

如果编码是 ziplist, 获取 ziplist 的长度 / 2, 即为哈希中元素的数量 

如果编码是 hashtable, 通过 hashtable 相关 元数据 直接获取元素数量 

最终客户端这边展示的结果如下, user 这个 entry 下面元素的数量 

HMGET key field1 [field2]

这里可以看出的是 参数的数量要求大于等于 3 个 

我们来看一下 hmgetCommand 

获取到 key 对应的 entry 

先返回一个结果长度 

再返回 fieldList 对应的所有的 value 列表 

获取 field 对应的 value 的方式就类似于 hget 里面的业务处理了 

最终客户端这边展示的结果如下, user 这个 entry 下面 name, age 对应的 value 列表 

HMSET key field1 value1 [field2 value2] - 执行 hmset user field1 value1 field2 value2

这里可以看出的是 参数的数量要求大于等于 4 个 

我们来看一下 hsetCommand 

需要确认 field, value 是成对出现 

然后 尝试更新存储的数据结构的转换 

循环 fieldList, valueList, 循环设置 field, value 

返回给客户端 创建成功 或者 具体设置的 field, value 对的数量 

发送 db key 的更新通知, 更新 dirty 

设置 field, value 的具体的信息 

如果编码是 ziplist, 查询 field 是否存在, 如果是存在 更新 value, 否则 新增 field, value 

如果编码是 hashtable, 查询 field 对应的 entry 是否存在, 如果是存在 更新 value, 否则 新增 field, value 

最终客户端这边展示的结果如下, user 这个 entry 下面 设置 field1, field2 成功 

HSET key field value 

这里可以看出的是 参数的数量要求大于等于 4 个 

hset, hsetnx 都是差不多, 这里只介绍一个 

这里的具体的实现 就和上面 hmset 的实现是同一套, 这不多赘述 

最终客户端这边展示的结果如下, user 这个 entry 下面 设置 field3, field4 成功 

HVALS user

这里可以看出的是 参数的数量要求大于等于 2 个 

我们看一下 hvalsCommand 

和上面 hgetall 的相关处理业务代码 基本一致, 这里不多赘述 

最终客户端这边展示的结果如下, user 这个 entry 下面所有的 value 列表 

HSCAN key cursor [MATCH pattern] [COUNT count] - 执行 hscan user 0 MATCH * COUNT 1

这里可以看出的是 参数的数量要求大于等于 2 个 

这的迭代类似于 11 key 相关操作 

不过对于这里编码为 ziplist 的情况 COUNT 这两个选项是没用的[这是一个很细的细节] 

迭代的是 ziplist 里面的所有的元素  

最终客户端这边展示的结果如下, user 这个 entry 下面所有的 匹配 pattern 的 field, value 列表 

完