From f68eca792d9b1832420184b6df7926457c103521 Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Fri, 5 Aug 2022 14:57:05 +0800
Subject: [PATCH 1/5] =?UTF-8?q?[=E6=96=87=E6=A1=A3=E4=BF=AE=E6=94=B9](mast?=
=?UTF-8?q?er):=20=E6=9B=B4=E6=96=B0=E4=BA=86=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
更新了文档
---
best-practice/bd-support-project/README.md | 0
best-practice/my-ms-project/README.md | 15 ++++
.../.gitignore | 46 +++++++++++
.../README.md | 82 +++++++++++++++++++
.../dev-protocol-springcloud-alibaba/pom.xml | 22 +++++
pom.xml | 1 +
6 files changed, 166 insertions(+)
create mode 100644 best-practice/bd-support-project/README.md
create mode 100644 best-practice/my-ms-project/README.md
create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-alibaba/.gitignore
create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-alibaba/README.md
create mode 100644 dev-protocol-springcloud/dev-protocol-springcloud-alibaba/pom.xml
diff --git a/best-practice/bd-support-project/README.md b/best-practice/bd-support-project/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/best-practice/my-ms-project/README.md b/best-practice/my-ms-project/README.md
new file mode 100644
index 0000000..d7fe773
--- /dev/null
+++ b/best-practice/my-ms-project/README.md
@@ -0,0 +1,15 @@
+# 介绍
+- 自己的微服务项目, 整合所有的微服务技术来解决一业务问题
+
+## 项目架构
+- 广告系统
+- 电商系统
+- IM系统
+- 活动系统
+- SCRM系统
+- 视频系统
+- 撮合系统
+- 支付系统
+- 搜索系统
+- 办公系统
+-
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/.gitignore b/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/.gitignore
new file mode 100644
index 0000000..d4beec9
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/.gitignore
@@ -0,0 +1,46 @@
+### Example user template template
+### Example user template
+
+# IntelliJ project files
+.idea
+*.iml
+out
+gen
+### Maven template
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+# https://github.com/takari/maven-wrapper#usage-without-binary-jar
+.mvn/wrapper/maven-wrapper.jar
+
+### Java template
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/README.md b/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/README.md
new file mode 100644
index 0000000..c1398ea
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/README.md
@@ -0,0 +1,82 @@
+# SpringCloud
+
+## 1. 概念综述
+
+- 参考: https://github.com/alibaba/spring-cloud-alibaba/wiki/
+ - 版本选择
+ - 开源组件
+ - Nacos Config
+ - Nacos Discovery
+ - Sentinel
+ - RocketMQ
+ - Dubbo Spring Cloud
+ - 商业化组件
+ - OSS
+ - SchedulerX
+ - SMS
+ - Example
+ - Sentinel
+ - Nacos Config
+ - Nacos Discovery
+ - RocketMQ
+ - OSS
+ - SMS
+ - Dubbo Spring Cloud
+- 视频: https://coding.imooc.com/class/chapter/358.html#Anchor
+-
+
+## 2. 服务发现-Nacos
+
+
+## 3. 实现负载均衡-Ribbon
+
+
+## 4. 声明式HTTP客户端-Feign
+
+
+## 5. 服务容错-Sentinel
+
+
+## 6. 消息驱动的微服务-Spring Cloud Alibaba RocketMQ
+
+
+## 7. API网关-Spring Cloud Gateway
+
+
+## 8. 微服务的用户认证与授权
+
+
+## 9. 配置管理-Nacos
+
+
+## 10. 调用链监控-Sleuth
+
+
+## 11. 多维度微服务监控
+
+
+## 12. 完美融合异构微服务
+
+
+## 13. Spring Cloud Alibaba升级
+
+
+## 14. SpringBoot Admin 微服务应用监控
+
+
+## 15. SpringCloud Sleuth + Zipkin：分布式日志追踪
+
+
+## 16. 微服务通信 Ribbon + OpenFeign
+
+
+## 17. SpringCloud Netflix Hystrix 实现微服务容错
+
+
+## 18. Seata：分布式事务解决方案
+
+
+## 19. 基于 SpringCloud Alibaba Sentinel 实现网关动态限流
+
+
+## 20. 微服务工程部署与整体可用性验证
\ No newline at end of file
diff --git a/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/pom.xml b/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/pom.xml
new file mode 100644
index 0000000..b3a0563
--- /dev/null
+++ b/dev-protocol-springcloud/dev-protocol-springcloud-alibaba/pom.xml
@@ -0,0 +1,22 @@
+
+
+
+ dev-protocol
+ org.example
+ 1.0-SNAPSHOT
+ ../../pom.xml
+
+
+
+ 4.0.0
+ dev-protocol-springcloud-alibaba
+ 1.0.0-RELEASE
+
+
+ 8
+ 8
+
+
+
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 8527b1a..4d4e5bb 100644
--- a/pom.xml
+++ b/pom.xml
@@ -37,6 +37,7 @@
mq/rocketmq/springboot-rocketmq
dev-protocol-springcloud
dev-protocol-springcloud/dev-protocol-springcloud-stream
+ dev-protocol-springcloud/dev-protocol-springcloud-alibaba
longpolling/demo/demo2/dev-protocol-disruptor-demo
longpolling/netty/better-netty
longpolling/demo/demo3/dev-protocol-netty-client
From e4870045bf95c7337d3c4fe8e16c4f936f292050 Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Sat, 6 Aug 2022 21:50:06 +0800
Subject: [PATCH 2/5] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E6=96=87?=
=?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
longpolling/practice/README.md | 0
mq/README.md | 0
2 files changed, 0 insertions(+), 0 deletions(-)
create mode 100644 longpolling/practice/README.md
create mode 100644 mq/README.md
diff --git a/longpolling/practice/README.md b/longpolling/practice/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/mq/README.md b/mq/README.md
new file mode 100644
index 0000000..e69de29
From 340580bd52f44b7a26209b5d78abd9f797400f11 Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Sat, 6 Aug 2022 21:57:37 +0800
Subject: [PATCH 3/5] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E6=96=87?=
=?UTF-8?q?=E6=A1=A31?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
longpolling/README.md | 39 +++++-
longpolling/netty/README.md | 9 --
longpolling/practice/README.md | 55 ++++++++
mq/README.md | 75 +++++++++++
mq/rocketmq/README.md | 227 ++++++++++++++++++++++++++++++++-
5 files changed, 394 insertions(+), 11 deletions(-)
diff --git a/longpolling/README.md b/longpolling/README.md
index e7e6da4..c745b0c 100644
--- a/longpolling/README.md
+++ b/longpolling/README.md
@@ -1,3 +1,23 @@
+# 项目介绍
+- demo
+ - demo1 Disruptor 与 Netty 的整合
+ - demo2 Disruptor
+ - demo3 Netty与 SpringBoot 整合
+- netty
+ - better-netty Netty 的深入研究和学习
+
+
+
+# 参考文章
+- 阿里云开发者社区
+ - 现代IM系统中的消息系统架构 - 实现篇 https://my.oschina.net/yunqi/blog/3078531
+ - 现代IM系统中的消息系统架构 - 模型篇 https://developer.aliyun.com/article/701593
+ - 现代IM系统中的消息系统架构 - 架构篇 https://developer.aliyun.com/article/698301
+-
+
+
+
+
# Disruptor
@@ -13,4 +33,21 @@
- Memory Barrier
-## 3.
\ No newline at end of file
+## 3.
+坐席传来的新消息都存入 localstorage 中，其他页签监听 localstorage 的变化取出数据进行渲染
+
+Java 实现 UDP 传输方式同步发送并接收消息
+- https://my.oschina.net/u/3986411/blog/5482852
+JackJiang2020
+- https://my.oschina.net/u/4231722
+JackJiang-
+- https://my.oschina.net/jb2011
+
+
+
+
+
+
+
+
+
diff --git a/longpolling/netty/README.md b/longpolling/netty/README.md
index b667f05..0ab2fa4 100644
--- a/longpolling/netty/README.md
+++ b/longpolling/netty/README.md
@@ -1,14 +1,5 @@
# Netty
-## 成就点
-- 负责公司千万级别实时在线用户长连消息推送系统
-- 企业社交 Sass 完美解决方案
-
-## 主要方案
-- 完美应用示例(十万级): 线程池异步业务 + (Linux 句柄) + 单机Netty + 日志
-- 异步化完美方案(百万级): 线程池异步业务 + (Linux 句柄) + HA高可用 + 日志
-- 多服务端解决方案(千万级): Disruptor异步业务 + (Linux 句柄) + HA高可用 + 日志
-
## 参考资料
- https://www.imooc.com/t/6224286 慕课网牛人教程
-
diff --git a/longpolling/practice/README.md b/longpolling/practice/README.md
index e69de29..b33759a 100644
--- a/longpolling/practice/README.md
+++ b/longpolling/practice/README.md
@@ -0,0 +1,55 @@
+# 架构实战方案
+
+## 业务特点
+- 消息收发的及时性
+- 消息收发的准确性
+- 消息记录的检索高效
+- 消息的收送高可靠
+- 方便进行演进扩展
+- 无感知停机上线
+
+## 成就点
+- 企业级 千万用户实时在线长连消息推送系统
+- 企业级 消息长链接 Sass 架构完美解决方案
+
+## 消息推送主要方案
+- 完美应用示例(十万级): 线程池异步业务 + (Linux 句柄) + 单机Netty + 日志
+- 异步化完美方案(百万级): 线程池异步业务 + (Linux 句柄) + HA高可用 + 日志
+- 多服务端解决方案(千万级): Disruptor异步业务 + (Linux 句柄) + HA高可用 + 日志
+
+## 消息增量同步方案
+- 数据增量同步方案 https://blog.csdn.net/godlovedaniel/article/details/120220878
+- 观察者模式 消息收发模型和同步方案的一些心得 https://www.imooc.com/article/19165
+-
+
+
+
+## 数据架构存储方法
+- MYSQL数同步方案 https://www.jb51.net/article/230528.htm
+-
+
+
+
+## 消息服务部署方案
+
+
+
+
+## 消息服务上线/更新方案
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/mq/README.md b/mq/README.md
index e69de29..cc1aab1 100644
--- a/mq/README.md
+++ b/mq/README.md
@@ -0,0 +1,75 @@
+# 消息中间件相关的知识
+
+## 技术调研: Kafka RocketMQ RabbitMQ 技术选型
+- 其实技术调研说白了，就是对一个技术去找到一些业内常用的开源实现，然后对各种不同的实现都进行一些调研，对比一
+ 下他们的优劣势，看看谁比较符合我们的需求，谁比较适合我们来使用。
+
+### 1. 思考的问题
+- 业内常用的MQ有哪些?
+- 每一种MQ各自的表现如何?
+- 这些MQ在同等机器条件下，能抗多少QPS(每秒抗几千QPS还是几万QPS)?
+- 性能有多高(发送一条消息给他要2ms还是20ms)?
+- 可用性能不能得到保证(要是MQ部署的机器挂了怎么办)?
+- 他们会不会丢失数据?
+- 如果需要的话能否让他们进行线性的集群扩容(就是多加几台机器)?
+- 消息中间件经常需要使用的一些功能他们都有吗(比如说延迟消息、事务消息、消息堆积、消息回溯、死信队列，等等)?
+- 这些MQ在文档是否齐全?社区是否活跃?在行业内是否广泛运用?是用什么语言编写的?
+
+### 2. Kafka、RabbitMQ以及RocketMQ的调研对比
+
+#### 2.1 Kafka的优势和劣势
+- 优势
+ - Kafka的吞吐量几乎是行业里最优秀的，在常规的机器配置下，一台机器 可以达到每秒十几万的QPS，相当的强悍。
+ - Kafka性能也很高，基本上发送消息给Kafka都是毫秒级的性能。
+ - 可用性也很高，Kafka是可以支持集群部署的，其中部分机器宕机是可以继续运行的。
+- 劣势
+ - Kafka比较为人诟病的一点，似乎是丢数据方面的问题，因为Kafka收到消息之后会写入一个磁盘缓冲区里，并没有直接落地到物理
+ 磁盘上去，所以要是机器本身故障了，可能会导致磁盘缓冲区里的数据丢失。
+ - Kafka另外一个比较大的缺点，就是功能非常的单一，主要是支持发送消息给他，然后从里面消费消息，其他就没有什么额外的高
+ 级功能了。所以基于Kafka有限的功能，可能适用的场景并不是很多。
+- 业界实践1
+ - 基本行业里的一个标准，是把Kafka用在用户行为日志的采集和传输上，比 如大数据团队要收集APP上用户的一些行为日志，
+ 这种日志就是用Kafka来收集和传输的。
+ - 因为那种日志适当丢失数据是没有关系的，而且一般量特别大，要求吞吐量要高，一般就是收发消息，不需要太多的高级功能，
+ 所以 Kafka是非常适合这种场景的。
+#### 2.2 RabbitMQ的优势和劣势
+- 优势
+ - 在中国使用的企业很多, 尤其是金融行业, 一线互联网大厂，而且直到现在都有很多中小型公司在使用RabbitMQ
+ - 可以保证数据不丢失，也能保证高可用性，即集群部署的时候部分机器宕机可以继续运行
+ - 支持部分高级功 能，比如说死信队列，消息重试之类的
+- 缺点
+ - RabbitMQ的吞吐量是比较低的，一般就是每秒几万的级别，所以如果遇到特别特别高并发的情况下，支撑起来是有点困难的。
+ - 他进行集群扩展的时候(也就是加机器部署)，还比较麻烦。
+ - 修改困难，开发语言是erlang，国内很少有精通erlang语言的工程师，因此也没办法去阅读他的源代码，甚至修改他的源代码。
+- 业界表现
+ - 很多BAT等一线互联网大厂都切换到使用更加优秀的RocketMQ了，很多中小型公司觉得 RabbitMQ 可以满足自己的需求还在继续使用中。
+ - 中小型公司认为 RabbitMQ已经足以满足需求, 不需要部署特别大规模的集群，也没必要去阅读和修改RabbitMQ的源码,迁移复杂。
+#### 2.3 RocketMQ的优势和劣势
+- RocketMQ是阿里开源的消息中间件，久经沙场，非常的靠谱。他几乎同时解决了Kafka和RabbitMQ的缺陷。
+- 优势
+ - RocketMQ的吞吐量也同样很高，单机可以达到10万QPS以上。
+ - 可以保证高可用性，性能很高。
+ - 支持通过配置保证数据绝对不丢失。
+ - 可以部署大规模的集群。
+ - 支持各种高级的功能，比如说延迟消息、事务消息、消息回溯、死信队列、消息积压，等等。
+ - RocketMQ是基于Java开发的，符合国内大多数公司的技术栈，很容易就可以阅读他的源码，甚至是修改他的源码。
+ - RocketMQ是非常适合用在Java业务系统架构中的，因为他很高的性能表现，还有他的高阶功能的支持，可以让我们解决各种业务问题。
+- 劣势
+ - RocketMQ 的官方文档相对简单一些，但是Kafka和RabbitMQ的官方文档就非常的全面和详细，这可能是RocketMQ目前唯一的缺点。
+ - PS: RocketMQ 现在已经交给 Apache 基金会在维护, 除了团队没有硬实力的因素，其他暂时无劣势, 建议解决这个问题, 使用。
+- 使用考虑
+ - 如果现在是一个中小型互联网公司，看起来似乎RabbitMQ足以应对需求，但是假设未来成长为一个大公司?
+ 也许也会有每秒几十万的QPS，也许以后也需要对MQ进行源码的二次开发，那此时RabbitMQ还合适吗?
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/mq/rocketmq/README.md b/mq/rocketmq/README.md
index 6831ecf..24756e2 100644
--- a/mq/rocketmq/README.md
+++ b/mq/rocketmq/README.md
@@ -21,6 +21,11 @@
- 集群无单点，可扩展，任意一点高可用，水平可扩展
- 消息失败重试机制，消息可查询
- 开源社区活跃、成熟度(经过双十一考验)
+- 理解的问题:
+ - MQ如何集群化部署来支撑高并发访问?
+ - MQ如果要存储海量消息应该怎么做?
+ - 高可用保障: 万一Broker宕机了怎么办?
+ - 数据路由: 怎么知道访问哪个Broker?
### 1.2 概念模型
- Producer: 消息生产者,负责生产消息,一般由业务系统负责产生消息
@@ -280,14 +285,216 @@
## 6. 双主双从部署
+### 6.1 设计生产的架构
+- NameServer集群化部署, 保证高可用, 每台NameServer实际上都会有完整的集群路由信息，包括所有的Broker节点信息，我们的数据信息
+- 基于Dledger的Broker主从架构部署
+ - RocketMQ 4.5以前的那种普通的Master-Slave架构来部署，能在一定程度上保证数据不丢失，也能保证一定的可用性
+ - 但是那种方式的缺陷是很明显的，最大的问题就是当Master Broker挂了之后，没办法让Slave Broker自动切换为新的Master Broker，需要手工做一些运维操作，修改配置以及重启机器才行，这个非常麻烦。
+ - Dledger技术是要求至少得是一个Master带两个Slave，这样有三个Broke组成一个Group，也就是作为一个分组来运行。一旦 Master宕机，他就可以从剩余的两个Slave中选举出来一个新的Master对外提供服务。
+- Broker是如何跟NameServer进行通信的
+ - Broker会每隔30秒发送心跳到所有的NameServer 上去，然后每个NameServer都会每隔10s检查一次有没有哪个Broker超过120s没发送心跳的，如果有，就认为那个Broker已经宕机 了，从路由信息里要摘除这个Broker。
+ - RocketMQ的实现中，采用的是TCP长连接进行通信。
+ - Broker会跟每个NameServer都建立一个TCP长连接，然后定时通过TCP长连接发送心跳请求过去
+- 使用MQ的系统都要多机器集群部署
+ - 无论作为生产者还是消费者的系统，都应 该多机器集群化部署，保证他自己本身作为生产者或者消费者的高可用性
+- MQ的核心数据模型:Topic到底是什么?
+ - 就是一个数据集合的意思
+ - 系统如果要往MQ里写入消息或者获取消息，首先得创建一些Topic，作为数据集合存放不同类型的消息
+- Topic作为一个数据集合是怎么在Broker集群里存储的
+ - 我们可以在创建Topic的时候指定让他里面的数据分散存储在多台Broker机器上，比如一个Topic里有1000万条数据，此时有2台 Broker，那么就可以让每台Broker上都放500万条数据
+- 生产者系统是如何将消息发送给Broker的?
+ - 生产者一定是投递消息到Master Broker的，然后Master Broker会同步数据给他的Slave Brokers，实现 一份数据多份副本，保证Master故障的时候数据不丢失，而且可以自动把Slave切换为Master提供服务。
+- 消费者是如何从Broker上拉取消息的?
+ - 消费者系统可能会从Master Broker拉取消息，也可能从Slave Broker拉取消息，都有可能，一切都看具体 情况。
+
+### 6.2 部署机器配置
+- NameServer:3台机器，每台机器都是8核CPU + 16G内存 + 500G磁盘 + 千兆网卡
+- Broker:3台机器，每台机器都是24核CPU(两颗x86_64 cpu，每颗cpu是12核) + 48G内存 + 1TB磁盘 + 千兆网卡
+- 生产者:2台机器，每台机器都是4核CPU + 8G内存 + 500GB磁盘 + 千兆网卡
+- 消费者:2台机器，每台机器都是4核CPU + 8G内存 + 500GB磁盘 + 千兆网卡
+
+- NameServer是核心的路由服务，所以给8核16G的较高配置的机器，但是他一般就是承载Broker注册和心跳、系统的路由表拉取等请 求，负载其实很低，因此不需要特别高的机器配置，部署三台也可以实现高可用的效果了。
+- Broker是最负载最高的，未来要承载高并发写入和海量数据存储，所以把最高配置的机器都会留给他，这里用3台机器组成一个“单 Master + 双Slave”的集群。
+- 生产者和消费者机器都是临时用来测试的，而且一般他们都是业务系统，只会部署在标准的4核8G的机器配置下。
+
+### 6.3 参数调整
+- PS: 中间件系统在压测或者上生产之前，需要对三大块参数进行调整:OS内核参数、JVM参数以及中间件核心参数
+- PS: OS内核参数主要调整的地方都是跟磁盘IO、网络通信、内存管理以及线程管理有关的，需要适当调节大小
+- PS: JVM参数需要我们去中间件系统的启动脚本中寻找他的默认JVM参数，然后根据机器的情况，对JVM的堆内存大小，新生代大 小，Direct Buffer大小，等等，做出一些调整，发挥机器的资源
+- PS: 中间件核心参数主要也是关注其中跟网络通信、磁盘IO、线程数量、内存 管理相关的，根据机器资源，适当可以增加网络通信线程，控制同步刷磁盘或者异步刷磁盘，线程数量有多少，内存中一些队列的大小
-
+---
+#### A. 对RocketMQ集群进行OS内核参数的调整
+(1) vm.overcommit_memory
+- “vm.overcommit_memory”这个参数有三个值可以选择，0、1、2。
+ - 0: 如果值是0的话，在你的中间件系统申请内存的时候，os内核会检查可用内存是否足够，如果足够的话就分配内存给你，如果感觉剩余 内存不是太够了，干脆就拒绝你的申请，导致你申请内存失败，进而导致中间件系统异常出错。
+ - 1: 一般需要将这个参数的值调整为1，意思是把所有可用的物理内存都允许分配给你，只要有内存就给你来用，这样可以避免申请内存失败的问题。
+> 可以用如下命令修改: echo 'vm.overcommit_memory=1' >> /etc/sysctl.conf
+
+(2) vm.max_map_count
+- 这个参数的值会影响中间件系统可以开启的线程的数量，同样也是非常重要的
+ - 如果这个参数过小，有的时候可能会导致有些中间件无法开启足够的线程，进而导致报错，甚至中间件系统挂掉。
+ - 他的默认值是65536，但是这个值有时候是不够的，比如大数据团队的生产环境部署的Kafka集群曾经有一次就报出过这个异常，说无法开启足够多的线程，直接导致Kafka宕机了。
+ - 因此建议可以把这个参数调大10倍，比如655360这样的值，保证中间件可以开启足够多的线程。
+> 可以用如下命令修改:echo 'vm.max_map_count=655360' >> /etc/sysctl.conf
+
+(3) vm.swappiness
+- 这个参数是用来控制进程的swap行为的，这个简单来说就是os会把一部分磁盘空间作为swap区域，然后如果有的进程现在可能不是太 活跃，
+ 就会被操作系统把进程调整为睡眠状态，把进程中的数据放入磁盘上的swap区域，然后让这个进程把原来占用的内存空间腾出 来，交给其他活跃运行的进程来使用。
+ - 如果这个参数的值设置为0，意思就是尽量别把任何一个进程放到磁盘swap区域去，尽量大家都用物理内存。
+ - 如果这个参数的值是100，那么意思就是尽量把一些进程给放到磁盘swap区域去，内存腾出来给活跃的进程使用。
+ - 默认这个参数的值是60，有点偏高了，可能会导致我们的中间件运行不活跃的时候被迫腾出内存空间然后放磁盘swap区域去。
+ - 因此通常在生产环境建议把这个参数调整小一些，比如设置为10，尽量用物理内存，别放磁盘swap区域去。
+> 可以用如下命令修改:echo 'vm.swappiness=10' >> /etc/sysctl.conf
+
+(4) ulimit
+- 这个是用来控制linux上的最大文件链接数的，默认值可能是1024，一般肯定是不够的，因为你在大量频繁的读写磁盘文件的时候，或 者是进行网络通信的时候，都会跟这个参数有关系
+ - 对于一个中间件系统而言肯定是不能使用默认值的，如果你采用默认值，很可能在线上会出现如下错误:error: too many open files
+> 因此通常建议用如下命令修改这个值:echo 'ulimit -n 1000000' >> /etc/profile
+
+(5) 总结:
+- 要调整的东西，无非都是跟磁盘文件IO、网络通信、内存管理、线程数量有关系的， 因为我们的中间件系统在运行的时候无非就是跟这些打交道
+ - 中间件系统肯定要开启大量的线程(跟vm.max_map_count有关)
+ - 而且要进行大量的网络通信和磁盘IO(跟ulimit有关)
+ - 然后大量的使用内存(跟vm.swappiness和vm.overcommit_memory有关)
+- 所以对OS内核参数的调整，往往也就是围绕跟中间件系统运行最相关的一些东西
+
+#### B. 对JVM参数进行调整
+- 在rocketmq/distribution/target/apache-rocketmq/bin目录下，就有对应的启动脚本，比如:
+ - mqbroker是用来启动Broker的
+ - mqnamesvr是用来启动NameServer的
+- 用mqbroker来举例，我们查看这个脚本里的内容，最后有如下一行:
+ - sh ${ROCKETMQ_HOME}/bin/runbroker.sh org.apache.rocketmq.broker.BrokerStartup $@
+ - 这一行内容就是用runbroker.sh脚本来启动一个JVM进程，JVM进程刚开始执行的main类就是 org.apache.rocketmq.broker.BrokerStartup
+- runbroker.sh脚本，在里面可以看到如下内容:
+
+```shell
+JAVA_OPT="${JAVA_OPT} -server -Xms8g -Xmx8g -Xmn4g"
+JAVA_OPT="${JAVA_OPT} -XX:+UseG1GC -XX:G1HeapRegionSize=16m -XX:G1ReservePercent=25 - XX:InitiatingHeapOccupancyPercent=30 -XX:SoftRefLRUPolicyMSPerMB=0"
+JAVA_OPT="${JAVA_OPT} -verbose:gc -Xloggc:/dev/shm/mq_gc_%p.log -XX:+PrintGCDetails -XX:+PrintGCDateStamps - XX:+PrintGCApplicationStoppedTime -XX:+PrintAdaptiveSizePolicy"
+JAVA_OPT="${JAVA_OPT} -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=30m" JAVA_OPT="${JAVA_OPT} -XX:-OmitStackTraceInFastThrow"
+JAVA_OPT="${JAVA_OPT} -XX:+AlwaysPreTouch"
+JAVA_OPT="${JAVA_OPT} -XX:MaxDirectMemorySize=15g"
+JAVA_OPT="${JAVA_OPT} -XX:-UseLargePages -XX:-UseBiasedLocking"
+JAVA_OPT="${JAVA_OPT} -Djava.ext.dirs=${JAVA_HOME}/jre/lib/ext:${BASE_DIR}/lib"
+#JAVA_OPT="${JAVA_OPT} -Xdebug -Xrunjdwp:transport=dt_socket,address=9555,server=y,suspend=n" JAVA_OPT="${JAVA_OPT} ${JAVA_OPT_EXT}"
+JAVA_OPT="${JAVA_OPT} -cp ${CLASSPATH}"
+```
+- 在上面的内容中，其实就是在为启动Broker设置对应的JVM参数和其他一些参数
+- PS: 狸猫技术窝的《从0开始带你成为JVM实战高手》这个专栏, 可以去学习MQ相关的内容
+---
+- **[了解]** -server:这个参数就是说用服务器模式启动，这个没什么可说的，现在一般都是如此
+- **[重点调整]** -Xms8g -Xmx8g -Xmn4g:这个就是很关键的一块参数了，也是重点需要调整的，就是默认的堆大小是8g内存，新生代是4g内存， 如果我们的高配物理机是48g内存的
+ - 所以这里完全可以给他们翻几倍，比如给堆内存20g，其中新生代给10g，甚至可以更多一些，当然要留一些内存给操作系统来用,但是要注意最小不能低于1g
+- **[重点调整]** -XX:+UseG1GC -XX:G1HeapRegionSize=16m:这几个参数也是至关重要的，这是选用了G1垃圾回收器来做分代回收，对新生代 和老年代都是用G1来回收
+ - 这里把G1的region大小设置为了16m，这个因为机器内存比较多，所以region大小可以调大一些给到16m，不然用2m的region，会导致region数量过多的
+- **[了解]** -XX:G1ReservePercent=25:这个参数是说，在G1管理的老年代里预留25%的空闲内存，保证新生代对象晋升到老年代的时候有足 够空间，避免老年代内存都满了，新生代有对象要进入老年代没有充足内存了
+ - 默认值是10%，略微偏少，这里RocketMQ给调大了一些
+- **[了解]** -XX:InitiatingHeapOccupancyPercent=30:这个参数是说，当堆内存的使用率达到30%之后就会自动启动G1的并发垃圾回收，开始尝试回收一些垃圾对象
+ - 默认值是45%，这里调低了一些，也就是提高了GC的频率，但是避免了垃圾对象过多，一次垃圾回收耗时过长的问题
+- **[重点调整]** -XX:SoftRefLRUPolicyMSPerMB=0:这个参数默认设置为0了
+ - 在JVM优化专栏中，救火队队长讲过这个参数引发的案例，其实建议这个参数不要设置为0，避免频繁回收一些软引用的Class对象，这里可以调整为比如1000
+- **[了解]** -verbose:gc -Xloggc:/dev/shm/mq_gc_%p.log -XX:+PrintGCDetails -XX:+PrintGCDateStamps - XX:+PrintGCApplicationStoppedTime -XX:+PrintAdaptiveSizePolicy -XX:+UseGCLogFileRotation - XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=30m:这一堆参数都是控制GC日志打印输出的，确定了gc日志文件的地址，要 打印哪些详细信息，然后控制每个gc日志文件的大小是30m，最多保留5个gc日志文件。
+- **[了解]** -XX:-OmitStackTraceInFastThrow:这个参数是说，有时候JVM会抛弃一些异常堆栈信息，因此这个参数设置之后，就是禁用这个特性，要把完整的异常堆栈信息打印出来
+- **[了解]** -XX:+AlwaysPreTouch:这个参数的意思是我们刚开始指定JVM用多少内存，不会真正分配给他，会在实际需要使用的时候再分配给 他
+ - 所以使用这个参数之后，就是强制让JVM启动的时候直接分配我们指定的内存，不要等到使用内存的时候再分配
+- **[可以调整]** -XX:MaxDirectMemorySize=15g:这是说RocketMQ里大量用了NIO中的direct buffer，这里限定了direct buffer最多申请多少， 如果你机器内存比较大，可以适当调大这个值，如果有朋友不了解direct buffer是什么，可以自己查阅一些资料。
+- **[了解]** -XX:-UseLargePages -XX:-UseBiasedLocking:这两个参数的意思是禁用大内存页和偏向锁，这两个参数对应的概念每个要说清楚 都得一篇文章，所以这里大家直接知道人家禁用了两个特性即可。
+---
+- 总结:
+ - RocketMQ默认的JVM参数是采用了G1垃圾回收器，默认堆内存大小是8G
+ - 这个其实完全可以根据大家的机器内存来调整，你可以增大一些也是没有问题的，然后就是一些G1的垃圾回收的行为参数做了调整， 这个一般我们不用去动，然后就是对GC日志打印做了设置，这个一般也不用动。
+ - 其余的就是禁用一些特性，开启一些特性，这些都直接维持RocketMQ的默认值即可
+
+#### C. 对RocketMQ核心参数进行调整
+- 在下面的目录里有dledger的示例配置文件:rocketmq/distribution/target/apache- rocketmq/conf/dledger
+- 在这里主要是有一个较为核心的参数:sendMessageThreadPoolNums=16
+ - 这个参数的意思就是RocketMQ内部用来发送消息的线程池的线程数量，默认是16
+ - 其实这个参数可以根据你的机器的CPU核数进行适当增加，比如机器CPU是24核的，可以增加这个线程数量到24或者30，都是可以 的
+
+### 6.4 压测
+- 我们在压测的时候一方面要关注RocketMQ能抗下多少TPS，一方面还要关注RocketMQ部署的几台机器的资源使用率和负载情况
+- 我们平时做压测，主要关注的还是要压测出来一个最合适的最高负载。
+ - 意思就是在RocketMQ的TPS和机器的资源使用率和负载之间取得一个平衡。
+- 以下压测过程以及压测结果，都是根据我们之前真实的RocketMQ压测报告总结而来，非常的有代表性，大家完全可以结合我们之前说的机器配置来参考一下
+#### (1) RocketMQ的TPS和消息延时
+- 我们让两个Producer不停的往RocketMQ集群发送消息，每个Producer所在机器启动了**80个线程**，相当于每台机器有80个线程并发的往RocketMQ集群写入消息。
+- RocketMQ集群是**1主2从**组成的一个dledger模式的高可用集群，只有一个Master Broker会接收消息的写入。有2个Cosumer不停的从RocketMQ集群消费数据。[只主节点会接到数据的成功写入]
+- **每条数据的大小是500个字节**，这个非常关键，大家一定要牢记这个数字，因为这个数字是跟后续的**网卡流量**有关的。
+- 一条消息从Producer生产出来到经过RocketMQ的Broker存储下来，再到被Consumer消费，基本上这个**时间跨度不会超过1秒钟**，这些这个性能是正常而且可以接受的。
+- 同时在RocketMQ的管理工作台中可以看到，Master Broker的TPS(也就是每秒处理消息的数量)，可以稳定的达到7万左右，也就是 每秒可以稳定处理7万消息。
+#### (2) cpu负载情况
+- 检查一下Broker机器上的CPU负载，可以通过top、uptime等命令来查看
+- 执行top命令就可以看到cpu load和cpu使用率，这就代表了cpu的负载情况
+ - 在你执行了top命令之后，往往可以看到如下一行信息:
+ - load average:12.03，12.05，12.08
+ - 类似上面那行信息代表的是cpu在1分钟、5分钟和15分钟内的cpu负载情况
+ - 比如我们一台机器是24核的，那么上面的12意思就是有12个核在使用中。换言之就是还有12个核其实还没使用，cpu还是有很大余力的。
+- 这个cpu负载其实是比较好的，因为并没有让cpu负载达到极限。
+
+#### (3) 内存使用率
+- 使用free命令就可以查看到内存的使用率
+- 根据当时的测试结果，机器上48G的内存，仅仅使用了一部分，还剩下很大一部分内存都是 空闲可用的，或者是被RocketMQ用来进行磁盘数据缓存了
+- 所以内存负载是很低的
+
+#### (4) JVM GC频率
+- 使用jstat命令就可以查看RocketMQ的JVM的GC频率，基本上新生代每隔几十秒会垃圾回收一次，每次回收过后存活的对象很少，几乎不进入老年代
+
+#### (5) 磁盘IO负载
+- 首先可以用top命令查看一下IO等待占用CPU时间的百分比，你执行top命令之后，会看到一行类似下面的东西:
+- Cpu(s): 0.3% us, 0.3% sy, 0.0% ni, 76.7% id, 13.2% wa, 0.0% hi, 0.0% si
+- 在这里的13.2% wa，说的就是磁盘IO等待在CPU执行时间中的百分比
+- 如果这个比例太高，说明CPU执行的时候大部分时间都在等待执行IO，也就说明IO负载很高，导致大量的IO等待
+- 这个当时我们压测的时候，是在40%左右，说明IO等待时间占用CPU执行时间的比例在40%左右，这是相对高一些，但还是可以接受的，只不过如果继续让这个比例提高上去，
+ 就很不靠谱了，因为说明磁盘IO负载可能过高了。
+
+#### (6) 网卡流量
+- 使用如下命令可以查看服务器的网卡流量:
+- sar -n DEV 1 2
+- 通过这个命令就可以看到每秒钟网卡读写数据量了。当时我们的服务器使用的是千兆网卡，千兆网卡的理论上限是每秒传输128M数 据，但是一般实际最大值是每秒传输100M数据。
+- 因此当时我们发现的一个问题就是，在RocketMQ处理到每秒7万消息的时候，每条消息500字节左右的大小的情况下，每秒网卡传输 数据量已经达到100M了，就是已经达到了网卡的一个极限值了。
+- 因为一个Master Broker服务器，每秒不光是通过网络接收你写入的数据，还要把数据同步给两个Slave Broker，还有别的一些网络通 信开销。
+- 因此实际压测发现，每条消息500字节，每秒7万消息的时候，服务器的网卡就几乎打满了，无法承载更多的消息了。
+
+#### (7) 针对压测的一点小总结
+- 通过本次压测做一些总结:
+ - 当我们使用平均大小为500字节的消息时，最多就是做到RocketMQ单台服务器每秒7万的TPS，而且这个时候cpu负载、内存负 载、jvm gc负载、磁盘io负载，基本都还在正常范围内
+ - 只不过这个时候网卡流量基本已经打满了，无法再提升TPS了
+ - 因此在这样的一个机器配置下，RocketMQ一个比较靠谱的TPS就是7万左右
+
+#### 总结
+- 到底应该如何压测:
+ - 应该在TPS和机器的cpu负载、内存使用率、jvm gc频率、磁盘io负载、网络流量负载之间取得一个平衡，尽量让 TPS尽可能的提高，同时让机器的各项资源负载不要太高。
+- 实际压测过程:
+ - 采用几台机器开启大量线程并发读写消息，然后观察TPS、cpu load(使用top命令)、内存使用率(使用free命 令)、jvm gc频率(使用jstat命令)、磁盘io负载(使用top命令)、网卡流量负载(使用sar命令)，不断增加机器和线程，让TPS不 断提升上去，同时观察各项资源负载是否过高。
+- 生产集群规划:
+ - 根据公司的后台整体QPS来定，稍微多冗余部署一些机器即可，实际部署生产环境的集群时，使用高配置物理机，同时 合理调整os内核参数、jvm参数、中间件核心参数，如此即可
## 7. 购物车、订单与支付场景抗压实战 -> 可以移步到
## 8. RocketMQ分布式事务消息
+### 8.1 生产案例:从 RocketMQ 全链路分析一下为什么用户支付后没有收到红包?
+- 用户支付之后红包到底为什么没发送出去呢?
+ - 其实原因有多种可能，比如订单系统推送消息到MQ就失败了，压根儿就没推送过去;
+ - 或者是消息确实推送到MQ了，但是结果MQ自己机器故障，把消息搞丢了;
+ - 或者是红包系统拿到了消息，但是他把消息搞丢了，结果红包还没来得及发。
+ - 如果真的在生产环境里要搞明白这个问题，就必须要打更多的日志去一点点分析消息到底是在哪个环节丢失了?
+ - 如果订单系统推送了消息，结果红包系统连消息都没收到，那可能消息根本就没发到MQ去，或者MQ自己搞丢了消息。
+ - 如果红包系统收到了消息，结果红包没派发，那么就是红包系统搞丢了消息。
+
+
+
+
+
+
+
+
+
+
+
+
@@ -298,3 +505,21 @@
## 10. 数据过滤与性能提升
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
From 3712b807a39eb08d142a1a17de8b4d37ae13b4ba Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Sat, 6 Aug 2022 21:58:58 +0800
Subject: [PATCH 4/5] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BA=86=E6=96=87?=
=?UTF-8?q?=E6=A1=A32?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
longpolling/netty/README.md | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/longpolling/netty/README.md b/longpolling/netty/README.md
index 0ab2fa4..b667f05 100644
--- a/longpolling/netty/README.md
+++ b/longpolling/netty/README.md
@@ -1,5 +1,14 @@
# Netty
+## 成就点
+- 负责公司千万级别实时在线用户长连消息推送系统
+- 企业社交 Sass 完美解决方案
+
+## 主要方案
+- 完美应用示例(十万级): 线程池异步业务 + (Linux 句柄) + 单机Netty + 日志
+- 异步化完美方案(百万级): 线程池异步业务 + (Linux 句柄) + HA高可用 + 日志
+- 多服务端解决方案(千万级): Disruptor异步业务 + (Linux 句柄) + HA高可用 + 日志
+
## 参考资料
- https://www.imooc.com/t/6224286 慕课网牛人教程
-
From c265d266538a2c6d732f412a3b14eadb5937e5e0 Mon Sep 17 00:00:00 2001
From: qyx <565485304@qq.com>
Date: Sun, 7 Aug 2022 22:42:05 +0800
Subject: [PATCH 5/5] =?UTF-8?q?[=E6=96=87=E6=A1=A3=E4=BF=AE=E6=94=B9](mast?=
=?UTF-8?q?er):=20=E6=9B=B4=E6=96=B0=E4=BA=86=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
更新了文档1
---
base/jvm/README.md | 16 ++++
database/mysql/README.md | 89 ++++++++++++++++++
database/mysql/pic/MySQL架构设计.png | Bin 0 -> 274579 bytes
database/mysql/pic/redo写磁盘0.png | Bin 0 -> 81699 bytes
database/mysql/pic/redo写磁盘1.png | Bin 0 -> 70381 bytes
database/mysql/pic/redo写磁盘3.png | Bin 0 -> 109295 bytes
database/mysql/pic/redo写磁盘4.png | Bin 0 -> 46004 bytes
database/mysql/pic/redo写磁盘5.png | Bin 0 -> 57227 bytes
database/mysql/pic/redo日志.png | Bin 0 -> 68569 bytes
database/mysql/pic/undo日志.png | Bin 0 -> 52374 bytes
.../mysql/pic/更新bufferpool中的缓存数据.png | Bin 0 -> 97810 bytes
database/mysql/pic/没提交事务宕机.png | Bin 0 -> 87795 bytes
database/mysql/pic/缓冲池.png | Bin 0 -> 73423 bytes
database/mysql/pic/缓冲池加载.png | Bin 0 -> 63747 bytes
14 files changed, 105 insertions(+)
create mode 100644 base/jvm/README.md
create mode 100644 database/mysql/README.md
create mode 100644 database/mysql/pic/MySQL架构设计.png
create mode 100644 database/mysql/pic/redo写磁盘0.png
create mode 100644 database/mysql/pic/redo写磁盘1.png
create mode 100644 database/mysql/pic/redo写磁盘3.png
create mode 100644 database/mysql/pic/redo写磁盘4.png
create mode 100644 database/mysql/pic/redo写磁盘5.png
create mode 100644 database/mysql/pic/redo日志.png
create mode 100644 database/mysql/pic/undo日志.png
create mode 100644 database/mysql/pic/更新bufferpool中的缓存数据.png
create mode 100644 database/mysql/pic/没提交事务宕机.png
create mode 100644 database/mysql/pic/缓冲池.png
create mode 100644 database/mysql/pic/缓冲池加载.png
diff --git a/base/jvm/README.md b/base/jvm/README.md
new file mode 100644
index 0000000..93c933c
--- /dev/null
+++ b/base/jvm/README.md
@@ -0,0 +1,16 @@
+# JVM深入及调优
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/database/mysql/README.md b/database/mysql/README.md
new file mode 100644
index 0000000..eb6b845
--- /dev/null
+++ b/database/mysql/README.md
@@ -0,0 +1,89 @@
+# MySQL 高级
+
+
+## 1. 系统是怎么和 MySQL 打交道 ?
+- MySQL不仅仅是CRUD
+
+### 1.1 MySQL 驱动
+- mysql 驱动是跟数据库进行的一个网络连接建立工具
+- 不同的语言有不同的驱动使用
+
+### 1.2 数据库连接池
+- 作用是减少连接的重复建立和销毁，让线程去执行SQL语句后, 不要销毁这个数据库连接，而是放在池子中进行复用
+- 常见的数据库连接池有: DBCP，C3P0，Druid
+
+## 2. 执行 SQL 语句, MySQL用了什么架构设计？
+- 一个不变的原则: 网络连接必须让线程来处理
+
+- SQL 接口: 负责处理接收到的SQL语句
+- 监听请求以及读取请求数据的线程, 把解析好的SQL语句v转交给SQL接口去执行
+- 查询解析器: 按照估计的SQL语法, 对我们发送的 SQL 语句进行解析, 理解其要进行的操作
+- 查询优化器: 生成查询路径树, 然后从里面选择一条最优的查询路径
+- 调用存储引擎, 真正的执行 SQL 语句
+- MySQL 的设计架构中, SQL接口, SQL解析器, 查询优化器其实都是通用的,就是一套组件
+- 存储引擎可以供我们去选择, 选择那种存储引擎来执行SQL。常见的存储引擎: InnoDB, MyISAM, Memory等。
+- 执行器: 执行器会根据我们的优化器生成一套执行计划, 然后不停的调用存储引擎的各种接口去完成SQL语句的执行计划
+
+## 3. 用一次数据更新流程, 了解 InnoDB 引擎的架构设计
+
+### 3.1 InnoDB 的重要内存结构: 缓冲池
+
+- InnoDB 的很重要放在内存里面的组件, 里面会缓冲很多数据, 在查询时候, 如果查的是内存中的数据, 就不用去查盘了
+
+- 引擎在更新语句的时候, 比如 "id=10" 这行数据是否在缓冲池中, 如果不在就从磁盘中加载到缓冲池, 而且还会对这行数据加独占锁
+
+### 3.2 undo日志文件: 如何让你更新的数据可以回滚?
+
+- 我们开发中可以轻松地利用事务对数据提交的过程进行回滚操作，是因为会把更新前的值写入到undo日志文件中
+
+### 3.3 更新 buffer pool 中的缓存数据
+- 当我们要把更新的那行记录从磁盘文件加载到缓冲池, 同时对他加锁, 而且还把更新前的旧值写入undo日志文件之后, 我们才正式开始更新
+ 这行记录, 更新的时候, 先会更新缓冲池中的记录, 此时这个数据是脏数据
+- 这里所谓的更新内存缓冲池里的数据, 意思是把内存里的 "id=10" 这行数据的name修改为 "xxx"
+- 为什么说是脏数据呢?
+ - 因为这个时候磁盘上 "id=10" 这行数据的name字段还是以前的值, 但是内存里面这行数据已经改变了, 所以称为脏数据
+
+
+### 3.4 Redo Log Buffer: 万一系统宕机, 如何避免数据丢失？
+- 在 3.3 中如果此时宕机, 会导致内存中改过的数据丢失, 怎么办?
+ - 这个时候,就必须把对内存的修改写到一个Redo Log Buffer 中, 这也是内存里的一个缓冲区, 是用来存放 redo 日志的
+ - 所谓 redo 日志,就是记录你对数据做了什么修改, 比如对 "id=10这行记录修改了name字段的值为xxx", 这就是一个日志
+
+- 这个 redo 日志其实是用来在 MySQL 突然宕机的时候, 用来恢复你更新过的数据, 现在redo日志还仅仅停留在内存缓冲里
+
+### 3.5 如果还没提交事务, MySQL 宕机了怎么办?
+- 执行一条SQL语句, 其实也可以是一个独立的事务, 当你提交事务后, SQL语句才算执行结束
+- 此时还没有提交事务, 如果此时 MySQL 崩溃, 必然导致内存里 Buffer Pool 中的修改过的数据都丢失,
+ 同时你写入 Redo Log Buffer 中的redo日志也会丢失
+
+- 此时, 丢数据不要紧, 因为你一条更新语句, 没提交事务, 就代表他没执行成功, 磁盘上的数据没有改变, mysql 重启后, 你的数据无任何变化
+
+### 3.6 提交事务的时候将redo日志写入磁盘中
+- 我们提交一个事务, 此时会根据一定的策略把redo日志从 redo log buffer里刷入到磁盘文件里去
+- 这个策略是通过 innodb_flush_log_at_trx_commit 来配置的
+- 当这个值为0时候, 你提交事务的时候,不会把redo log buffer里面的数据刷入磁盘文件,此时可能你都提交事务了, 结果MySQL宕机了, 然后此时内存里的数据全部丢失
+ 相当于你提交事务成功了, 但是由于MySQL突然宕机, 导致内存中的数据和redo日志都丢失了
+
+- 当这个参数值为1的时候, 你提交事务的时候, 就必须把redo log从内存刷入到磁盘文件中去, 只要事务提交成功, 那么redo log就必然在磁盘里了
+
+- 只要提交事务成功, redo日志一定在磁盘文件中了, 此时你肯定会有一条redo日志说了, "我对什么数据进行了一个什么操作"
+- 然后哪怕此时buffer pool中更新过的数据还没刷到磁盘里面去,此时内存中的数据是已经更新过的"name=xxx",然后磁盘上的数据是还没更新过的"name=zhangsan"
+
+- 此时不会丢数据, 因为redo日志中已经记录了操作
+- 所以此时mysql重启后, 可以根据redo日志去恢复之前做的修改
+
+- 如果 innodb_flush_log_at_trx_commit 值为2
+- 意思是说, 提交事务的时候, 把redo日志写入磁盘文件对应的os cache缓存里去, 而不是直接进入磁盘文件, 可能1秒后才会把 os cache 里的数据写入到磁盘文件中去
+- 这种模式下,你提交了事务, redo log可能仅仅停留在os cache内存缓存中, 没实际进入磁盘文件, 万一此时你要是机器宕机了, 那么os cache里的redo log就会丢失
+ 同样让你感觉提交了事务, 数据丢了
+
+
+---
+- 总结: 对于redo日志的三种刷盘策略, 我们的通常建议是1, 保证事务提交后, 数据绝对不能丢失
+## 4. 聊聊binlog是什么?
+
+
+
+
+
+
diff --git a/database/mysql/pic/MySQL架构设计.png b/database/mysql/pic/MySQL架构设计.png
new file mode 100644
index 0000000000000000000000000000000000000000..619bf2a4cd5119346db84eb3b6cc14d97e8aaa13
GIT binary patch
literal 274579
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