图解redis的字典

引言：

字典，又称为符号表（symbol table）、关联数组（associative array）或映射（map），是一种用于保存键值对（key-value pair）的抽 象数据结构。

在字典中，一个键（key）可以和一个值（value）进行关联（或者 说将键映射为值），这些关联的键和值就称为键值对。 字典中的每个键都是独一无二的，程序可以在字典中根据键查找与 之关联的值，或者通过键来更新值，又或者根据键来删除整个键值对， 等等。

字典经常作为一种数据结构内置在很多高级编程语言里面，但 Redis所使用的C语言并没有内置这种数据结构，因此Redis构建了自己 的字典实现。 字典在Redis中的应用相当广泛，比如Redis的数据库就是使用字典来作为底层实现的，对数据库的增、删、查、改操作也是构建在对字典 的操作之上的

127.0.0.1:6379> SET msg "hello world"
OK

在数据库中创建一个键为"msg"，值为"hello world"的键值对时，这 个键值对就是保存在代表数据库的字典里面的。 除了用来表示数据库之外，字典还是哈希键的底层实现之一，当一 个哈希键包含的键值对比较多，又或者键值对中的元素都是比较长的字 符串时，Redis就会使用字典作为哈希键的底层实现

举个例子，website是一个包含10086个键值对的哈希键，这个哈希 键的键都是一些数据库的名字，而键的值就是数据库的主页网址

redis> HLEN website
(integer) 10086
redis> HGETALL website
1)"Redis"
2)"Redis.io"
3)"MariaDB"
4)"MariaDB.org"
5)"MongoDB"
6)"MongoDB.org"

website键的底层实现就是一个字典，字典中包含了10086个键值 对，例如：

键值对的键为"Redis"，值为"Redis.io"。

·键值对的键为"MariaDB"，值为"MariaDB.org"；

·键值对的键为"MongoDB"，值为"MongoDB.org"； 

HASH（hash概要）：

typedef struct dictht {
//
哈希表数组
dictEntry **table;
//
哈希表大小
unsigned long size;
//
哈希表大小掩码，用于计算索引值
//
总是等于size-1
unsigned long sizemask;
//
该哈希表已有节点的数量
unsigned long used;
} dictht;

table属性是一个数组，数组中的每个元素都是一个指向 dict.h/dictEntry结构的指针，

每个dictEntry结构保存着一个键值对。

size 属性记录了哈希表的大小，也即是table数组的大小，

而used属性则记录 了哈希表目前已有节点（键值对）的数量。

sizemask属性的值总是等于 size-1

下图展现：展示了一个大小为4的空哈希表（没有包含任何键值对）

 hash节点（分离列表法）

typedef struct dictEntry {
//
键
void *key;
//
值
union{
void *val;
uint64_tu64;
int64_ts64;
} v;
//
指向下个哈希表节点，形成链表
struct dictEntry *next;
} dictEntry;

key属性保存着键值对中的键，而v属性则保存着键值对中的值，其 中键值对的值可以是一个指针，或者是一个uint64_t整数，又或者是一 个int64_t整数。 next属性是指向另一个哈希表节点的指针，这个指针可以将多个哈希值相同的键值对连接在一次，以此来解决键冲突（collision）的问题

 下图就展示了如何通过next指针，将两个索引值相同的 键k1和k0连接在一起。

 字典

typedef struct dict {
//
类型特定函数
dictType *type;
//
私有数据
void *privdata;
//
哈希表
dictht ht[2];
// rehash
索引
//
当rehash
不在进行时，值为-1
in trehashidx; /* rehashing not in progress if rehashidx == -1 */
} dict

type属性和privdata属性是针对不同类型的键值对，为创建多态字而 而设置的

type属性是一个指向dictType结构的指针，每个dictType结构保存了 一簇用于操作特定类型键值对的函数，Redis会为用途不同的字典设置 不同的类型特定函数

privdata属性则保存了需要传给那些类型特定函数的可选参数

typedef struct dictType {
//
计算哈希值的函数
unsigned int (*hashFunction)(const void *key);
//
复制键的函数
void *(*keyDup)(void *privdata, const void *key);
//
复制值的函数
void *(*valDup)(void *privdata, const void *obj);
//
对比键的函数
int (*keyCompare)(void *privdata, const void *key1, const void *key2);
//
销毁键的函数
void (*keyDestructor)(void *privdata, void *key);
//
销毁值的函数
void (*valDestructor)(void *privdata, void *obj);
} dictType

ht属性是一个包含两个项的数组，数组中的每个项都是一个dictht哈 希表，

一般情况下，字典只使用ht[0]哈希表，ht[1]哈希表只会在对ht[0] 哈希表进行rehash时使用。 除了ht[1]之外，另一个和rehash有关的属性就是rehashidx，它记录 了rehash目前的进度，如果目前没有在进行rehash，那么它的值为-1

一个普通状态的字典：

 HASH 算法

当要将一个新的键值对添加到字典里面时，程序需要先根据键值对 的键计算出哈希值和索引值，然后再根据索引值，将包含新键值对的哈 希表节点放到哈希表数组的指定索引上面

使用字典设置的哈希函数，计算键key
的哈希值
hash = dict->type->hashFunction(key);
#
使用哈希表的sizemask
属性和哈希值，计算出索引值
#
根据情况不同，ht[x]
可以是ht[0]
或者ht[1]
index = hash & dict->ht[x].sizemask

下图是一个空字典：

hash = dict->type->hashFunction(k0)；
index = hash&dict->ht[0].sizemask = 8 & 3 = 0;

 1.计算键k0的哈希值。 假设计算得出的哈希值为8，那么程序会继续使用语句

2.进行相与计算

计算出键k0的索引值0，这表示包含键值对k0和v0的节点应该被放 置到哈希表数组的索引0位置上

 rehash

随着操作的不断执行，哈希表保存的键值对会逐渐地增多或者减 少，为了让哈希表的负载因子（load factor）维持在一个合理的范围之 内，当哈希表保存的键值对数量太多或者太少时，程序需要对哈希表的 大小进行相应的扩展或者收缩

扩展和收缩哈希表的工作可以通过执行rehash（重新散列）操作来 完成，Redis对字典的哈希表执行rehash的步骤如下：

1）为字典的ht[1]哈希表分配空间，这个哈希表的空间大小取决于 要执行的操作，以及ht[0]当前包含的键值对数量（也即是ht[0].used属性 的值）：

·如果执行的是扩展操作，那么ht[1]的大小为第一个大于等于 ht[0].used*2的2 n（2的n次方幂）； ·

如果执行的是收缩操作，那么ht[1]的大小为第一个大于等于 ht[0].used的2 n。

2）将保存在ht[0]中的所有键值对rehash到ht[1]上面：rehash指的是 重新计算键的哈希值和索引值，然后将键值对放置到ht[1]哈希表的指定 位置上。

3）当ht[0]包含的所有键值对都迁移到了ht[1]之后（ht[0]变为空 表），释放ht[0]，将ht[1]设置为ht[0]，并在ht[1]新创建一个空白哈希 表，为下一次rehash做准备。

图解：

1.

 

1）ht[0].used当前的值为4，4*2=8，而8（2的三次方）恰好是第一个大于等于4的2的n次方，所以程序会将ht[1]哈希表的大小设置为8。展 示了ht[1]在分配空间之后，字典的样子

2. 将ht[0]包含的四个键值对都rehash到ht[1]，

3. 释放ht[0]，并将ht[1]设置为ht[0]，然后为ht[1]分配一个空白哈 希表，如图4-11所示。至此，对哈希表的扩展操作执行完毕，程序成功 将哈希表的大小从原来的4改为了现在的8

实现 哈希表的扩展与收缩：

1.服务器目前没有在执行BGSAVE命令或者BGREWRITEAOF命 令，并且哈希表的负载因子大于等于1

2.服务器目前正在执行BGSAVE命令或者BGREWRITEAOF命 令，并且哈希表的负载因子大于等于5

其中哈希表的负载因子可以通过公式：

负载因子= 哈希表已保存节点数量/ 哈希表大小 load_factor = ht[0].used / ht[0].size

渐进式rehash 

扩展或收缩哈希表需要将ht[0]里面的所有键值对 rehash到ht[1]里面，但是，这个rehash动作并不是一次性、集中式地完成 的，而是分多次、渐进式地完成的。 这样做的原因在于，如果ht[0]里只保存着四个键值对，那么服务器 可以在瞬间就将这些键值对全部rehash到ht[1]；但是，如果哈希表里保 存的键值对数量不是四个，而是四百万、四千万甚至四亿个键值对，那 么要一次性将这些键值对全部rehash到ht[1]的话，庞大的计算量可能会 导致服务器在一段时间内停止服务

1）为ht[1]分配空间，让字典同时持有ht[0]和ht[1]两个哈希表。

2）在字典中维持一个索引计数器变量rehashidx，并将它的值设置 为0，表示rehash工作正式开始。

3）在rehash进行期间，每次对字典执行添加、删除、查找或者更新 操作时，程序除了执行指定的操作以外，还会顺带将ht[0]哈希表在 rehashidx索引上的所有键值对rehash到ht[1]，当rehash工作完成之后，程 序将rehashidx属性的值增一。

4）随着字典操作的不断执行，最终在某个时间点上，ht[0]的所有 键值对都会被rehash至ht[1]，这时程序将rehashidx属性的值设为-1，表 示rehash操作已完成。

因为在进行渐进式rehash的过程中，字典会同时使用ht[0]和ht[1]两 个哈希表，

所以在渐进式rehash进行期间，字典的删除（delete）、查找 （find）、更新（update）等操作会在两个哈希表上进行。

例如，要在 字典里面查找一个键的话，程序会先在ht[0]里面进行查找，如果没找到 的话，就会继续到ht[1]里面进行查找，诸如此类。 另外，在渐进式rehash执行期间，新添加到字典的键值对一律会被 保存到ht[1]里面，而ht[0]则不再进行任何添加操作，这一措施保证了 ht[0]包含的键值对数量会只减不增，并随着rehash操作的执行而最终变 成空表

重大回顾

·字典被广泛用于实现Redis的各种功能，其中包括数据库和哈希键。

·Redis中的字典使用哈希表作为底层实现，每个字典带有两个哈希 表，一个平时使用，另一个仅在进行rehash时使用。

·当字典被用作数据库的底层实现，或者哈希键的底层实现时， Redis使用MurmurHash2算法来计算键的哈希值。

·哈希表使用链地址法来解决键冲突，被分配到同一个索引上的多 个键值对会连接成一个单向链表。

·在对哈希表进行扩展或者收缩操作时，程序需要将现有哈希表包 含的所有键值对rehash到新哈希表里面，并且这个rehash过程并不是一 次性地完成的，而是渐进式地完成的。