From 7108e0dc4efdc8531855a9d0c5933a8e67350071 Mon Sep 17 00:00:00 2001 From: wangmm0220 Date: Sun, 18 Feb 2024 13:53:07 +0800 Subject: [PATCH] opti:docs for tmq --- docs/zh/07-develop/07-tmq.mdx | 1284 ++++++++++++++++----------------- docs/zh/07-develop/img_5.png | Bin 0 -> 18871 bytes docs/zh/07-develop/img_6.png | Bin 0 -> 49305 bytes docs/zh/07-develop/img_7.png | Bin 0 -> 15038 bytes docs/zh/12-taos-sql/13-tmq.md | 70 +- 5 files changed, 672 insertions(+), 682 deletions(-) create mode 100644 docs/zh/07-develop/img_5.png create mode 100644 docs/zh/07-develop/img_6.png create mode 100644 docs/zh/07-develop/img_7.png diff --git a/docs/zh/07-develop/07-tmq.mdx b/docs/zh/07-develop/07-tmq.mdx index 50913e87c8..df651eab96 100644 --- a/docs/zh/07-develop/07-tmq.mdx +++ b/docs/zh/07-develop/07-tmq.mdx @@ -15,334 +15,62 @@ import Node from "./_sub_node.mdx"; import CSharp from "./_sub_cs.mdx"; import CDemo from "./_sub_c.mdx"; -为了帮助应用实时获取写入 TDengine 的数据，或者以事件到达顺序处理数据，TDengine 提供了类似消息队列产品的数据订阅、消费接口。这样在很多场景下，采用 TDengine 的时序数据处理系统不再需要集成消息队列产品，比如 kafka, 从而简化系统设计的复杂度，降低运营维护成本。 -与 kafka 一样，你需要定义 *topic*, 但 TDengine 的 *topic* 是基于一个已经存在的超级表、子表或普通表的查询条件，即一个 `SELECT` 语句。你可以使用 SQL 对标签、表名、列、表达式等条件进行过滤，以及对数据进行标量函数与 UDF 计算（不包括数据聚合）。与其他消息队列软件相比，这是 TDengine 数据订阅功能的最大的优势，它提供了更大的灵活性，数据的颗粒度可以由应用随时调整，而且数据的过滤与预处理交给 TDengine，而不是应用完成，有效的减少传输的数据量与应用的复杂度。 +为了帮助应用实时获取写入 TDengine 的数据，或者以事件到达顺序处理数据，TDengine 提供了类似 kafka 的数据订阅功能。这样在很多场景下，采用 TDengine 的时序数据处理系统不再需要集成消息队列产品，比如 kafka, 从而简化系统设计的复杂度，降低运营维护成本。 -消费者订阅 *topic* 后，可以实时获得最新的数据。多个消费者可以组成一个消费者组 (consumer group), 一个消费者组里的多个消费者共享消费进度，便于多线程、分布式地消费数据，提高消费速度。但不同消费者组中的消费者即使消费同一个 topic, 并不共享消费进度。一个消费者可以订阅多个 topic。如果订阅的是超级表，数据可能会分布在多个不同的 vnode 上，也就是多个 shard 上，这样一个消费组里有多个消费者可以提高消费效率。TDengine 的消息队列提供了消息的 ACK 机制，在宕机、重启等复杂环境下确保 at least once 消费。 +# 介绍 +## 主题 +与 kafka 一样，你需要定义 topic, TDengine 的 topic 有三种，可以是数据库，超级表，或者一个 `SELECT` 语句，具体的语法参见 [CREATE TOPIC](../../12-taos-sql/13-tmq)。与其他消息队列软件相比，这是 TDengine 数据订阅功能的最大的优势，它提供了更大的灵活性，数据的颗粒度可以由应用随时调整，而且数据的过滤与预处理交给 TDengine，而不是应用完成，有效的减少传输的数据量与应用的复杂度。 -为了实现上述功能，TDengine 会为 WAL (Write-Ahead-Log) 文件自动创建索引以支持快速随机访问，并提供了灵活可配置的文件切换与保留机制：用户可以按需指定 WAL 文件保留的时间以及大小（详见 create database 语句）。通过以上方式将 WAL 改造成了一个保留事件到达顺序的、可持久化的存储引擎（但由于 TSDB 具有远比 WAL 更高的压缩率，我们不推荐保留太长时间，一般来说，不超过几天）。 对于以 topic 形式创建的查询，TDengine 将对接 WAL 而不是 TSDB 作为其存储引擎。在消费时，TDengine 根据当前消费进度从 WAL 直接读取数据，并使用统一的查询引擎实现过滤、变换等操作，将数据推送给消费者。 +如下图，每个 topic 涉及到的数据表可能分布在多个 vnode（相当于 kafka 里的 partition） 上，每个 vnode 上的数据保存在 WAL(Write-Ahead-Log) 文件中，WAL 文件里的数据是顺序写入的（由于 WAL 文件中存储的不只有数据，还有元数据，写入消息等，所以数据的版本号不是连续的）。 -下面为关于数据订阅的一些说明，需要对TDengine的架构有一些了解，结合各个语言链接器的接口使用。(可使用时再了解) -- 一个消费组消费同一个topic下的所有数据，不同消费组之间相互独立； -- 一个消费组消费同一个topic所有的vgroup，消费组可由多个消费者组成，但一个vgroup仅被一个消费者消费，如果消费者数量超过了vgroup数量，多余的消费者不消费数据； -- 在服务端每个vgroup仅保存一个offset，每个vgroup的offset是单调递增的，但不一定连续。各个vgroup的offset之间没有关联； -- 每次poll服务端会返回一个结果block，该block属于一个vgroup，可能包含多个wal版本的数据，可以通过 offset 接口获得是该block第一条记录的offset； -- 一个消费组如果从未commit过offset，当其成员消费者重启重新拉取数据时，均从参数auto.offset.reset设定值开始消费；在一个消费者生命周期中，客户端本地记录了最近一次拉取数据的offset，不会拉取重复数据； -- 消费者如果异常终止（没有调用tmq_close），需等约12秒后触发其所属消费组rebalance，该消费者在服务端状态变为LOST，约1天后该消费者自动被删除；正常退出，退出后就会删除消费者；新增消费者，需等约2秒触发rebalance，该消费者在服务端状态变为ready； -- 消费组rebalance会对该组所有ready状态的消费者成员重新进行vgroup分配，消费者仅能对自己负责的vgroup进行assignment/seek/commit/poll操作； -- 消费者可利用 position 获得当前消费的offset，并seek到指定offset，重新消费； -- seek将position指向指定offset，不执行commit操作，一旦seek成功，可poll拉取指定offset及以后的数据； -- seek 操作之前须调用 assignment 接口获取该consumer的vgroup ID和offset范围。seek 操作会检测vgroup ID 和 offset是否合法，如非法将报错； -- position是获取当前的消费位置，是下次要取的位置，不是当前消费到的位置 -- commit是提交消费位置，不带参数的话，是提交当前消费位置（下次要取的位置，不是当前消费到的位置），带参数的话，是提交参数里的位置（也即下次退出重启后要取的位置） -- seek是设置consumer消费位置，seek到哪，position就返回哪，都是下次要取的位置 -- seek不会影响commit，commit不影响seek，相互独立，两个是不同的概念 -- begin接口为wal 第一条数据的offset，end 接口为wal 最后一条数据的offset + 1 -- offset接口获取的是记录所在结果block块里的第一条数据的offset，当seek至该offset时，将消费到这个block里的全部数据。参见第四点； -- 由于存在 WAL 过期删除机制，即使seek 操作成功，poll数据时有可能offset已失效。如果poll 的offset 小于 WAL 最小版本号，将会从WAL最小版本号消费； -- 数据订阅是从 WAL 消费数据，如果一些 WAL 文件被基于 WAL 保留策略删除，则已经删除的 WAL 文件中的数据就无法再消费到。需要根据业务需要在创建数据库时合理设置 `WAL_RETENTION_PERIOD` 或 `WAL_RETENTION_SIZE` ，并确保应用及时消费数据，这样才不会产生数据丢失的现象。数据订阅的行为与 Kafka 等广泛使用的消息队列类产品的行为相似； +![img_5.png](img_5.png) -本文档不对消息队列本身的知识做更多的介绍，如果需要了解，请自行搜索。 +TDengine 会为 WAL 文件自动创建索引以支持快速随机访问，并提供了灵活可配置的文件切换与保留机制，用户可以按需指定 WAL 文件保留的时间以及大小（详见 [CREATE DATABASE](../../12-taos-sql/02-database) 语句，由于消费是通过 WAL 实现的，所以应该根据写入消费速度来确定 WAL 的保存时长）。通过以上方式将 WAL 改造成了一个保留事件到达顺序的、可持久化的存储引擎。 -说明： +对于 `SELECT` 语句形式的 topic，在消费时，TDengine 根据当前消费进度从 WAL 直接读取数据，并使用统一的查询引擎实现过滤、变换等操作，将数据推送给消费者。 + +## 生产者 +写入 topic 相关联的数据表中数据的都是生产者，生产者实际生产的数据写入到了子表或普通表中，即表所在 vnode 的 WAL 里。 + +## 消费者 +### 消费者组 +消费者订阅 topic 后，可以消费 topic 里的所有数据（这些数据所在的表可能分布在多个 vnode 上，即 db 所在的所有 vnode）。订阅 topic 时，需要指定一个消费者组 (consumer group)，如果这个消费者组里只有一个消费者，那么这个消费者会顺序的消费这些 vnode 上的数据。 + +为了提高消费速度，便于多线程、分布式地消费数据，可以在一个消费组里添加多个消费者，这些消费者将均分数据所在的 vnode 进行消费（比如数据分布在 4 个 vnode 上，有 2 个消费者的话，那么每个消费者消费 2 个 vnode；有 3 个消费者的话，2 个消费者各消费 1 个 vnode，1 个消费者消费 2 个 vnode；有 5 个消费者的话，4 个各分配 1 个 vnode 消费，另外 1 个不消费），如下图： + +![img_6.png](img_6.png) + +在一个消费组里添加一个消费者后，在 Mnode 上通过 rebalance 的机制实现消费者的重新分配，该操作对用户是透明的。 + +一个消费者可以订阅多个 topic。TDengine 的数据订阅在宕机、重启等复杂环境下确保 at least once 消费。 +### 消费进度 +在 topic 的一个消费组的一个 vnode 上有消费进度。消费者消费的同时，可以提交消费进度，消费进度即 vnode 上 WAL 的版本号（对于 kafka 里的 offset），消费进度可以手动提交，也可以通过参数（auto.commit.interval.ms）设置为周期性自动提交。 + +首次消费数据时通过订阅参数（auto.offset.reset）来确定消费位置为最新数据（latest）还是最旧数据（earliest）。 + +消费进度在一个 vnode 上对于同一个 topic 和 消费者组是唯一的。所以如果同一个 topic 和 消费者组在一个 vnode 上的消费者退出了，并且提交了消费进度。然后同一个 topic 和 消费者组里重新建了一个新的消费者消费这个 vnode，那么这个新消费者将继承之前的消费进度继续消费。 + +如果之前的消费者没有提交消费进度，那个新的消费者将根据订阅参数（auto.offset.reset）设置的值来确定起始消费位置。 + +不同消费者组中的消费者即使消费同一个 topic, 并不共享消费进度。 + +![img_7.png](img_7.png) + +作为一个数据库产品， WAL 文件中存储的不全是数据，也包括其他写入消息，元数据等，所以消费进度不是连续的。 + +##说明 从3.2.0.0版本开始，数据订阅支持vnode迁移和分裂。 -由于数据订阅依赖wal文件，而在vnode迁移和分裂的过程中，wal并不会同步过去，所以迁移或分裂后，之前没消费完的wal数据后消费不到。所以请保证之前把数据全部消费完后，再进行vnode迁移或分裂，否则，消费会丢失数据。 -## 主要数据结构和 API +由于数据订阅依赖wal文件，而在vnode迁移和分裂的过程中，wal并不会同步过去，所以迁移或分裂后，之前没消费完的wal数据后消费不到。所以请保证迁移和分裂之前把数据全部消费完后，再进行vnode迁移或分裂，否则，消费会丢失数据。 -不同语言下， TMQ 订阅相关的 API 及数据结构如下（注意consumer结构不是线程安全的，在一个线程使用consumer时，不要在另一个线程close这个consumer）： +# 语法说明 - - +具体的语法参见 [数据订阅](../../12-taos-sql/13-tmq) -```c - typedef struct tmq_t tmq_t; - typedef struct tmq_conf_t tmq_conf_t; - typedef struct tmq_list_t tmq_list_t; +# 消费参数 - typedef void(tmq_commit_cb(tmq_t *tmq, int32_t code, void *param)); - - typedef enum tmq_conf_res_t { - TMQ_CONF_UNKNOWN = -2, - TMQ_CONF_INVALID = -1, - TMQ_CONF_OK = 0, - } tmq_conf_res_t; - - typedef struct tmq_topic_assignment { - int32_t vgId; - int64_t currentOffset; - int64_t begin; - int64_t end; - } tmq_topic_assignment; - - DLL_EXPORT tmq_conf_t *tmq_conf_new(); - DLL_EXPORT tmq_conf_res_t tmq_conf_set(tmq_conf_t *conf, const char *key, const char *value); - DLL_EXPORT void tmq_conf_destroy(tmq_conf_t *conf); - DLL_EXPORT void tmq_conf_set_auto_commit_cb(tmq_conf_t *conf, tmq_commit_cb *cb, void *param); - - DLL_EXPORT tmq_list_t *tmq_list_new(); - DLL_EXPORT int32_t tmq_list_append(tmq_list_t *, const char *); - DLL_EXPORT void tmq_list_destroy(tmq_list_t *); - DLL_EXPORT int32_t tmq_list_get_size(const tmq_list_t *); - DLL_EXPORT char **tmq_list_to_c_array(const tmq_list_t *); - - DLL_EXPORT tmq_t *tmq_consumer_new(tmq_conf_t *conf, char *errstr, int32_t errstrLen); - DLL_EXPORT int32_t tmq_subscribe(tmq_t *tmq, const tmq_list_t *topic_list); - DLL_EXPORT int32_t tmq_unsubscribe(tmq_t *tmq); - DLL_EXPORT int32_t tmq_subscription(tmq_t *tmq, tmq_list_t **topics); - DLL_EXPORT TAOS_RES *tmq_consumer_poll(tmq_t *tmq, int64_t timeout); - DLL_EXPORT int32_t tmq_consumer_close(tmq_t *tmq); - DLL_EXPORT int32_t tmq_commit_sync(tmq_t *tmq, const TAOS_RES *msg); - DLL_EXPORT void tmq_commit_async(tmq_t *tmq, const TAOS_RES *msg, tmq_commit_cb *cb, void *param); - DLL_EXPORT int32_t tmq_commit_offset_sync(tmq_t *tmq, const char *pTopicName, int32_t vgId, int64_t offset); - DLL_EXPORT void tmq_commit_offset_async(tmq_t *tmq, const char *pTopicName, int32_t vgId, int64_t offset, tmq_commit_cb *cb, void *param); - DLL_EXPORT int32_t tmq_get_topic_assignment(tmq_t *tmq, const char *pTopicName, tmq_topic_assignment **assignment,int32_t *numOfAssignment); - DLL_EXPORT void tmq_free_assignment(tmq_topic_assignment* pAssignment); - DLL_EXPORT int32_t tmq_offset_seek(tmq_t *tmq, const char *pTopicName, int32_t vgId, int64_t offset); - DLL_EXPORT int64_t tmq_position(tmq_t *tmq, const char *pTopicName, int32_t vgId); - DLL_EXPORT int64_t tmq_committed(tmq_t *tmq, const char *pTopicName, int32_t vgId); - - DLL_EXPORT const char *tmq_get_topic_name(TAOS_RES *res); - DLL_EXPORT const char *tmq_get_db_name(TAOS_RES *res); - DLL_EXPORT int32_t tmq_get_vgroup_id(TAOS_RES *res); - DLL_EXPORT int64_t tmq_get_vgroup_offset(TAOS_RES* res); - DLL_EXPORT const char *tmq_err2str(int32_t code); -``` - -下面介绍一下它们的具体用法（超级表和子表结构请参考“数据建模”一节），完整的示例代码请见下面 C 语言的示例代码。 - - - - -```java -void subscribe(Collection topics) throws SQLException; - -void unsubscribe() throws SQLException; - -Set subscription() throws SQLException; - -ConsumerRecords poll(Duration timeout) throws SQLException; - -Set assignment() throws SQLException; -long position(TopicPartition partition) throws SQLException; -Map position(String topic) throws SQLException; -Map beginningOffsets(String topic) throws SQLException; -Map endOffsets(String topic) throws SQLException; -Map committed(Set partitions) throws SQLException; - -void seek(TopicPartition partition, long offset) throws SQLException; -void seekToBeginning(Collection partitions) throws SQLException; -void seekToEnd(Collection partitions) throws SQLException; - -void commitSync() throws SQLException; -void commitSync(Map offsets) throws SQLException; - -void close() throws SQLException; -``` - - - - - -```python -class Consumer: - def subscribe(self, topics): - pass - - def unsubscribe(self): - pass - - def poll(self, timeout: float = 1.0): - pass - - def assignment(self): - pass - - def seek(self, partition): - pass - - def close(self): - pass - - def commit(self, message): - pass -``` - - - - - -```go -func NewConsumer(conf *tmq.ConfigMap) (*Consumer, error) - -// 出于兼容目的保留 rebalanceCb 参数，当前未使用 -func (c *Consumer) Subscribe(topic string, rebalanceCb RebalanceCb) error - -// 出于兼容目的保留 rebalanceCb 参数，当前未使用 -func (c *Consumer) SubscribeTopics(topics []string, rebalanceCb RebalanceCb) error - -func (c *Consumer) Poll(timeoutMs int) tmq.Event - -// 出于兼容目的保留 tmq.TopicPartition 参数，当前未使用 -func (c *Consumer) Commit() ([]tmq.TopicPartition, error) - -func (c *Consumer) Unsubscribe() error - -func (c *Consumer) Close() error -``` - - - - - -```rust -impl TBuilder for TmqBuilder - fn from_dsn(dsn: D) -> Result - fn build(&self) -> Result - -impl AsAsyncConsumer for Consumer - async fn subscribe, I: IntoIterator + Send>( - &mut self, - topics: I, - ) -> Result<(), Self::Error>; - fn stream( - &self, - ) -> Pin< - Box< - dyn '_ - + Send - + futures::Stream< - Item = Result<(Self::Offset, MessageSet), Self::Error>, - >, - >, - >; - async fn commit(&self, offset: Self::Offset) -> Result<(), Self::Error>; - - async fn unsubscribe(self); -``` - -可在 上查看详细 API 说明。 - - - - - -```js -function TMQConsumer(config) - -function subscribe(topic) - -function consume(timeout) - -function subscription() - -function unsubscribe() - -function commit(msg) - -function close() -``` - - - - - -```csharp -class ConsumerBuilder - -ConsumerBuilder(IEnumerable> config) - -public IConsumer Build() - -void Subscribe(IEnumerable topics) - -void Subscribe(string topic) - -ConsumeResult Consume(int millisecondsTimeout) - -List Subscription() - -void Unsubscribe() - -List Commit() - -void Close() -``` - - - - -## 写入数据 - -首先完成建库、建一张超级表和多张子表操作，然后就可以写入数据了，比如： - -```sql -DROP DATABASE IF EXISTS tmqdb; -CREATE DATABASE tmqdb WAL_RETENTION_PERIOD 3600; -CREATE TABLE tmqdb.stb (ts TIMESTAMP, c1 INT, c2 FLOAT, c3 VARCHAR(16)) TAGS(t1 INT, t3 VARCHAR(16)); -CREATE TABLE tmqdb.ctb0 USING tmqdb.stb TAGS(0, "subtable0"); -CREATE TABLE tmqdb.ctb1 USING tmqdb.stb TAGS(1, "subtable1"); -INSERT INTO tmqdb.ctb0 VALUES(now, 0, 0, 'a0')(now+1s, 0, 0, 'a00'); -INSERT INTO tmqdb.ctb1 VALUES(now, 1, 1, 'a1')(now+1s, 11, 11, 'a11'); -``` - -## 创建 *topic* - -TDengine 使用 SQL 创建一个 topic： - -```sql -CREATE TOPIC topic_name AS SELECT ts, c1, c2, c3 FROM tmqdb.stb WHERE c1 > 1; -``` -- topic创建个数有上限，通过参数 tmqMaxTopicNum 控制，默认 20 个 - -TMQ 支持多种订阅类型： - -### 列订阅 - -语法： - -```sql -CREATE TOPIC topic_name as subquery -``` - -通过 `SELECT` 语句订阅（包括 `SELECT *`，或 `SELECT ts, c1` 等指定列订阅，可以带条件过滤、标量函数计算，但不支持聚合函数、不支持时间窗口聚合）。需要注意的是： - -- 该类型 TOPIC 一旦创建则订阅数据的结构确定。 -- 被订阅或用于计算的列或标签不可被删除（`ALTER table DROP`）、修改（`ALTER table MODIFY`）。 -- 若发生表结构变更，新增的列不出现在结果中。 - -### 超级表订阅 - -语法： - -```sql -CREATE TOPIC topic_name [with meta] AS STABLE stb_name [where_condition] -``` - -与 `SELECT * from stbName` 订阅的区别是： - -- 不会限制用户的表结构变更。 -- 返回的是非结构化的数据：返回数据的结构会随之超级表的表结构变化而变化。 -- with meta 参数可选，选择时将返回创建超级表，子表等语句，主要用于taosx做超级表迁移 -- where_condition 参数可选，选择时将用来过滤符合条件的子表，订阅这些子表。where 条件里不能有普通列，只能是tag或tbname，where条件里可以用函数，用来过滤tag，但是不能是聚合函数，因为子表tag值无法做聚合。也可以是常量表达式，比如 2 > 1（订阅全部子表），或者 false（订阅0个子表） -- 返回数据不包含标签。 - -### 数据库订阅 - -语法： - -```sql -CREATE TOPIC topic_name [with meta] AS DATABASE db_name; -``` - -通过该语句可创建一个包含数据库所有表数据的订阅 - -- with meta 参数可选，选择时将返回创建数据库里所有超级表，子表的语句，主要用于taosx做数据库迁移 - -## 创建消费者 *consumer* - -消费者需要通过一系列配置选项创建，基础配置项如下表所示： +消费参数主要用于消费者创建时指定，基础配置项如下表所示： | 参数名称 | 类型 | 参数说明 | 备注 | | :----------------------------: | :-----: | -------------------------------------------------------- | ------------------------------------------- | @@ -358,515 +86,714 @@ CREATE TOPIC topic_name [with meta] AS DATABASE db_name; | `msg.with.table.name` | boolean | 是否允许从消息中解析表名, 不适用于列订阅（列订阅时可将 tbname 作为列写入 subquery 语句）（从3.2.0.0版本该参数废弃，恒为true） |默认关闭 | | `enable.replay` | boolean | 是否开启数据回放功能 |默认关闭 | -对于不同编程语言，其设置方式如下： +# 主要数据结构和 API 接口 + +不同语言下， TMQ 订阅相关的 API 及数据结构如下（详细的接口说明可以参考连接器章节，注意consumer结构不是线程安全的，在一个线程使用consumer时，不要在另一个线程close这个consumer）： - + -```c -/* 根据需要，设置消费组 (group.id)、自动提交 (enable.auto.commit)、 - 自动提交时间间隔 (auto.commit.interval.ms)、用户名 (td.connect.user)、密码 (td.connect.pass) 等参数 */ -tmq_conf_t* conf = tmq_conf_new(); -tmq_conf_set(conf, "enable.auto.commit", "true"); -tmq_conf_set(conf, "auto.commit.interval.ms", "1000"); -tmq_conf_set(conf, "group.id", "cgrpName"); -tmq_conf_set(conf, "td.connect.user", "root"); -tmq_conf_set(conf, "td.connect.pass", "taosdata"); -tmq_conf_set(conf, "auto.offset.reset", "latest"); -tmq_conf_set(conf, "msg.with.table.name", "true"); -tmq_conf_set_auto_commit_cb(conf, tmq_commit_cb_print, NULL); + ```c + typedef struct tmq_t tmq_t; + typedef struct tmq_conf_t tmq_conf_t; + typedef struct tmq_list_t tmq_list_t; -tmq_t* tmq = tmq_consumer_new(conf, NULL, 0); -tmq_conf_destroy(conf); + typedef void(tmq_commit_cb(tmq_t *tmq, int32_t code, void *param)); + + typedef enum tmq_conf_res_t { + TMQ_CONF_UNKNOWN = -2, + TMQ_CONF_INVALID = -1, + TMQ_CONF_OK = 0, + } tmq_conf_res_t; + + typedef struct tmq_topic_assignment { + int32_t vgId; + int64_t currentOffset; + int64_t begin; + int64_t end; + } tmq_topic_assignment; + + DLL_EXPORT tmq_conf_t *tmq_conf_new(); + DLL_EXPORT tmq_conf_res_t tmq_conf_set(tmq_conf_t *conf, const char *key, const char *value); + DLL_EXPORT void tmq_conf_destroy(tmq_conf_t *conf); + DLL_EXPORT void tmq_conf_set_auto_commit_cb(tmq_conf_t *conf, tmq_commit_cb *cb, void *param); + + DLL_EXPORT tmq_list_t *tmq_list_new(); + DLL_EXPORT int32_t tmq_list_append(tmq_list_t *, const char *); + DLL_EXPORT void tmq_list_destroy(tmq_list_t *); + DLL_EXPORT int32_t tmq_list_get_size(const tmq_list_t *); + DLL_EXPORT char **tmq_list_to_c_array(const tmq_list_t *); + + DLL_EXPORT tmq_t *tmq_consumer_new(tmq_conf_t *conf, char *errstr, int32_t errstrLen); + DLL_EXPORT int32_t tmq_subscribe(tmq_t *tmq, const tmq_list_t *topic_list); + DLL_EXPORT int32_t tmq_unsubscribe(tmq_t *tmq); + DLL_EXPORT int32_t tmq_subscription(tmq_t *tmq, tmq_list_t **topics); + DLL_EXPORT TAOS_RES *tmq_consumer_poll(tmq_t *tmq, int64_t timeout); + DLL_EXPORT int32_t tmq_consumer_close(tmq_t *tmq); + DLL_EXPORT int32_t tmq_commit_sync(tmq_t *tmq, const TAOS_RES *msg); + DLL_EXPORT void tmq_commit_async(tmq_t *tmq, const TAOS_RES *msg, tmq_commit_cb *cb, void *param); + DLL_EXPORT int32_t tmq_commit_offset_sync(tmq_t *tmq, const char *pTopicName, int32_t vgId, int64_t offset); + DLL_EXPORT void tmq_commit_offset_async(tmq_t *tmq, const char *pTopicName, int32_t vgId, int64_t offset, tmq_commit_cb *cb, void *param); + DLL_EXPORT int32_t tmq_get_topic_assignment(tmq_t *tmq, const char *pTopicName, tmq_topic_assignment **assignment,int32_t *numOfAssignment); + DLL_EXPORT void tmq_free_assignment(tmq_topic_assignment* pAssignment); + DLL_EXPORT int32_t tmq_offset_seek(tmq_t *tmq, const char *pTopicName, int32_t vgId, int64_t offset); + DLL_EXPORT int64_t tmq_position(tmq_t *tmq, const char *pTopicName, int32_t vgId); + DLL_EXPORT int64_t tmq_committed(tmq_t *tmq, const char *pTopicName, int32_t vgId); + + DLL_EXPORT const char *tmq_get_topic_name(TAOS_RES *res); + DLL_EXPORT const char *tmq_get_db_name(TAOS_RES *res); + DLL_EXPORT int32_t tmq_get_vgroup_id(TAOS_RES *res); + DLL_EXPORT int64_t tmq_get_vgroup_offset(TAOS_RES* res); + DLL_EXPORT const char *tmq_err2str(int32_t code); + ``` + + + + + ```java + void subscribe(Collection topics) throws SQLException; + + void unsubscribe() throws SQLException; + + Set subscription() throws SQLException; + + ConsumerRecords poll(Duration timeout) throws SQLException; + + Set assignment() throws SQLException; + long position(TopicPartition partition) throws SQLException; + Map position(String topic) throws SQLException; + Map beginningOffsets(String topic) throws SQLException; + Map endOffsets(String topic) throws SQLException; + Map committed(Set partitions) throws SQLException; + + void seek(TopicPartition partition, long offset) throws SQLException; + void seekToBeginning(Collection partitions) throws SQLException; + void seekToEnd(Collection partitions) throws SQLException; + + void commitSync() throws SQLException; + void commitSync(Map offsets) throws SQLException; + + void close() throws SQLException; + ``` + + + + + + ```python + class Consumer: + def subscribe(self, topics): + pass + + def unsubscribe(self): + pass + + def poll(self, timeout: float = 1.0): + pass + + def assignment(self): + pass + + def seek(self, partition): + pass + + def close(self): + pass + + def commit(self, message): + pass + ``` + + + + + + ```go + func NewConsumer(conf *tmq.ConfigMap) (*Consumer, error) + + // 出于兼容目的保留 rebalanceCb 参数，当前未使用 + func (c *Consumer) Subscribe(topic string, rebalanceCb RebalanceCb) error + + // 出于兼容目的保留 rebalanceCb 参数，当前未使用 + func (c *Consumer) SubscribeTopics(topics []string, rebalanceCb RebalanceCb) error + + func (c *Consumer) Poll(timeoutMs int) tmq.Event + + // 出于兼容目的保留 tmq.TopicPartition 参数，当前未使用 + func (c *Consumer) Commit() ([]tmq.TopicPartition, error) + + func (c *Consumer) Unsubscribe() error + + func (c *Consumer) Close() error + ``` + + + + + + ```rust + impl TBuilder for TmqBuilder + fn from_dsn(dsn: D) -> Result + fn build(&self) -> Result + + impl AsAsyncConsumer for Consumer + async fn subscribe, I: IntoIterator + Send>( + &mut self, + topics: I, + ) -> Result<(), Self::Error>; + fn stream( + &self, + ) -> Pin< + Box< + dyn '_ + + Send + + futures::Stream< + Item = Result<(Self::Offset, MessageSet), Self::Error>, + >, + >, + >; + async fn commit(&self, offset: Self::Offset) -> Result<(), Self::Error>; + + async fn unsubscribe(self); + ``` + + 可在 上查看详细 API 说明。 + + + + + + ```js + function TMQConsumer(config) + + function subscribe(topic) + + function consume(timeout) + + function subscription() + + function unsubscribe() + + function commit(msg) + + function close() + ``` + + + + + + ```csharp + class ConsumerBuilder + + ConsumerBuilder(IEnumerable> config) + + public IConsumer Build() + + void Subscribe(IEnumerable topics) + + void Subscribe(string topic) + + ConsumeResult Consume(int millisecondsTimeout) + + List Subscription() + + void Unsubscribe() + + List Commit() + + void Close() + ``` + + + + + # 数据订阅示例 + ## 写入数据 + + 首先完成建库、建一张超级表和多张子表操作，然后就可以写入数据了，比如： + + ```sql + DROP DATABASE IF EXISTS tmqdb; + CREATE DATABASE tmqdb WAL_RETENTION_PERIOD 3600; + CREATE TABLE tmqdb.stb (ts TIMESTAMP, c1 INT, c2 FLOAT, c3 VARCHAR(16)) TAGS(t1 INT, t3 VARCHAR(16)); + CREATE TABLE tmqdb.ctb0 USING tmqdb.stb TAGS(0, "subtable0"); + CREATE TABLE tmqdb.ctb1 USING tmqdb.stb TAGS(1, "subtable1"); + INSERT INTO tmqdb.ctb0 VALUES(now, 0, 0, 'a0')(now+1s, 0, 0, 'a00'); +INSERT INTO tmqdb.ctb1 VALUES(now, 1, 1, 'a1')(now+1s, 11, 11, 'a11'); ``` +## 创建 topic - - + 使用 SQL 创建一个 topic： -对于 Java 程序，还可以使用如下配置项： + ```sql + CREATE TOPIC topic_name AS SELECT ts, c1, c2, c3 FROM tmqdb.stb WHERE c1 > 1; + ``` -| 参数名称 | 类型 | 参数说明 | -| ----------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- | -| `td.connect.type` | string | 连接类型，"jni" 指原生连接，"ws" 指 websocket 连接，默认值为 "jni" | -| `bootstrap.servers` | string | 连接地址，如 `localhost:6030` | -| `value.deserializer` | string | 值解析方法，使用此方法应实现 `com.taosdata.jdbc.tmq.Deserializer` 接口或继承 `com.taosdata.jdbc.tmq.ReferenceDeserializer` 类 | -| `value.deserializer.encoding` | string | 指定字符串解析的字符集 | | + ## 创建消费者 *consumer* -需要注意：此处使用 `bootstrap.servers` 替代 `td.connect.ip` 和 `td.connect.port`，以提供与 Kafka 一致的接口。 + 对于不同编程语言，其设置方式如下： -```java -Properties properties = new Properties(); -properties.setProperty("enable.auto.commit", "true"); -properties.setProperty("auto.commit.interval.ms", "1000"); -properties.setProperty("group.id", "cgrpName"); -properties.setProperty("bootstrap.servers", "127.0.0.1:6030"); -properties.setProperty("td.connect.user", "root"); -properties.setProperty("td.connect.pass", "taosdata"); -properties.setProperty("auto.offset.reset", "latest"); -properties.setProperty("msg.with.table.name", "true"); -properties.setProperty("value.deserializer", "com.taos.example.MetersDeserializer"); + + -TaosConsumer consumer = new TaosConsumer<>(properties); + ```c + /* 根据需要，设置消费组 (group.id)、自动提交 (enable.auto.commit)、 + 自动提交时间间隔 (auto.commit.interval.ms)、用户名 (td.connect.user)、密码 (td.connect.pass) 等参数 */ + tmq_conf_t* conf = tmq_conf_new(); + tmq_conf_set(conf, "enable.auto.commit", "true"); + tmq_conf_set(conf, "auto.commit.interval.ms", "1000"); + tmq_conf_set(conf, "group.id", "cgrpName"); + tmq_conf_set(conf, "td.connect.user", "root"); + tmq_conf_set(conf, "td.connect.pass", "taosdata"); + tmq_conf_set(conf, "auto.offset.reset", "latest"); + tmq_conf_set(conf, "msg.with.table.name", "true"); + tmq_conf_set_auto_commit_cb(conf, tmq_commit_cb_print, NULL); -/* value deserializer definition. */ -import com.taosdata.jdbc.tmq.ReferenceDeserializer; + tmq_t* tmq = tmq_consumer_new(conf, NULL, 0); + tmq_conf_destroy(conf); + ``` -public class MetersDeserializer extends ReferenceDeserializer { -} -``` + + - + 对于 Java 程序，还可以使用如下配置项： - + | 参数名称 | 类型 | 参数说明 | + | ----------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- | + | `td.connect.type` | string | 连接类型，"jni" 指原生连接，"ws" 指 websocket 连接，默认值为 "jni" | + | `bootstrap.servers` | string | 连接地址，如 `localhost:6030` | + | `value.deserializer` | string | 值解析方法，使用此方法应实现 `com.taosdata.jdbc.tmq.Deserializer` 接口或继承 `com.taosdata.jdbc.tmq.ReferenceDeserializer` 类 | + | `value.deserializer.encoding` | string | 指定字符串解析的字符集 | | -```go -conf := &tmq.ConfigMap{ - "group.id": "test", - "auto.offset.reset": "latest", - "td.connect.ip": "127.0.0.1", - "td.connect.user": "root", - "td.connect.pass": "taosdata", - "td.connect.port": "6030", - "client.id": "test_tmq_c", - "enable.auto.commit": "false", - "msg.with.table.name": "true", -} -consumer, err := NewConsumer(conf) -``` + 需要注意：此处使用 `bootstrap.servers` 替代 `td.connect.ip` 和 `td.connect.port`，以提供与 Kafka 一致的接口。 - + ```java + Properties properties = new Properties(); + properties.setProperty("enable.auto.commit", "true"); + properties.setProperty("auto.commit.interval.ms", "1000"); + properties.setProperty("group.id", "cgrpName"); + properties.setProperty("bootstrap.servers", "127.0.0.1:6030"); + properties.setProperty("td.connect.user", "root"); + properties.setProperty("td.connect.pass", "taosdata"); + properties.setProperty("auto.offset.reset", "latest"); + properties.setProperty("msg.with.table.name", "true"); + properties.setProperty("value.deserializer", "com.taos.example.MetersDeserializer"); - + TaosConsumer consumer = new TaosConsumer<>(properties); -```rust -let mut dsn: Dsn = "taos://".parse()?; -dsn.set("group.id", "group1"); -dsn.set("client.id", "test"); -dsn.set("auto.offset.reset", "latest"); + /* value deserializer definition. */ + import com.taosdata.jdbc.tmq.ReferenceDeserializer; -let tmq = TmqBuilder::from_dsn(dsn)?; + public class MetersDeserializer extends ReferenceDeserializer { + } + ``` -let mut consumer = tmq.build()?; -``` + - + - + ```go + conf := &tmq.ConfigMap{ + "group.id": "test", + "auto.offset.reset": "latest", + "td.connect.ip": "127.0.0.1", + "td.connect.user": "root", + "td.connect.pass": "taosdata", + "td.connect.port": "6030", + "client.id": "test_tmq_c", + "enable.auto.commit": "false", + "msg.with.table.name": "true", + } + consumer, err := NewConsumer(conf) + ``` -Python 语言下引入 `taos` 库的 `Consumer` 类，创建一个 Consumer 示例： + -```python -from taos.tmq import Consumer + -# Syntax: `consumer = Consumer(configs)` -# -# Example: -consumer = Consumer( - { - "group.id": "local", - "client.id": "1", - "enable.auto.commit": "true", - "auto.commit.interval.ms": "1000", - "td.connect.ip": "127.0.0.1", - "td.connect.user": "root", - "td.connect.pass": "taosdata", - "auto.offset.reset": "latest", - "msg.with.table.name": "true", - } -) -``` + ```rust + let mut dsn: Dsn = "taos://".parse()?; + dsn.set("group.id", "group1"); + dsn.set("client.id", "test"); + dsn.set("auto.offset.reset", "latest"); - + let tmq = TmqBuilder::from_dsn(dsn)?; - + let mut consumer = tmq.build()?; + ``` -```js -// 根据需要，设置消费组 (group.id)、自动提交 (enable.auto.commit)、 -// 自动提交时间间隔 (auto.commit.interval.ms)、用户名 (td.connect.user)、密码 (td.connect.pass) 等参数 + -let consumer = taos.consumer({ - 'enable.auto.commit': 'true', + + + Python 语言下引入 `taos` 库的 `Consumer` 类，创建一个 Consumer 示例： + + ```python + from taos.tmq import Consumer + + # Syntax: `consumer = Consumer(configs)` + # + # Example: + consumer = Consumer( + { + "group.id": "local", + "client.id": "1", + "enable.auto.commit": "true", + "auto.commit.interval.ms": "1000", + "td.connect.ip": "127.0.0.1", + "td.connect.user": "root", + "td.connect.pass": "taosdata", + "auto.offset.reset": "latest", + "msg.with.table.name": "true", + } + ) + ``` + + + + + + ```js + // 根据需要，设置消费组 (group.id)、自动提交 (enable.auto.commit)、 + // 自动提交时间间隔 (auto.commit.interval.ms)、用户名 (td.connect.user)、密码 (td.connect.pass) 等参数 + + let consumer = taos.consumer({ +'enable.auto.commit': 'true', 'auto.commit.interval.ms','1000', - 'group.id': 'tg2', + 'group.id': 'tg2', 'td.connect.user': 'root', 'td.connect.pass': 'taosdata', 'auto.offset.reset','latest', 'msg.with.table.name': 'true', 'td.connect.ip','127.0.0.1', - 'td.connect.port','6030' - }); -``` + 'td.connect.port','6030' + }); + ``` -```csharp -var cfg = new Dictionary() -{ - { "group.id", "group1" }, - { "auto.offset.reset", "latest" }, - { "td.connect.ip", "127.0.0.1" }, - { "td.connect.user", "root" }, - { "td.connect.pass", "taosdata" }, - { "td.connect.port", "6030" }, - { "client.id", "tmq_example" }, - { "enable.auto.commit", "true" }, - { "msg.with.table.name", "false" }, -}; -var consumer = new ConsumerBuilder>(cfg).Build(); -``` + ```csharp + var cfg = new Dictionary() + { + { "group.id", "group1" }, + { "auto.offset.reset", "latest" }, + { "td.connect.ip", "127.0.0.1" }, + { "td.connect.user", "root" }, + { "td.connect.pass", "taosdata" }, + { "td.connect.port", "6030" }, + { "client.id", "tmq_example" }, + { "enable.auto.commit", "true" }, + { "msg.with.table.name", "false" }, + }; + var consumer = new ConsumerBuilder>(cfg).Build(); + ``` - + - + -上述配置中包括 consumer group ID，如果多个 consumer 指定的 consumer group ID 一样，则自动形成一个 consumer group，共享消费进度。 + 上述配置中包括 consumer group ID，如果多个 consumer 指定的 consumer group ID 一样，则自动形成一个 consumer group，共享消费进度。 -数据回放功能说明： -- 订阅增加 replay 功能，按照数据写入的时间回放。 - 比如，如下时间写入三条数据 - ```sql - 2023/09/22 00:00:00.000 - 2023/09/22 00:00:05.000 - 2023/09/22 00:00:08.000 - ``` - 则订阅出第一条数据 5s 后返回第二条数据，获取第二条数据 3s 后返回第三条数据。 -- 仅列订阅支持数据回放 - - 回放需要保证独立时间线 - - 如果是子表订阅或者普通表订阅，只有一个vnode上有数据，保证是一个时间线 - - 如果超级表订阅，则需保证该 DB 只有一个vnode，否则报错（因为多个vnode上订阅出的数据不在一个时间线上） -- 超级表和库订阅不支持回放 -- 增加 enable.replay 参数，true表示开启订阅回放功能，false表示不开启订阅回放功能，默认不开启。 -- 回放不支持进度保存，所以回放参数 enable.replay = true 时，auto commit 自动关闭 -- 因为数据回放本身需要处理时间，所以回放的精度存在几十ms的误差 + ## 订阅 *topics* -## 订阅 *topics* + 一个 consumer 支持同时订阅多个 topic。 -一个 consumer 支持同时订阅多个 topic。 - - - + + ```c -// 创建订阅 topics 列表 -tmq_list_t* topicList = tmq_list_new(); -tmq_list_append(topicList, "topicName"); -// 启动订阅 -tmq_subscribe(tmq, topicList); -tmq_list_destroy(topicList); - -``` + // 创建订阅 topics 列表 + tmq_list_t* topicList = tmq_list_new(); + tmq_list_append(topicList, "topicName"); + // 启动订阅 + tmq_subscribe(tmq, topicList); + tmq_list_destroy(topicList); + + ``` -```java -List topics = new ArrayList<>(); -topics.add("tmq_topic"); -consumer.subscribe(topics); -``` + ```java + List topics = new ArrayList<>(); + topics.add("tmq_topic"); + consumer.subscribe(topics); + ``` -```go -err = consumer.Subscribe("example_tmq_topic", nil) -if err != nil { - panic(err) -} -``` + ```go + err = consumer.Subscribe("example_tmq_topic", nil) + if err != nil { + panic(err) + } + ``` - - + + ```rust -consumer.subscribe(["tmq_meters"]).await?; -``` + consumer.subscribe(["tmq_meters"]).await?; + ``` - + - + ```python -consumer.subscribe(['topic1', 'topic2']) -``` + consumer.subscribe(['topic1', 'topic2']) + ``` - + - + ```js -// 创建订阅 topics 列表 -let topics = ['topic_test'] + // 创建订阅 topics 列表 + let topics = ['topic_test'] -// 启动订阅 -consumer.subscribe(topics); -``` + // 启动订阅 + consumer.subscribe(topics); + ``` - + - + ```csharp -// 创建订阅 topics 列表 -List topics = new List(); -topics.add("tmq_topic"); -// 启动订阅 -consumer.Subscribe(topics); -``` + // 创建订阅 topics 列表 + List topics = new List(); + topics.add("tmq_topic"); + // 启动订阅 + consumer.Subscribe(topics); + ``` - + - + -## 消费 + ## 消费 -以下代码展示了不同语言下如何对 TMQ 消息进行消费。 + 以下代码展示了不同语言下如何对 TMQ 消息进行消费。 - - + + ```c -// 消费数据 -while (running) { - TAOS_RES* msg = tmq_consumer_poll(tmq, timeOut); - msg_process(msg); -} -``` + // 消费数据 + while (running) { + TAOS_RES* msg = tmq_consumer_poll(tmq, timeOut); + msg_process(msg); + } + ``` 这里是一个 **while** 循环，每调用一次 tmq_consumer_poll()，获取一个消息，该消息与普通查询返回的结果集完全相同，可以使用相同的解析 API 完成消息内容的解析。 -```java -while(running){ - ConsumerRecords meters = consumer.poll(Duration.ofMillis(100)); - for (Meters meter : meters) { - processMsg(meter); - } -} -``` + ```java + while(running){ + ConsumerRecords meters = consumer.poll(Duration.ofMillis(100)); + for (Meters meter : meters) { + processMsg(meter); + } + } + ``` -```go -for { - ev := consumer.Poll(0) - if ev != nil { - switch e := ev.(type) { - case *tmqcommon.DataMessage: - fmt.Println(e.Value()) - case tmqcommon.Error: - fmt.Fprintf(os.Stderr, "%% Error: %v: %v\n", e.Code(), e) - panic(e) - } - consumer.Commit() - } -} -``` + ```go + for { + ev := consumer.Poll(0) + if ev != nil { + switch e := ev.(type) { + case *tmqcommon.DataMessage: + fmt.Println(e.Value()) + case tmqcommon.Error: + fmt.Fprintf(os.Stderr, "%% Error: %v: %v\n", e.Code(), e) + panic(e) + } + consumer.Commit() + } + } + ``` -```rust -{ - let mut stream = consumer.stream(); + ```rust + { + let mut stream = consumer.stream(); - while let Some((offset, message)) = stream.try_next().await? { - // get information from offset + while let Some((offset, message)) = stream.try_next().await? { + // get information from offset - // the topic - let topic = offset.topic(); - // the vgroup id, like partition id in kafka. - let vgroup_id = offset.vgroup_id(); - println!("* in vgroup id {vgroup_id} of topic {topic}\n"); + // the topic + let topic = offset.topic(); + // the vgroup id, like partition id in kafka. + let vgroup_id = offset.vgroup_id(); + println!("* in vgroup id {vgroup_id} of topic {topic}\n"); - if let Some(data) = message.into_data() { + if let Some(data) = message.into_data() { while let Some(block) = data.fetch_raw_block().await? { - // one block for one table, get table name if needed - let name = block.table_name(); - let records: Vec = block.deserialize().try_collect()?; - println!( - "** table: {}, got {} records: {:#?}\n", - name.unwrap(), - records.len(), - records - ); - } + // one block for one table, get table name if needed + let name = block.table_name(); + let records: Vec = block.deserialize().try_collect()?; + println!( + "** table: {}, got {} records: {:#?}\n", + name.unwrap(), + records.len(), + records + ); } - consumer.commit(offset).await?; - } -} -``` + } + consumer.commit(offset).await?; + } + } + ``` -```python -while True: - res = consumer.poll(100) - if not res: + ```python + while True: + res = consumer.poll(100) + if not res: continue - err = res.error() - if err is not None: + err = res.error() + if err is not None: raise err - val = res.value() + val = res.value() - for block in val: + for block in val: print(block.fetchall()) -``` + ``` -```js -while(true){ - msg = consumer.consume(200); - // process message(consumeResult) - console.log(msg.topicPartition); - console.log(msg.block); - console.log(msg.fields) -} -``` + ```js + while(true){ + msg = consumer.consume(200); + // process message(consumeResult) + console.log(msg.topicPartition); + console.log(msg.block); + console.log(msg.fields) + } + ``` - + - + ```csharp -// 消费数据 -while (true) -{ - using (var result = consumer.Consume(500)) - { - if (result == null) continue; - ProcessMsg(result); - consumer.Commit(); - } -} -``` + // 消费数据 + while (true) + { + using (var result = consumer.Consume(500)) + { + if (result == null) continue; + ProcessMsg(result); + consumer.Commit(); + } + } + ``` - + - + -## 结束消费 + ## 结束消费 -消费结束后，应当取消订阅。 + 消费结束后，应当取消订阅。 - - + + ```c -/* 取消订阅 */ -tmq_unsubscribe(tmq); + /* 取消订阅 */ + tmq_unsubscribe(tmq); -/* 关闭消费者对象 */ -tmq_consumer_close(tmq); -``` + /* 关闭消费者对象 */ + tmq_consumer_close(tmq); + ``` - - + + ```java -/* 取消订阅 */ -consumer.unsubscribe(); + /* 取消订阅 */ + consumer.unsubscribe(); -/* 关闭消费 */ -consumer.close(); -``` + /* 关闭消费 */ + consumer.close(); + ``` - + - + ```go -/* Unsubscribe */ -_ = consumer.Unsubscribe() + /* Unsubscribe */ + _ = consumer.Unsubscribe() -/* Close consumer */ -_ = consumer.Close() -``` + /* Close consumer */ + _ = consumer.Close() + ``` - + - + ```rust -consumer.unsubscribe().await; -``` + consumer.unsubscribe().await; + ``` - + - + ```py -# 取消订阅 -consumer.unsubscribe() -# 关闭消费 -consumer.close() -``` + # 取消订阅 + consumer.unsubscribe() + # 关闭消费 + consumer.close() + ``` - - + + ```js -consumer.unsubscribe(); -consumer.close(); -``` + consumer.unsubscribe(); + consumer.close(); + ``` - + - + ```csharp -// 取消订阅 -consumer.Unsubscribe(); + // 取消订阅 + consumer.Unsubscribe(); -// 关闭消费 -consumer.Close(); -``` + // 关闭消费 + consumer.Close(); + ``` -## 删除 *topic* - -如果不再需要订阅数据，可以删除 topic，需要注意：只有当前未在订阅中的 TOPIC 才能被删除。 - -```sql -/* 删除 topic */ -DROP TOPIC topic_name; -``` - -## 状态查看 - -1、*topics*：查询已经创建的 topic - -```sql -SHOW TOPICS; -``` - -2、consumers：查询 consumer 的状态及其订阅的 topic - -```sql -SHOW CONSUMERS; -``` - -3、subscriptions：查询 consumer 与 vgroup 之间的分配关系 - -```sql -SHOW SUBSCRIPTIONS; -``` - -## 示例代码 +## 完整示例代码 以下是各语言的完整示例代码。 @@ -908,3 +835,22 @@ SHOW SUBSCRIPTIONS; + +#订阅高级功能 +##数据回放 +- 订阅支持 replay 功能，按照数据写入的时间回放。 + 比如，如下时间写入三条数据 + ```sql + 2023/09/22 00:00:00.000 + 2023/09/22 00:00:05.000 + 2023/09/22 00:00:08.000 + ``` + 则订阅出第一条数据 5s 后返回第二条数据，获取第二条数据 3s 后返回第三条数据。 +- 仅查询订阅支持数据回放 + - 回放需要保证独立时间线 + - 如果是子表订阅或者普通表订阅，只有一个vnode上有数据，保证是一个时间线 + - 如果超级表订阅，则需保证该 DB 只有一个vnode，否则报错（因为多个vnode上订阅出的数据不在一个时间线上） +- 超级表和库订阅不支持回放 +- enable.replay 参数，true表示开启订阅回放功能，false表示不开启订阅回放功能，默认不开启。 +- 回放不支持进度保存，所以回放参数 enable.replay = true 时，auto commit 自动关闭 +- 因为数据回放本身需要处理时间，所以回放的精度存在几十ms的误差 \ No newline at end of file diff --git a/docs/zh/07-develop/img_5.png b/docs/zh/07-develop/img_5.png new file mode 100644 index 0000000000000000000000000000000000000000..d9306cdb74f9876595909e3e7fde28a248561abb GIT binary patch literal 18871 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 bpLLE{&g@44X8FJanHW4>{an^LB{Ts5c2S;| literal 0 HcmV?d00001 diff --git a/docs/zh/07-develop/img_6.png b/docs/zh/07-develop/img_6.png new file mode 100644 index 0000000000000000000000000000000000000000..0c9a0611070c295d7329c89b496b8869bb4c503d GIT binary patch literal 49305 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 EAF_}y761SM literal 0 HcmV?d00001 diff --git a/docs/zh/07-develop/img_7.png b/docs/zh/07-develop/img_7.png new file mode 100644 index 0000000000000000000000000000000000000000..0ddb005d6639364bd0ae789c7bcdaca5197240aa GIT binary patch literal 15038 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

x5pgJ099=@J|~?0a~Wn^@Q;Qd(2` z(e@rxmBsi5S#_)rFS-bkdiTcg_J-W&EPgnfLx1vYkDR3Gd>4}CM`Wnq)!9tgm6%%2 z^`z@AsXly2rP~a{{hkP`-)X>T9S3nScb;}WIxM-=oqP1Qm8lF9a$lB(L-lyJ9wC!< zVC2q^tg@ssY)-x9#2vo_u@zbG-8{4^(E_J;D0@P!>6?1MR@O;cSl4lQu+Cn)kx}Uo z`2x+UB*0xhyWX;arBI(ocdfwZ8AOdrCPq>04j*6Kr;tDU7Sst#OwuX;Xkj&UCe?$;fwdsbhJmtvF} z&DS=v_4fBTApndepYcUu8)2eXw{F{I;osJ}vGt`=f=m8f_3$@zEyb@-`{qNA;qaFR z=dCZ8u2S5{KYKSES$KI{^Q<9AAn)bnDpcB+zUw5Kr;s11FgEN;l#omc>pWc#P{0a* z?$EYLaUBJZhNsP97Ko9LpYtsVQGBkiPTtwmdPEUjAr~rME3|x@Ai`3 zAD5x>g|AM0a5=A0mF-g@Zkvz}e*cvj<3Aqp=#ROENnOtA?1w;FEmSoISm~{uf+@CJ%qwTk6QXu-vAQ zT+G}LyG^vc6_l)jB6uXH@G!UiVaNm&W%U%l)Hr`um3X1_PGR|1QLgqFwR_Rb>!EOw z=~VT!$2P;GUDohXDaqpi-NEyIolkh5K*>`1TgUVbkF|_b@@R$9HaVO9)R(vUX)Nt4 zGJge;vqM(Qn1h`KW(P$#kY3WM-#MB@1eEr4mvSAUL^_48I5gkJ)S6a}?`hs{a2zT~ z<^7OmnfN*AK-e?C$^7q{+BjrCD73kbjcjCMrH38!-Btp@9(~qvoKMETyEJcolmRu}&e7H$w z`g<`b_QLoF&gPv&R0gR9r)iirPY%MY{@qZ<7>Sl(x_k{cc{Yy19cLw*fataeUW%#s zy+JM=4sr#zPefehyO_|)Pel4>-$kv)LxG5-<4zPt*B7F*anFaGI!R?=iX`6jS^KA! zQi=ZC>!k?I@$LSSr%bdT8b423&M>7|RbQo%X-4QS(&vAmx@a!rnlTq2tr{!7{Uk(L z)$i4JO!)b)uV+ZgECersHL$rU{9Twnv3!{tV7 zw&BkW3#}kiGknO2HXdffm*zE22DXIA zck4hE6JKcb8PVj<%@E0`(4oV<-)1`4k5%SO&-vN? zXZgA@2eN1z=MKwAPy6FA*VT&lzoK**<`hvjINFhFT8| z!cm$CMtileTj=QV6;vuv;KF$VO@i_HQw_k2)F zHev~QjjSfsAca=LoI)d5xHpO;nHb{NV6zPvqm_*=vo2Ix$FgBw&gRoSQxb{l zfP@mFi;ovO!(k$SwyV)#vT$0>Y+{wC_6~ix9dRbIJX4B!&Z4cxvc7Y;O=dry<0ckM z>X>DUZaP};-4!Tx{aUAV1QmiBkiVd3CmfPe)(F7281cz+$RTQfixj#OL4H93Gmvh! z`7124OGEZyNs^a7qMFsm<6=eTqKrrehd9b#5&VRO;@S(99W2ca)djG`uYvBl8;-=Asz dj~y-{>55-F@dvcNfbUYTDa)(Fi)4-8|1YybW9t9_ literal 0 HcmV?d00001 diff --git a/docs/zh/12-taos-sql/13-tmq.md b/docs/zh/12-taos-sql/13-tmq.md index 571300ad8c..61135a3422 100644 --- a/docs/zh/12-taos-sql/13-tmq.md +++ b/docs/zh/12-taos-sql/13-tmq.md @@ -6,32 +6,68 @@ description: TDengine 消息队列提供的数据订阅功能 TDengine 3.0.0.0 开始对消息队列做了大幅的优化和增强以简化用户的解决方案。 -## 创建订阅主题 +## 创建 topic + +TDengine 创建 topic 的个数上限通过参数 tmqMaxTopicNum 控制，默认 20 个。 + +TDengine 使用 SQL 创建一个 topic，共有三种类型的 topic： + +### 查询 topic + +语法： ```sql -CREATE TOPIC [IF NOT EXISTS] topic_name AS subquery; +CREATE TOPIC [IF NOT EXISTS] topic_name as subquery ``` +通过 `SELECT` 语句订阅（包括 `SELECT *`，或 `SELECT ts, c1` 等指定查询订阅，可以带条件过滤、标量函数计算，但不支持聚合函数、不支持时间窗口聚合）。需要注意的是： -TOPIC 支持过滤和标量函数和 UDF 标量函数，不支持 JOIN、GROUP BY、窗口切分子句、聚合函数和 UDF 聚合函数。列订阅规则如下： +- 该类型 TOPIC 一旦创建则订阅数据的结构确定。 +- 被订阅或用于计算的列或标签不可被删除（`ALTER table DROP`）、修改（`ALTER table MODIFY`）。 +- 若发生表结构变更，新增的列不出现在结果中。 +- 对于 select \*，则订阅展开为创建时所有的列（子表、普通表为数据列，超级表为数据列加标签列） +### 超级表 topic -1. TOPIC 一旦创建则返回结果的字段确定 -2. 被订阅或用于计算的列不可被删除、修改 -3. 列可以新增，但新增的列不出现在订阅结果字段中 -4. 对于 select \*，则订阅展开为创建时所有的列（子表、普通表为数据列，超级表为数据列加标签列） - - -## 删除订阅主题 +语法： ```sql +CREATE TOPIC [IF NOT EXISTS] topic_name [with meta] AS STABLE stb_name [where_condition] +``` + +与 `SELECT * from stbName` 订阅的区别是： + +- 不会限制用户的表结构变更。 +- 返回的是非结构化的数据：返回数据的结构会随之超级表的表结构变化而变化。 +- with meta 参数可选，选择时将返回创建超级表，子表等语句，主要用于taosx做超级表迁移 +- where_condition 参数可选，选择时将用来过滤符合条件的子表，订阅这些子表。where 条件里不能有普通列，只能是tag或tbname，where条件里可以用函数，用来过滤tag，但是不能是聚合函数，因为子表tag值无法做聚合。也可以是常量表达式，比如 2 > 1（订阅全部子表），或者 false（订阅0个子表） +- 返回数据不包含标签。 + +### 数据库 topic + +语法： + +```sql +CREATE TOPIC [IF NOT EXISTS] topic_name [with meta] AS DATABASE db_name; +``` + +通过该语句可创建一个包含数据库所有表数据的订阅 + +- with meta 参数可选，选择时将返回创建数据库里所有超级表，子表的语句，主要用于taosx做数据库迁移 + +说明： 超级表订阅和库订阅属于高级订阅模式，容易出错，如确实要使用，请咨询专业人员。 + +## 删除 topic + +如果不再需要订阅数据，可以删除 topic，需要注意：只有当前未在订阅中的 TOPIC 才能被删除。 + +```sql +/* 删除 topic */ DROP TOPIC [IF EXISTS] topic_name; ``` 此时如果该订阅主题上存在 consumer，则此 consumer 会收到一个错误。 -## 查看订阅主题 - -## SHOW TOPICS +## 查看 topic ```sql SHOW TOPICS; @@ -58,3 +94,11 @@ SHOW CONSUMERS; ``` 显示当前数据库下所有活跃的消费者的信息。 + +## 查看订阅信息 + +```sql +SHOW SUBSCRIPTIONS; +``` + +显示 consumer 与 vgroup 之间的分配关系和消费信息 \ No newline at end of file