From 443143670b99257d50bbd320720be40d201c8a95 Mon Sep 17 00:00:00 2001 From: Estom Date: Thu, 2 Sep 2021 21:37:06 +0800 Subject: [PATCH] redis --- code_segment/xiaoyu.cpp | 5 + code_segment/xiaoyu.py | 58 ++++ 工作日志/2021年8月24日-今日计划.md | 6 +- 工作日志/2021年8月29日-今日计划.md | 0 工作日志/2021年8月3日-八月份计划.md | 23 +- 工作日志/2021年8月4日-今日计划.md | 4 - 工作日志/2021年8月7日-今日计划.md | 4 +- 数据库/Redis/00 目录.md | 58 ---- 数据库/Redis/01 Redis概述.md | 10 + 数据库/Redis/02 动态字符串.md | 99 ------ 数据库/Redis/02 数据类型.md | 15 + 数据库/Redis/03 数据结构.md | 300 ++++++++++++++++++ 数据库/Redis/03 链表.md | 67 ---- 数据库/Redis/04 字典.md | 156 --------- 数据库/Redis/image/2021-09-02-16-24-45.png | Bin 0 -> 30909 bytes .../{00 Redis详解.md => 附录1 Redis详解.md} | 107 +++---- .../{01 Redis笔记.md => 附录2 Redis笔记.md} | 0 数据库/数据库.xmind | Bin 33366 -> 34559 bytes 18 files changed, 454 insertions(+), 458 deletions(-) create mode 100644 code_segment/xiaoyu.cpp create mode 100644 code_segment/xiaoyu.py delete mode 100644 工作日志/2021年8月29日-今日计划.md delete mode 100644 数据库/Redis/00 目录.md create mode 100644 数据库/Redis/01 Redis概述.md delete mode 100644 数据库/Redis/02 动态字符串.md create mode 100644 数据库/Redis/02 数据类型.md create mode 100644 数据库/Redis/03 数据结构.md delete mode 100644 数据库/Redis/03 链表.md create mode 100644 数据库/Redis/image/2021-09-02-16-24-45.png rename 数据库/Redis/{00 Redis详解.md => 附录1 Redis详解.md} (85%) rename 数据库/Redis/{01 Redis笔记.md => 附录2 Redis笔记.md} (100%) diff --git a/code_segment/xiaoyu.cpp b/code_segment/xiaoyu.cpp new file mode 100644 index 00000000..168a57b7 --- /dev/null +++ b/code_segment/xiaoyu.cpp @@ -0,0 +1,5 @@ +#include + +#include + +#include \ No newline at end of file diff --git a/code_segment/xiaoyu.py b/code_segment/xiaoyu.py new file mode 100644 index 00000000..0a18e0da --- /dev/null +++ b/code_segment/xiaoyu.py @@ -0,0 +1,58 @@ +class Solution: + def revmoveDuplicateChars(self,s:list)->None: + m = list([0 for i in range(255)]) + i=0 + while iarray[left-1]: + right = i-1 + + i =i+1 + if left==0: + return True + if right == -1: + right = len(array)-1 + + i=0 + insert_pos=0 + while i< left: + if array[i]>array[right]: + insert_pos=i + break + i=i+1 + if i==0 and insert_pos==0: + return True + + if i!=0 and insert_pos==0: + return False + + if insert_pos!=0 and array[insert_pos-1] 由于java和go的重复性。go作为新兴语言的优势。所以掌握go语言。 -* [ ] C++ - * [ ] 基础知识 - * [ ] 标准库 - * [ ] 面向对象 - * [ ] 设计模式 +* [x] C++ + * [x] 基础知识 + * [x] 标准库 + * [x] 面向对象 + * [x] 设计模式 * [ ] 并行编程 * [ ] GO * [ ] 基础知识。 @@ -22,8 +22,19 @@ * [ ] 算法 ### 知识复习——基础 * [ ] 操作系统 -* [ ] 数据库 + * [ ] 基础知识 + * [ ] Linux底层原理和常见函数 +* [x] 数据库 + * [x] 基础知识 + * [x] MySQL + * [ ] Redis + * [ ] 消息队列 * [ ] 计算机网络 + * [ ] 应用层 + * [ ] 网络层 + * [ ] 通信层 + * [ ] 链路层 + * [ ] 物理层 ### 知识复习——框架 * [ ] C++/GO框架 * [ ] 微服务框架 diff --git a/工作日志/2021年8月4日-今日计划.md b/工作日志/2021年8月4日-今日计划.md index e67bf793..2b4572d2 100644 --- a/工作日志/2021年8月4日-今日计划.md +++ b/工作日志/2021年8月4日-今日计划.md @@ -1,10 +1,6 @@ ## 任务 - - - - ## 收获 ### 关于工作周期的思考。 diff --git a/工作日志/2021年8月7日-今日计划.md b/工作日志/2021年8月7日-今日计划.md index bdd93364..c83af4df 100644 --- a/工作日志/2021年8月7日-今日计划.md +++ b/工作日志/2021年8月7日-今日计划.md @@ -1,8 +1,8 @@ ## 任务 - [x] 完成电话的PPT。能够有啥有意思的东西呢,无非就是推荐一两个科幻电影和科幻动漫。 -- [ ] 完成数据集的设置(加载其他类型的数据集、更多类型的非独立同分布划分和衡量方法) -- [ ] 完成实验的设置(需要对比的地方,需要考虑到可能的影响)基本达到周二要求的水准了。 +- [x] 完成数据集的设置(加载其他类型的数据集、更多类型的非独立同分布划分和衡量方法) +- [x] 完成实验的设置(需要对比的地方,需要考虑到可能的影响)基本达到周二要求的水准了。 ## 收获 diff --git a/数据库/Redis/00 目录.md b/数据库/Redis/00 目录.md deleted file mode 100644 index 4b8b4e67..00000000 --- a/数据库/Redis/00 目录.md +++ /dev/null @@ -1,58 +0,0 @@ -[《Redis 设计与实现》](http://redisbook.com/)的读书笔记 - -# 目录 - -## 第一部分:数据结构和对象 - -[2. 简单动态字符串](ch2.md) - -[3. 链表](ch3.md) - -[4. 字典](ch4.md) - -[5. 跳跃表](ch5.md) - -[6. 整数集合](ch6.md) - -[7. 压缩列表](ch7.md) - -[8. 对象](ch8.md) - -## 第二部分:单机数据库的实现 - -[9. 数据库](ch9.md) - -[10. RDB持久化](ch10.md) - -[11. AOF持久化](ch11.md) - -[12. 事件](ch12.md) - -[13. 客户端](ch13.md) - -[14. 服务器](ch14.md) - -## 第三部分:多机数据库的实现 - -[15. 复制](ch15.md) - -[16. Sentinel](ch16.md) - -[17. 集群](ch17.md) - -## 第四部分:独立功能的实现 - -[18. 发布与订阅](ch18.md) - -[19. 事务](ch19.md) - -[20. Lua脚本](ch20.md) - -[21. 排序](ch21.md) - -[22. 二进制位数组](ch22.md) - -[23. 慢查询日志](ch23.md) - -[24. 监视器](ch24.md) - diff --git a/数据库/Redis/01 Redis概述.md b/数据库/Redis/01 Redis概述.md new file mode 100644 index 00000000..cf98cd0a --- /dev/null +++ b/数据库/Redis/01 Redis概述.md @@ -0,0 +1,10 @@ +# Redis概述 + +## 概述 + + +Redis 是速度非常快的非关系型(NoSQL)内存键值数据库,可以存储键和五种不同类型的值之间的映射。 + +键的类型只能为字符串,值支持五种数据类型:字符串、列表、集合、散列表、有序集合。 + +Redis 支持很多特性,例如将内存中的数据持久化到硬盘中,使用复制来扩展读性能,使用分片来扩展写性能。 \ No newline at end of file diff --git a/数据库/Redis/02 动态字符串.md b/数据库/Redis/02 动态字符串.md deleted file mode 100644 index d1648724..00000000 --- a/数据库/Redis/02 动态字符串.md +++ /dev/null @@ -1,99 +0,0 @@ -Redis里,C字符串只会作为字符串字面量用在一些无需对字符串值进行修改的地方,比如打印日志。Redis构建了 简单动态字符串(simple dynamic string,SDS)来表示字符串值。 - -在Redis里,包含字符串值的键值对在底层都是由SDS实现的。除此之外,SDS还被用作缓冲区:AOF缓冲区,客户端状态中的输入缓冲区。 - -# 2.1 SDS的定义 - -每个sds.h/sdshdr结构表示一个SDS值: - -```c -struct sdshdr { - // 记录buf数组中已使用字节的数量 - // 等于SDS所保存字符串的长度 - int len; - - // 记录buf数组中未使用字节的数量 - int free; - - // 字节数组,用于保存字符串 - char buf[]; -} -``` - -示例: - -![sds-example](img/chap2/sds-example.png) - -SDS遵循C字符串以空字符结尾的管理,空字符不计算在len属性中。这样,SDS可以重用一部分C字符串函数库,如printf。 - -# 2.2 SDS与C字符串的区别 - -- 常数复杂度获取字符串长度 - - C字符串必须遍历整个字符串才能获得长度,复杂度是O(N)。 - - SDS在len属性中记录了SDS的长度,复杂度为O(1)。 - -- 杜绝缓冲区溢出 - - C字符串不记录长度的带来的另一个问题是缓冲区溢出。假设s1和s2是紧邻的两个字符串,对s1的strcat操作,有可能污染s2的内存空间。 - - SDS的空间分配策略杜绝了缓冲区溢出的可能性:但SDS API修改SDS时,会先检查SDS的空间是否满足修改所需的要求,不满足的话,API会将SDS的空间扩展至执行修改所需的大小,然后再执行实际的修改操作。 - -- 减少修改字符串时带来的内存重分配次数 - - 每次增长或缩短一个C字符串,程序都要对保存这个C字符串的数组进行一次内存重分配操作。 - - Redis作为数据库,数据会被平凡修改,如果每次修改字符串都会执行一次内存重分配的话,会对新嗯呢该造成影响。SDS通过未使用空间接触了字符串长度和底层数组长度的关联:在SDS中,buf数组的长度不一定就是字符数量+1,数组里面可以包含未使用的字节,由free属性记录。对于未使用空间,SDS使用了空间预分配和惰性空间释放两种优化策略: - - 1. 空间预分配:当SDS的API对SDS修改并需要空间扩展时,程序不仅为SDS分配修改所需的空间,还会分配额外的未使用空间(取决于长度是否小于1MB)。 - 2. 惰性空间释放:当SDS的API需要缩短时,程序不立即触发内存重分配,而是使用free属性将这些字节的数量记录下来,并等待将来使用。与此同时,SDS API也可以让我们真正师范未使用空间,防止内存浪费。 - -- 二进制安全 - - C字符串中的字符必须复合某种编码(如ASCII),除了字符串末尾之外,字符串里不能包含空字符。这些限制使得C字符串只能保存文本,而不是不能保存二进制数据。 - - SDS API会以处理二进制的方式处理SDS存放在buf数组中的数据,写入时什么样,读取时就是什么样。 - -- 兼容部分C字符串函数 - - 遵循C字符串以空字符结尾的管理,SDS可以重用函数库。 - - ​ - -总结: - -| C字符串 | SDS | -| ------------------- | ------------------- | -| 获取长度的复杂度O(N) | O(1) | -| API不安全,缓冲区溢出 | API安全,不会缓冲区溢出 | -| 修改字符串长度必然导致内存重分配 | 修改字符串长度不一定导致内存重分配 | -| 只能保存文本数据 | 可以保存文本或二进制数据 | -| 可使用所有库的函数 | 可使用部分库的函数 | - -# 2.3 SDS API - -| 函数 | 作用 | 时间复杂度 | -| ----------- | --------------------------------- | :-------- | -| sdsnew | 创建一个包含给定C字符串的SDS | O(N) | -| sdsempty | 创建一个不包含任何内容的SDS | O(1) | -| sdsfree | 释放SDS | O(N) | -| sdslen | 返回SDS已使用的字节数 | O(1) | -| sdsavail | 返回SDS未使用的字节数 | O(1) | -| sdsdup | 创建一个给定SDS的副本 | O(N) | -| sdsclear | 清空SDS保存的字符串内容 | O(1),惰性释放 | -| sdscat | 将给定C字符串拼接到SDS字符串的末尾 | O(N) | -| sdscatsds | 将给定SDS字符串拼接到另一个SDS的末尾 | O(N) | -| sdscpy | 复制 | O(N) | -| sdsgrowzero | 用空字符将SDS扩展至给定长度 | O(N) | -| sdsrange | 保留SDS给定区间内的数据,不在区间内的数据会被覆盖或清除 | O(N) | -| sdstrim | 接受一个SDS和C字符为参数,从SDS中移除C字符串中出现过的字符 | O(N^2) | -| sdscmp | 比较 | O(N) | - -# 导航 - -[目录](README.md) - -下一章:[3. 链表](ch3.md) - - diff --git a/数据库/Redis/02 数据类型.md b/数据库/Redis/02 数据类型.md new file mode 100644 index 00000000..859da104 --- /dev/null +++ b/数据库/Redis/02 数据类型.md @@ -0,0 +1,15 @@ +# 数据类型 + +## 0 数据类型 + + +| 数据类型 | 可以存储的值 | 操作 | +| :--: | :--: | -- | +| String | 字符串、整数或者浮点数 | 对整个字符串或者字符串的其中一部分执行操作
对整数和浮点数执行自增或者自减操作 | +| List | 列表 | 从两端压入或者弹出元素
对单个或者多个元素进行修剪,
只保留一个范围内的元素 | +| Set | 无序集合 | 添加、获取、移除单个元素
检查一个元素是否存在于集合中
计算交集、并集、差集
从集合里面随机获取元素 | +| Hash | 无序字典 | 添加、获取、移除单个键值对
获取所有键值对
检查某个键是否存在| +| Zset | 有序集合 | 添加、获取、删除元素
根据分值范围或者成员来获取元素
计算一个键的排名 | + + +![](image/2021-09-02-16-24-45.png) diff --git a/数据库/Redis/03 数据结构.md b/数据库/Redis/03 数据结构.md new file mode 100644 index 00000000..7d75960c --- /dev/null +++ b/数据库/Redis/03 数据结构.md @@ -0,0 +1,300 @@ +# 底层数据结构 +## 1 简单动态字符串SDS + + +Redis构建了 简单动态字符串(simple dynamic string,SDS)来表示字符串值。 + +SDS还被用作缓冲区:AOF缓冲区,客户端状态中的输入缓冲区。 + +### SDS 代码实现 + +每个sds.h/sdshdr结构表示一个SDS值: + +```c +struct sdshdr { + // 记录buf数组中已使用字节的数量 + // 等于SDS所保存字符串的长度 + int len; + + // 记录buf数组中未使用字节的数量 + int free; + + // 字节数组,用于保存字符串 + char buf[]; +} +``` +![sds-example](img/chap2/sds-example.png) + +SDS遵循C字符串以空字符结尾的管理,空字符不计算在len属性中。这样,SDS可以重用一部分C字符串函数库,如printf。 + +### SDS 特点(与C字符串的不同) + +- **常数复杂度获取字符串长度**。 + - C字符串必须遍历整个字符串才能获得长度,复杂度是O(N)。 + - SDS在len属性中记录了SDS的长度,复杂度为O(1)。 + +- **杜绝缓冲区溢出**。 + - C字符串不记录长度的带来的另一个问题是缓冲区溢出。假设s1和s2是紧邻的两个字符串,对s1的strcat操作,有可能污染s2的内存空间。 + - SDS的空间分配策略杜绝了缓冲区溢出的可能性:但SDS API修改SDS时,会先检查SDS的空间是否满足修改所需的要求,不满足的话,API会将SDS的空间扩展至执行修改所需的大小,然后再执行实际的修改操作。 + +- **减少修改字符串时带来的内存重分配次数**。 + - 每次增长或缩短一个C字符串,程序都要对保存这个C字符串的数组进行一次内存重分配操作。Redis作为数据库,数据会被平凡修改,如果每次修改字符串都会执行一次内存重分配的话,会对新嗯呢该造成影响。 + - SDS通过未使用空间接触了字符串长度和底层数组长度的关联:在SDS中,buf数组的长度不一定就是字符数量+1,数组里面可以包含未使用的字节,由free属性记录。对于未使用空间,SDS使用了空间预分配和惰性空间释放两种优化策略: + 1. 空间预分配:当SDS的API对SDS修改并需要空间扩展时,程序不仅为SDS分配修改所需的空间,还会分配额外的未使用空间(取决于长度是否小于1MB)。 + 2. 惰性空间释放:当SDS的API需要缩短时,程序不立即触发内存重分配,而是使用free属性将这些字节的数量记录下来,并等待将来使用。与此同时,SDS API也可以让我们真正师范未使用空间,防止内存浪费。 + +- **二进制安全**。 + - C字符串中的字符必须复合某种编码(如ASCII),除了字符串末尾之外,字符串里不能包含空字符。这些限制使得C字符串只能保存文本,而不是不能保存二进制数据。 + - SDS API会以处理二进制的方式处理SDS存放在buf数组中的数据,写入时什么样,读取时就是什么样。 + +- **兼容部分C字符串函数**。遵循C字符串以空字符结尾的管理,SDS可以重用函数库。 + + ​ + +| C字符串 | SDS | +| ------------------- | ------------------- | +| 获取长度的复杂度O(N) | O(1) | +| API不安全,缓冲区溢出 | API安全,不会缓冲区溢出 | +| 修改字符串长度必然导致内存重分配 | 修改字符串长度不一定导致内存重分配 | +| 只能保存文本数据 | 可以保存文本或二进制数据 | +| 可使用所有库的函数 | 可使用部分库的函数 | + +### SDS API + +| 函数 | 作用 | 时间复杂度 | +| ----------- | --------------------------------- | :-------- | +| sdsnew | 创建一个包含给定C字符串的SDS | O(N) | +| sdsempty | 创建一个不包含任何内容的SDS | O(1) | +| sdsfree | 释放SDS | O(N) | +| sdslen | 返回SDS已使用的字节数 | O(1) | +| sdsavail | 返回SDS未使用的字节数 | O(1) | +| sdsdup | 创建一个给定SDS的副本 | O(N) | +| sdsclear | 清空SDS保存的字符串内容 | O(1),惰性释放 | +| sdscat | 将给定C字符串拼接到SDS字符串的末尾 | O(N) | +| sdscatsds | 将给定SDS字符串拼接到另一个SDS的末尾 | O(N) | +| sdscpy | 复制 | O(N) | +| sdsgrowzero | 用空字符将SDS扩展至给定长度 | O(N) | +| sdsrange | 保留SDS给定区间内的数据,不在区间内的数据会被覆盖或清除 | O(N) | +| sdstrim | 接受一个SDS和C字符为参数,从SDS中移除C字符串中出现过的字符 | O(N^2) | +| sdscmp | 比较 | O(N) | + + +## 2 链表 + +Redis构建了自己的链表实现。列表键的底层实现之一就是链表。 + +发布、订阅、慢查询、监视器都用到了链表。Redis服务器还用链表保存多个客户端的状态信息,以及构建客户端输出缓冲区。 + +### 双向链表 代码实现 + +链表节点用adlist.h/listNode结构来表示 + +```c +typedef struct listNode { + struct listNode *prev; + struct listNode *next; + void *value; +} listNode; +``` + +![listNode](img/chap3/listNode.png) + +adlist.h/list来持有链表: + +```c +typedef struct list { + listNode *head; + listNode *tail; + unsigned long len; + void *(dup)(void *ptr); // 节点复制函数 + void (*free)(void *ptr); // 节点释放函数 + int (*match)(void *ptr, void *key); // 节点值对比函数 +} list; +``` + + ![list](img/chap3/list.png) + +### 链表 特点 + +1. 双向无环。表头结点的prev和表尾节点的next都指向NULL +2. 带表头指针和表尾指针 +3. 带链表长度计数器 +4. 多态。使用void*指针来保存节点值,并通过list结构的dup、free。match三个属性为节点值设置类型特定函数 + +### 链表 API + +| 函数 | 作用 | 复杂度 | +| ---------------------------------------- | ------------------------------------- | ------ | +| listSetDupMethod, listSetFreeMethod, listSetMatchMethod | 将给定函数设置为链表的节点值复制/释放/对比函数 | O(1) | +| listGetDupMethod, listGetFreeMethod, listGetMatchMethod | | O(1) | +| listLength | 返回链表长度 | O(1) | +| listFrist | 返回表头结点 | O(1) | +| listLast | 返回表尾结点 | O(1) | +| listPrevNode, listNextNode | 返回给定节点的前置/后置节点 | O(1) | +| listNodeValue | 返回给定节点目前正在保存的值 | O(1) | +| listCreate | 创建一个不包含任何节点的新链表 | O(1) | +| listAddNodeHead, listAddNodeTail | 将一个包含给定值的新节点添加到表头/表尾 | O(1) | +| listSearchKey | 查找并返回包含给定值的节点 | *O(N)* | +| listIndex | 返回链表在给定索引上的节点 | *O(N)* | +| listDelNote | 删除给定节点 | *O(N)* | +| listRotate | 将链表的表尾结点弹出,然后将被弹出的节点插入到链表的表头,成为新的表头结点 | O(1) | +| listDup | 复制一个给定链表的副本 | *O(N)* | +| listRelease | 释放给定链表,及所有节点 | *O(N)* | + + +## 3 字典 + +Redis的数据库就是使用字典来作为底层实现的,对数据库的增删改查都是构建在字典的操作之上。 + +字典还是哈希键的底层实现之一,但一个哈希键包含的键值对比较多,又或者键值对中的元素都是较长的字符串时,Redis就会用字典作为哈希键的底层实现。 + +### 字典的实现 + +Redis的字典使用**哈希表**作为底层实现,每个哈希表节点就保存了字典中的一个键值对。 + +Redis字典所用的**哈希表**由dict.h/dictht结构定义: + +```c +typedef struct dictht { + // 哈希表数组 + dict Entry **table; + // 哈希表大小 + unsigned long size; + // 哈希表大小掩码,用于计算索引值,总是等于size - 1 + unsigned long sizemask; + // 该哈希表已有节点的数量 + unsigned long used; +} dictht; +``` + +**哈希表节点**使用dictEntry结构表示,每个dictEntry结构都保存着一个键值对: + +```c +typedef struct dictEntry { + void *key; // 键 + + // 值 + union { + void *val; + uint64_t u64; + int64_t s64; + } v; + + // 指向下个哈希表节点,形成链表。一次解决键冲突的问题 + struct dictEntry *next; +} +``` + +![k1-k0](img/chap4/k1-k0.png) + +Redis中的**字典**由dict.h/dict结构表示: + +```c +typedef struct dict { + dictType *type; // 类型特定函数 + void *privdata; // 私有数据 + + /* + 哈希表 + 一般情况下,字典只是用ht[0]哈希表,ht[1]只会在对ht[0]哈希表进行rehash时是用 + */ + dictht ht[2]; + + // rehash索引,但rehash不在进行时,值为-1 + // 记录了rehash的进度 + int trehashidx; +} dict; +``` + +type和privdata是针对不同类型的键值对,为创建多态字典而设置的: + +- type是一个指向dictType结构的指针,每个dictType都保存了一簇用于操作特定类型键值对的函数,Redis会为用途不同的字典设置不同的类型特定函数。 +- privdata保存了需要传给那些类型特定函数的可选参数。 + +```c +typedef struct dictType { + // 计算哈希值的函数 + unsigned int (*hashFunction) (const void *key); + + // 复制键的函数 + void *(*keyDup) (void *privdata, const void *obj); + + // 对比键的函数 + void *(*keyCompare) (void *privdata, const void *key1, const void *key2); + + // 销毁键的函数 + void (*keyDestructor) (void *privdata, void *key); + + // 销毁值的函数 + void (*valDestructor) (void *privdata, void *obj); +} dictType; +``` + +### 哈希算法 + +Redis计算哈希值和索引值的方法如下: + +```python +# 使用字典设置的哈希函数,计算key的哈希值 +hash = dict.type.hashFucntion(key) +# 使用哈希表的sizemask属性和哈希值,计算出索引值 +# 根据情况的不同,ht[x]可以使ht[0]或ht[1] +index = hash & dict.ht[x].sizemask +``` + +当字典被用作数据库或哈希键的底层实现时,使用MurmurHash2算法来计算哈希值,即使输入的键是有规律的,算法人能有一个很好的随机分布性,计算速度也很快。 + +### 解决键冲突 + +Redis使用链地址法解决键冲突,每个哈希表节点都有个next指针。 + + ![collision](img/chap4/collision.png) + +### rehash + +随着操作的不断执行,哈希表保存的键值对会增加或减少。为了让哈希表的负载因子维持在合理范围,需要对哈希表的大小进行扩展或收缩,即通过执行rehash(重新散列)来完成: + +1. 为字典的ht[1]哈希表分配空间: + 1. 如果执行的是扩展操作,ht[1]的大小为第一个大于等于ht[0].used * 2 的2^n + 2. 如果执行的是收缩操作,ht[1]的大小为第一个大于等于ht[0].used的2^n + +2. 将保存在ht[0]中的所有键值对rehash到ht[1]上。rehash是重新设计的计算键的哈希值和索引值 + +3. 释放ht[0],将ht[1]设置为ht[0],并为ht[1]新建一个空白哈希表 + +## 哈希表的扩展与收缩 + +满足一下任一条件,程序会自动对哈希表执行扩展操作: + +1. 服务器目前没有执行BGSAVE或BGREWRITEAOF,且哈希表负载因子大于等于1 +2. 服务器正在执行BGSAVE或BGREWRITEAOF,且负载因子大于5 + +其中负载因子的计算公式: + +```python +# 负载因子 = 哈希表已保存节点数量 / 哈希表大小 +load_factor = ht[0].used / ht[0].size +``` + +注:执行BGSAVE或BGREWRITEAOF过程中,Redis需要创建当前服务器进程的子进程,而多数操作系统都是用写时复制来优化子进程的效率,所以在子进程存在期间,服务器会提高执行扩展操作所需的负载因子,从而尽可能地避免在子进程存在期间扩展哈希表,避免不避免的内存写入,节约内存。 + +# 4.5 渐进式rehash + +将ht[0]中的键值对rehash到ht[1]中的操作不是一次性完成的,而是分多次渐进式的: + +1. 为ht[1]分配空间 +2. 在字典中维持一个索引计数器变量rehashidx,设置为0,表示rehash工作正式开始 +3. rehash期间,**每次对字典的增删改查操作**,会顺带将ht[0]在rehashidx索引上的所有键值对rehash到ht[1],rehash完成之后,rehashidx属性的值+1 +4. 最终ht[0]会全部rehash到ht[1],这是将rehashidx设置为-1,表示rehash完成 + +渐进式rehash过程中,字典会有两个哈希表,字典的增删改查会在两个哈希表上进行。 + +# 4.6 字典API + +| 函数 | 作用 | 时间复杂度 | +| ---------------- | --------------- | ----- | +| dictCreate | 创建一个新的字典 | O(1) | +| dictAdd | 添加键值对 | O(1) | +| dictReplace | 添加键值对,如已存在,替换原有 | O(1) | +| dictFetchValue | 返回给定键的值 | O(1) | +| dictGetRandomKey | 随机返回一个键值对 | O(1) | diff --git a/数据库/Redis/03 链表.md b/数据库/Redis/03 链表.md deleted file mode 100644 index 92b176b2..00000000 --- a/数据库/Redis/03 链表.md +++ /dev/null @@ -1,67 +0,0 @@ -Redis构建了自己的链表实现。列表键的底层实现之一就是链表。发布、订阅、慢查询、监视器都用到了链表。Redis服务器还用链表保存多个客户端的状态信息,以及构建客户端输出缓冲区。 - -# 3.1 链表和链表节点的实现 - -链表节点用adlist.h/listNode结构来表示 - -```c -typedef struct listNode { - struct listNode *prev; - struct listNode *next; - void *value; -} listNode; -``` - - ![listNode](img/chap3/listNode.png) - -adlist.h/list来持有链表: - -```c -typedef struct list { - listNode *head; - listNode *tail; - unsigned long len; - void *(dup)(void *ptr); // 节点复制函数 - void (*free)(void *ptr); // 节点释放函数 - int (*match)(void *ptr, void *key); // 节点值对比函数 -} list; -``` - - ![list](img/chap3/list.png) - -Redis的链表实现可总结如下: - -1. 双向 -2. 无环。表头结点的prev和表尾节点的next都指向NULL -3. 带表头指针和表尾指针 -4. 带链表长度计数器 -5. 多态。使用void*指针来保存节点值,并通过list结构的dup、free。match三个属性为节点值设置类型特定函数 - -# 3.2 链表和链表节点的API - -| 函数 | 作用 | 复杂度 | -| ---------------------------------------- | ------------------------------------- | ------ | -| listSetDupMethod, listSetFreeMethod, listSetMatchMethod | 将给定函数设置为链表的节点值复制/释放/对比函数 | O(1) | -| listGetDupMethod, listGetFreeMethod, listGetMatchMethod | | O(1) | -| listLength | 返回链表长度 | O(1) | -| listFrist | 返回表头结点 | O(1) | -| listLast | 返回表尾结点 | O(1) | -| listPrevNode, listNextNode | 返回给定节点的前置/后置节点 | O(1) | -| listNodeValue | 返回给定节点目前正在保存的值 | O(1) | -| listCreate | 创建一个不包含任何节点的新链表 | O(1) | -| listAddNodeHead, listAddNodeTail | 将一个包含给定值的新节点添加到表头/表尾 | O(1) | -| listSearchKey | 查找并返回包含给定值的节点 | *O(N)* | -| listIndex | 返回链表在给定索引上的节点 | *O(N)* | -| listDelNote | 删除给定节点 | *O(N)* | -| listRotate | 将链表的表尾结点弹出,然后将被弹出的节点插入到链表的表头,成为新的表头结点 | O(1) | -| listDup | 复制一个给定链表的副本 | *O(N)* | -| listRelease | 释放给定链表,及所有节点 | *O(N)* | - -# 导航 - -[目录](README.md) - -上一章:[2. 简单动态字符串](ch2.md) - -下一章:[4. 字典](ch4.md) - diff --git a/数据库/Redis/04 字典.md b/数据库/Redis/04 字典.md index 9804e28a..05ab8483 100644 --- a/数据库/Redis/04 字典.md +++ b/数据库/Redis/04 字典.md @@ -1,159 +1,3 @@ -Redis的数据库就是使用字典来作为底层实现的,对数据库的增删改查都是构建在字典的操作之上。 - -字典还是哈希键的底层实现之一,但一个哈希键包含的键值对比较多,又或者键值对中的元素都是较长的字符串时,Redis就会用字典作为哈希键的底层实现。 - -# 4.1 字典的实现 - -Redis的字典使用**哈希表**作为底层实现,每个哈希表节点就保存了字典中的一个键值对。 - -Redis字典所用的**哈希表**由dict.h/dictht结构定义: - -```c -typedef struct dictht { - // 哈希表数组 - dict Entry **table; - // 哈希表大小 - unsigned long size; - // 哈希表大小掩码,用于计算索引值,总是等于size - 1 - unsigned long sizemask; - // 该哈希表已有节点的数量 - unsigned long used; -} dictht; -``` - -**哈希表节点**使用dictEntry结构表示,每个dictEntry结构都保存着一个键值对: - -```c -typedef struct dictEntry { - void *key; // 键 - - // 值 - union { - void *val; - uint64_t u64; - int64_t s64; - } v; - - // 指向下个哈希表节点,形成链表。一次解决键冲突的问题 - struct dictEntry *next; -} -``` - -![k1-k0](img/chap4/k1-k0.png) - -Redis中的**字典**由dict.h/dict结构表示: - -```c -typedef struct dict { - dictType *type; // 类型特定函数 - void *privdata; // 私有数据 - - /* - 哈希表 - 一般情况下,字典只是用ht[0]哈希表,ht[1]只会在对ht[0]哈希表进行rehash时是用 - */ - dictht ht[2]; - - // rehash索引,但rehash不在进行时,值为-1 - // 记录了rehash的进度 - int trehashidx; -} dict; -``` - -type和privdata是针对不同类型大家键值对,为创建多态字典而设置的: - -- type是一个指向dictType结构的指针,每个dictType都保存了一簇用于操作特定类型键值对的函数,Redis会为用途不同的字典设置不同的类型特定函数。 -- privdata保存了需要传给那些类型特定函数的可选参数。 - -```c -typedef struct dictType { - // 计算哈希值的函数 - unsigned int (*hashFunction) (const void *key); - - // 复制键的函数 - void *(*keyDup) (void *privdata, const void *obj); - - // 对比键的函数 - void *(*keyCompare) (void *privdata, const void *key1, const void *key2); - - // 销毁键的函数 - void (*keyDestructor) (void *privdata, void *key); - - // 销毁值的函数 - void (*valDestructor) (void *privdata, void *obj); -} dictType; -``` - -# 4.2 哈希算法 - -Redis计算哈希值和索引值的方法如下: - -```python -# 使用字典设置的哈希函数,计算key的哈希值 -hash = dict.type.hashFucntion(key) -# 使用哈希表的sizemask属性和哈希值,计算出索引值 -# 根据情况的不同,ht[x]可以使ht[0]或ht[1] -index = hash & dict.ht[x].sizemask -``` - -当字典被用作数据库或哈希键的底层实现时,使用MurmurHash2算法来计算哈希值,即使输入的键是有规律的,算法人能有一个很好的随机分布性,计算速度也很快。 - -# 4.3 解决键冲突 - -Redis使用链地址法解决键冲突,每个哈希表节点都有个next指针。 - - ![collision](img/chap4/collision.png) - -# 4.4 rehash - -随着操作的不断执行,哈希表保存的键值对会增加或减少。为了让哈希表的负载因子维持在合理范围,需要对哈希表的大小进行扩展或收缩,即通过执行rehash(重新散列)来完成: - -1. 为字典的ht[1]哈希表分配空间: - - 如果执行的是扩展操作,ht[1]的大小为第一个大于等于ht[0].used * 2 的2^n - - 如果执行的是收缩操作,ht[1]的大小为第一个大于等于ht[0].used的2^n - -2. 将保存在ht[0]中的所有键值对rehash到ht[1]上。rehash是重新设计的计算键的哈希值和索引值 - -3. 释放ht[0],将ht[1]设置为ht[0],并为ht[1]新建一个空白哈希表 - -## 哈希表的扩展与收缩 - -满足一下任一条件,程序会自动对哈希表执行扩展操作: - -1. 服务器目前没有执行BGSAVE或BGREWRITEAOF,且哈希表负载因子大于等于1 -2. 服务器正在执行BGSAVE或BGREWRITEAOF,且负载因子大于5 - -其中负载因子的计算公式: - -```python -# 负载因子 = 哈希表已保存节点数量 / 哈希表大小 -load_factor = ht[0].used / ht[0].size -``` - -注:执行BGSAVE或BGREWRITEAOF过程中,Redis需要创建当前服务器进程的子进程,而多数操作系统都是用写时复制来优化子进程的效率,所以在子进程存在期间,服务器会提高执行扩展操作所需的负载因子,从而尽可能地避免在子进程存在期间扩展哈希表,避免不避免的内存写入,节约内存。 - -# 4.5 渐进式rehash - -将ht[0]中的键值对rehash到ht[1]中的操作不是一次性完成的,而是分多次渐进式的: - -1. 为ht[1]分配空间 -2. 在字典中维持一个索引计数器变量rehashidx,设置为0,表示rehash工作正式开始 -3. rehash期间,**每次对字典的增删改查操作**,会顺带将ht[0]在rehashidx索引上的所有键值对rehash到ht[1],rehash完成之后,rehashidx属性的值+1 -4. 最终ht[0]会全部rehash到ht[1],这是将rehashidx设置为-1,表示rehash完成 - -渐进式rehash过程中,字典会有两个哈希表,字典的增删改查会在两个哈希表上进行。 - -# 4.6 字典API - -| 函数 | 作用 | 时间复杂度 | -| ---------------- | --------------- | ----- | -| dictCreate | 创建一个新的字典 | O(1) | -| dictAdd | 添加键值对 | O(1) | -| dictReplace | 添加键值对,如已存在,替换原有 | O(1) | -| dictFetchValue | 返回给定键的值 | O(1) | -| dictGetRandomKey | 随机返回一个键值对 | O(1) | # 导航 diff --git a/数据库/Redis/image/2021-09-02-16-24-45.png b/数据库/Redis/image/2021-09-02-16-24-45.png new file mode 100644 index 0000000000000000000000000000000000000000..f808795e9524df9a57e2374bc42404b5e2de6a06 GIT binary patch literal 30909 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 -* [Redis](#redis) - * [一、概述](#一概述) - * [二、数据类型](#二数据类型) - * [STRING](#string) - * [LIST](#list) - * [SET](#set) - * [HASH](#hash) - * [ZSET](#zset) - * [三、数据结构](#三数据结构) - * [字典](#字典) - * [跳跃表](#跳跃表) - * [四、使用场景](#四使用场景) - * [计数器](#计数器) - * [缓存](#缓存) - * [查找表](#查找表) - * [消息队列](#消息队列) - * [会话缓存](#会话缓存) - * [分布式锁实现](#分布式锁实现) - * [其它](#其它) - * [五、Redis 与 Memcached](#五redis-与-memcached) - * [数据类型](#数据类型) - * [数据持久化](#数据持久化) - * [分布式](#分布式) - * [内存管理机制](#内存管理机制) - * [六、键的过期时间](#六键的过期时间) - * [七、数据淘汰策略](#七数据淘汰策略) - * [八、持久化](#八持久化) - * [RDB 持久化](#rdb-持久化) - * [AOF 持久化](#aof-持久化) - * [九、事务](#九事务) - * [十、事件](#十事件) - * [文件事件](#文件事件) - * [时间事件](#时间事件) - * [事件的调度与执行](#事件的调度与执行) - * [十一、复制](#十一复制) - * [连接过程](#连接过程) - * [主从链](#主从链) - * [十二、Sentinel](#十二sentinel) - * [十三、分片](#十三分片) - * [十四、一个简单的论坛系统分析](#十四一个简单的论坛系统分析) - * [文章信息](#文章信息) - * [点赞功能](#点赞功能) - * [对文章进行排序](#对文章进行排序) - * [参考资料](#参考资料) +- [Redis](#redis) + - [二、数据类型](#二数据类型) + - [STRING](#string) + - [LIST](#list) + - [SET](#set) + - [HASH](#hash) + - [ZSET](#zset) + - [三、数据结构](#三数据结构) + - [字典](#字典) + - [跳跃表](#跳跃表) + - [四、使用场景](#四使用场景) + - [计数器](#计数器) + - [缓存](#缓存) + - [查找表](#查找表) + - [消息队列](#消息队列) + - [会话缓存](#会话缓存) + - [分布式锁实现](#分布式锁实现) + - [其它](#其它) + - [五、Redis 与 Memcached](#五redis-与-memcached) + - [数据类型](#数据类型) + - [数据持久化](#数据持久化) + - [分布式](#分布式) + - [内存管理机制](#内存管理机制) + - [六、键的过期时间](#六键的过期时间) + - [七、数据淘汰策略](#七数据淘汰策略) + - [八、持久化](#八持久化) + - [RDB 持久化](#rdb-持久化) + - [AOF 持久化](#aof-持久化) + - [九、事务](#九事务) + - [十、事件](#十事件) + - [文件事件](#文件事件) + - [时间事件](#时间事件) + - [事件的调度与执行](#事件的调度与执行) + - [十一、复制](#十一复制) + - [连接过程](#连接过程) + - [主从链](#主从链) + - [十二、Sentinel](#十二sentinel) + - [十三、分片](#十三分片) + - [十四、一个简单的论坛系统分析](#十四一个简单的论坛系统分析) + - [文章信息](#文章信息) + - [点赞功能](#点赞功能) + - [对文章进行排序](#对文章进行排序) + - [参考资料](#参考资料) -## 一、概述 - -Redis 是速度非常快的非关系型(NoSQL)内存键值数据库,可以存储键和五种不同类型的值之间的映射。 - -键的类型只能为字符串,值支持五种数据类型:字符串、列表、集合、散列表、有序集合。 - -Redis 支持很多特性,例如将内存中的数据持久化到硬盘中,使用复制来扩展读性能,使用分片来扩展写性能。 - ## 二、数据类型 -| 数据类型 | 可以存储的值 | 操作 | -| :--: | :--: | :--: | -| STRING | 字符串、整数或者浮点数 | 对整个字符串或者字符串的其中一部分执行操作\ 对整数和浮点数执行自增或者自减操作 | -| LIST | 列表 | 从两端压入或者弹出元素 \ 对单个或者多个元素进行修剪,\ 只保留一个范围内的元素 | -| SET | 无序集合 | 添加、获取、移除单个元素\ 检查一个元素是否存在于集合中\ 计算交集、并集、差集\ 从集合里面随机获取元素 | -| HASH | 包含键值对的无序散列表 | 添加、获取、移除单个键值对\ 获取所有键值对\ 检查某个键是否存在| -| ZSET | 有序集合 | 添加、获取、删除元素\ 根据分值范围或者成员来获取元素\ 计算一个键的排名 | - -> [What Redis data structures look like](https://redislabs.com/ebook/part-1-getting-started/chapter-1-getting-to-know-redis/1-2-what-redis-data-structures-look-like/) - ### STRING

@@ -559,7 +540,7 @@ Sentinel(哨兵)可以监听集群中的服务器,并在主服务器进入 假设有 4 个 Redis 实例 R0,R1,R2,R3,还有很多表示用户的键 user:1,user:2,... ,有不同的方式来选择一个指定的键存储在哪个实例中。 -- 最简单的方式是范围分片,例如用户 id 从 0\~1000 的存储到实例 R0 中,用户 id 从 1001\~2000 的存储到实例 R1 中,等等。但是这样需要维护一张映射范围表,维护操作代价很高。 +- 最简单的方式是范围分片,例如用户 id 从 0~1000 的存储到实例 R0 中,用户 id 从 1001~2000 的存储到实例 R1 中,等等。但是这样需要维护一张映射范围表,维护操作代价很高。 - 还有一种方式是哈希分片,使用 CRC32 哈希函数将键转换为一个数字,再对实例数量求模就能知道应该存储的实例。 根据执行分片的位置,可以分为三种分片方式: diff --git a/数据库/Redis/01 Redis笔记.md b/数据库/Redis/附录2 Redis笔记.md similarity index 100% rename from 数据库/Redis/01 Redis笔记.md rename to 数据库/Redis/附录2 Redis笔记.md diff --git a/数据库/数据库.xmind b/数据库/数据库.xmind index 821e877e8f84d2605430a1e09ce79067eed14d07..563e6e5cd065264c266381256929be539899047f 100644 GIT binary patch delta 16141 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