You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@rocketmq.apache.org by do...@apache.org on 2021/11/29 03:18:35 UTC
[rocketmq] branch 5.0.0-alpha-static-topic updated: Polish the concept for static topic doc
This is an automated email from the ASF dual-hosted git repository.
dongeforever pushed a commit to branch 5.0.0-alpha-static-topic
in repository https://gitbox.apache.org/repos/asf/rocketmq.git
The following commit(s) were added to refs/heads/5.0.0-alpha-static-topic by this push:
new c1d4b8b Polish the concept for static topic doc
c1d4b8b is described below
commit c1d4b8b54990bdb006a2a9fd748d845a28456a13
Author: dongeforever <do...@apache.org>
AuthorDate: Mon Nov 29 11:18:15 2021 +0800
Polish the concept for static topic doc
---
...ocketMQ_Static_Topic_Logic_Queue_\350\256\276\350\256\241.md" | 9 +++++++--
1 file changed, 7 insertions(+), 2 deletions(-)
diff --git "a/docs/cn/statictopic/RocketMQ_Static_Topic_Logic_Queue_\350\256\276\350\256\241.md" "b/docs/cn/statictopic/RocketMQ_Static_Topic_Logic_Queue_\350\256\276\350\256\241.md"
index c019e3d..b33f72e 100644
--- "a/docs/cn/statictopic/RocketMQ_Static_Topic_Logic_Queue_\350\256\276\350\256\241.md"
+++ "b/docs/cn/statictopic/RocketMQ_Static_Topic_Logic_Queue_\350\256\276\350\256\241.md"
@@ -33,7 +33,7 @@ LogicQueue的思路就是为了解决这一问题。
### 设计目标
#### 总体目标
提供『Static Topic』的特性。
-引入以下概念:
+引入以下核心概念:
- physical message queue, physical queue for short, a shard bound to a specified broker.
- logic message queue, logic queue for short, a shard vertically composed by physical queues.
- dynamic sharded topic, dynamic topic for short, which has queues increasing with the broker numbers.
@@ -42,6 +42,11 @@ LogicQueue的思路就是为了解决这一问题。
『Static Topic』拥有固定的分片数量,每个分片称之为『Logic Queue』。
每个『Logic Queue』由多个『Physical Queue』进行纵向分段映射组成。
+引入以下非核心概念,对用户无感知,但对于讨论问题非常重要:
+- Leader Queue, 某个『Logic Queue』最新映射的『Physical Queue』,也即可写的那个Queue
+- Second Leader Queue,某个『Logic Queue』次新映射的『Physical Queue』,也即最新一次切换之前的『Leader Queue』
+
+
#### LogicQueue 目标
在客户端,LogicQueue 与 Physical Queue 使用体感上没有任何区别,使用一样的概念和对象,遵循一样的语义。
在服务端,针对 LogicQueue 去适配相关的API。
@@ -149,7 +154,7 @@ LogicQueue 的 Source of Truth 就是 LogicQueue 到 Physical Queue 的映射关
* 位点范围『0-1000』映射到 Physical Queue 『broker01-0』上面
* 位点范围『1000-』映射到 Physical Queue 『broker02-0』上面
-『拥有』的定义是指,映射关系的最新队列在当前Broker。注意,在实现时,也会把次新队列存储下来作为备份。
+『拥有』的定义是指,Leader Queue 在当前Broker。注意,在实现时,也会把Second Leader Queue存储下来作为备份。
注意以下要点: