Skip to content

Commit 5073da3

Browse files
committed
Fix data subscription document content issue
1 parent d491225 commit 5073da3

File tree

2 files changed

+8
-8
lines changed

2 files changed

+8
-8
lines changed

src/UserGuide/Master/Deployment-and-Maintenance/Data-subscription.md renamed to src/UserGuide/Master/User-Manual/Data-subscription.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ The IoTDB data subscription module (also known as the IoTDB subscription client)
66

77
Using the IoTDB Subscription Client to consume data has significant advantages in the following application scenarios:
88

9-
1. **Replacing Polling Queries for Large Amounts of Data**: Avoids the significant impact on the performance of the original system when the query frequency is high and there are many measurement points; avoids the issue of determining the query range, ensuring that the downstream can obtain accurate and complete data;
9+
1. **Continuously obtaining the latest data**: By using a subscription method, it is more real-time than scheduled queries, simpler to program applications, and has a lower system burden;
1010

11-
2. **Rapid Integration with Downstream Systems**: Easier to integrate with system components such as Flink, Spark, Kafka / DataX, Camel / MySQL, PG, etc. There is no need to develop custom logic for IoTDB change capture for each big data component, which simplifies the design of integration components and improves development efficiency.
11+
2. **Simplify data push to third-party systems**: No need to develop data push components for different systems within IoTDB, data can be streamed within third-party systems, making it easier to send data to systems such as Flink, Kafka, DataX, Camel, MySQL, PG, etc.
1212

1313
## 2. Key Concepts
1414

@@ -18,9 +18,9 @@ The IoTDB Subscription Client encompasses three core concepts: Topic, Consumer,
1818
<img src="https://alioss.timecho.com/docs/img/Data_sub_01.png" alt="" style="width: 60%;"/>
1919
</div>
2020

21-
1. **Topic**: A Topic is a logical concept used in the IoTDB Subscription Client to categorize data, which can be considered as a data publication channel. Producers publish data to specific topics, and consumers subscribe to these topics to receive relevant data. Unlike Kafka, in the IoTDB subscription client, topics correspond to the sequence and time range to be subscribed to, output format (message or TsFile), and optional custom processing logic.
21+
1. **Topic**: Topic is the data space of IoTDB, represented by paths and time ranges (such as the full time range of root. * *). Consumers can subscribe to data on these topics (currently existing and future written). Unlike Kafka, IoTDB can create topics after data is stored, and the output format can be either Message or TsFile.
2222

23-
2. **Consumer**: Consumer is the application or service where the IoTDB subscription client is located, responsible for receiving and processing data published to specific topics. Consumers retrieve data from the queue and process it accordingly. There are two types of Consumers available in the IoTDB subscription client:
23+
2. **Consumer**: Consumer is an IoTDB subscription client is located, responsible for receiving and processing data published to specific topics. Consumers retrieve data from the queue and process it accordingly. There are two types of Consumers available in the IoTDB subscription client:
2424
- `SubscriptionPullConsumer`, which corresponds to the pull consumption model in message queues, where user code needs to actively invoke data retrieval logic.
2525
- `SubscriptionPushConsumer`, which corresponds to the push consumption model in message queues, where user code is triggered by newly arriving data events.
2626

src/zh/UserGuide/Master/User-Manual/Data-subscription.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ IoTDB 数据订阅模块(又称 IoTDB 订阅客户端)是IoTDB V1.3.3 版本
66

77
在下面应用场景中,使用 IoTDB 订阅客户端消费数据会有显著的优势:
88

9-
1. **替换大量数据的轮询查询**避免查询频率高、测点多时,轮询查询对原有系统性能的较大影响;避免查询范围不好确定问题,可保证下游拿到准确全量的数据
10-
2. **与下游系统快速集成**更方便对接 Flink、Spark、Kafka / DataX、Camel / MySQL、PG 等系统组件。不需要为每一个大数据组件,单独定制开发 IoTDB 的变更捕获等逻辑,可简化集成组件设计,提升开发效率
9+
1. **持续获取最新数据**使用订阅的方式,比定时查询更实时、应用编程更简单、系统负担更小
10+
2. **简化数据推送至第三方系统**无需在 IoTDB 内部开发不同系统的数据推送组件,可以在第三方系统内实现数据的流式获取,更方便将数据发送至 Flink、KafkaDataX、CamelMySQL、PG 等系统
1111

1212
## 2. 主要概念
1313

@@ -17,9 +17,9 @@ IoTDB 订阅客户端包含 3 个核心概念:Topic、Consumer、Consumer Grou
1717
<img src="https://alioss.timecho.com/docs/img/Data_sub_05.png" alt="" style="width: 60%;"/>
1818
</div>
1919

20-
1. **Topic(主题)**: Topic 是 IoTDB 订阅客户端中用于分类数据的逻辑概念,可以看作是数据的发布通道。生产者将数据发布到特定的主题,而消费者则订阅这些主题以接收相关数据。不同于 Kafka,IoTDB 订阅客户端中,主题对应了待订阅的序列和时间范围,输出格式(消息或 TsFile),及可选的自定义处理逻辑
20+
1. **Topic(主题)**: Topic 是 IoTDB 的数据空间,由路径和时间范围表示(如 root.** 的全时间范围)。消费者可以订阅这些主题的数据(当前已有的和未来写入的)。不同于 Kafka,IoTDB 可在数据入库后再创建 Topic,且输出格式可选择 Message 或 TsFile 两种
2121

22-
2. **Consumer(消费者)**: Consumer 是 IoTDB 订阅客户端有所在的应用程序或服务,负责接收和处理发布到特定 Topic 的数据。Consumer 从队列中获取数据并进行相应的处理。在 IoTDB 订阅客户端中提供了两种类型的 Consumers:
22+
2. **Consumer(消费者)**: Consumer 是 IoTDB 的订阅客户端,负责接收和处理发布到特定 Topic 的数据。Consumer 从队列中获取数据并进行相应的处理。在 IoTDB 订阅客户端中提供了两种类型的 Consumers:
2323
- 一种是 `SubscriptionPullConsumer`,对应的是消息队列中的 pull 消费模式,用户代码需要主动调用数据获取逻辑
2424
- 一种是 `SubscriptionPushConsumer`,对应的是消息队列中的 push 消费模式,用户代码由新到达的数据事件触发
2525

0 commit comments

Comments
 (0)