redis skiplist (跳跃表)


redis skiplist (跳跃表)

概述

redis skiplist 是有序的, 按照分值大小排序

节点中存储多个指向其他节点的指针

结构

  • zskiplist 结构
// 跳跃表
typedef struct zskiplist {
    // 表头节点和表尾节点
    struct zskiplistNode *header, *tail;
    // 表中节点的数量 (不包括表头结点)
    unsigned long length;
    // 表中层数最大的节点的层数 (不包括表头结点)
    int level;
} zskiplist;
  • length, level 属性不包含表头结点, 代码如下:
// 创建并返回一个新的跳跃表
zskiplist *zslCreate(void) {
    int j;
    zskiplist *zsl;
    // 分配空间
    zsl = zmalloc(sizeof(*zsl));
    // 设置高度和起始层数
    zsl->level = 1;
    zsl->length = 0;
    // 初始化表头节点
    zsl->header = zslCreateNode(ZSKIPLIST_MAXLEVEL,0,NULL);
    for (j = 0; j < ZSKIPLIST_MAXLEVEL; j++) {
        zsl->header->level[j].forward = NULL;
        zsl->header->level[j].span = 0;
    }
    zsl->header->backward = NULL;
    // 设置表尾
    zsl->tail = NULL;

    return zsl;
}
  • 由上代码可见, 初始化的表头结点, level 为 ZSKIPLIST_MAXLEVEL = 32, 但是 zsl->level = 1, zsl->length = 0, 说明这两个属性并没有将表头结点包含在内
  • zskiplistNode 结构 (节点)
// 节点
typedef struct zskiplistNode {
    // 成员对象
    robj *obj;
    // 分值
    double score;
    // 后退指针, 指向前置节点
    struct zskiplistNode *backward;
    // 层
    struct zskiplistLevel {
        // 前进指针
        struct zskiplistNode *forward;
        // 跨度
        unsigned int span; 
    } level[];
} zskiplistNode;
  • level 层
struct zskiplistLevel {
        // 前进指针
        struct zskiplistNode *forward;
        // 跨度
        unsigned int span;
};
节点中的 level 层结构中的 forward 指针只能指向同 level 层的节点
span 是记录相邻层之间的跨度, 在利用排位获取节点时使用, 相对于直接遍历表, 效率更高

其他

  • range 表示, 使用 zrangespec 结构
// 表示开区间/闭区间范围的结构
typedef struct {
    // 最小值和最大值
    double min, max;
    // 指示开区间还是闭区间
    // 值为 1 表示开,值为 0 表示闭
    int minex, maxex;
} zrangespec;

总结

skiplist 是有序的, 由小到大

skiplist 在普通列表基础上增加了 level 层和 score 概念

level 层是在创建节点时随机生成的层数

为了满足根据排名查询数据的需要, 避免遍历表去查找, 设置了 span 跨度参数

每个节点的 backward 参数都指向前置节点

头节点可以抽象的理解为不属于 skiplist, 因为它不属于 skiplist 的长度和最大层数, 头节点的 level 固定为 32

skiplist api (以 zset 为例 src/t_zset.c)

函数

作用

备注

zslCreateNode

创建 level 层, 分值为 score, 对象为 obj 的跳跃表节点

zskiplistNode *zslCreateNode(int level, double score, robj *obj)

zslCreate

创建并返回一个新的跳跃表

zskiplist *zslCreate(void)

zslFreeNode

释放跳跃表节点

void zslFreeNode(zskiplistNode *node)

zslFree

释放跳跃表

void zslFree(zskiplist *zsl)

zslRandomLevel

生成一个随机数作为节点的层数

int zslRandomLevel(void)

zslInsert

创建一个对象为 obj, 分值为 score 的跳跃表节点, 并将其插入跳跃表 zsl 中

zskiplistNode *zslInsert(zskiplist *zsl, double score, robj *obj)

zslDeleteNode

从 zsl 中删除指定节点 x, 并更新有关节点 update 的信息

void zslDeleteNode(zskiplist *zsl, zskiplistNode *x, zskiplistNode **update)

zslDelete

从 zsl 中删除指定分值 score, 指定对象 obj 的节点

int zslDelete(zskiplist *zsl, double score, robj *obj)

zslValueGteMin

检测给定的 value 值是否大于等于 spec 的 min 值

static int zslValueGteMin(double value, zrangespec *spec)

zslValueLteMax

检测给定的 value 值是否小于等于 spec 的 max 值

static int zslValueLteMax(double value, zrangespec *spec)

zslIsInRange

检测给定的 range 值是否在 zsl 范围内

int zslIsInRange(zskiplist *zsl, zrangespec *range)

zslFirstInRange

返回 zsl 中首个在范围中的节点

zskiplistNode *zslFirstInRange(zskiplist *zsl, zrangespec *range)

zslLastInRange

返回 zsl 中最后一个在范围内的节点

zskiplistNode *zslLastInRange(zskiplist *zsl, zrangespec *range)

zslDeleteRangeByScore

删除给定 range 范围的 zsl 节点

unsigned long zslDeleteRangeByScore(zskiplist *zsl, zrangespec *range, dict *dict)

zslDeleteRangeByRank

根据 rank 排名范围获取所有节点

unsigned long zslDeleteRangeByRank(zskiplist *zsl, unsigned int start, unsigned int end, dict *dict)

zslGetRank

获取给定 score 和 robj 的节点在表中的排位

unsigned long zslGetRank(zskiplist *zsl, double score, robj *o)

zslGetElementByRank

根据 rank 排位获取节点

zskiplistNode* zslGetElementByRank(zskiplist *zsl, unsigned long rank)

zslParseRange

解析 min, max, 将其存入 spec

static int zslParseRange(robj *min, robj *max, zrangespec *spec)