diff --git a/docs/en/08-client-libraries/03-cpp.mdx b/docs/en/08-client-libraries/03-cpp.mdx
index 39f9688d86..e343f59400 100644
--- a/docs/en/08-client-libraries/03-cpp.mdx
+++ b/docs/en/08-client-libraries/03-cpp.mdx
@@ -623,7 +623,7 @@ In addition to writing data using the SQL method or the parameter binding API, w
- `const char *tmq_get_topic_name(TAOS_RES *res)`
- `const char *tmq_get_db_name(TAOS_RES *res)`
- tmq_res_t 表示消费到的数据类型，定义如下：
+ tmq_res_t the type of consumed result, defined as follows:
```
typedef enum tmq_res_t {
TMQ_RES_INVALID = -1, // invalid
diff --git a/docs/zh/08-connector/10-cpp.mdx b/docs/zh/08-connector/10-cpp.mdx
index 16e6fc892f..567f45aa60 100644
--- a/docs/zh/08-connector/10-cpp.mdx
+++ b/docs/zh/08-connector/10-cpp.mdx
@@ -1,5 +1,5 @@
---
-sidebar_label: C/C++
+idebar_label: C/C++
title: C/C++ Connector
---
@@ -68,143 +68,143 @@ TDengine 客户端驱动的安装请参考 [安装指南](../#安装步骤)
### 同步查询示例
- 同步查询
+同步查询
- ```c
- {{#include examples/c/demo.c}}
- ```
- 格式化输出不同类型字段函数 taos_print_row
- ```c
- int taos_print_row(char *str, TAOS_ROW row, TAOS_FIELD *fields, int num_fields) {
- int32_t len = 0;
- for (int i = 0; i < num_fields; ++i) {
+```c
+{{#include examples/c/demo.c}}
+```
+格式化输出不同类型字段函数 taos_print_row
+```c
+int taos_print_row(char *str, TAOS_ROW row, TAOS_FIELD *fields, int num_fields) {
+ int32_t len = 0;
+ for (int i = 0; i < num_fields; ++i) {
if (i > 0) {
- str[len++] = ' ';
-}
+ str[len++] = ' ';
+ }
if (row[i] == NULL) {
- len += sprintf(str + len, "%s", TSDB_DATA_NULL_STR);
- continue;
-}
+ len += sprintf(str + len, "%s", TSDB_DATA_NULL_STR);
+ continue;
+ }
switch (fields[i].type) {
- case TSDB_DATA_TYPE_TINYINT:
- len += sprintf(str + len, "%d", *((int8_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_TINYINT:
+ len += sprintf(str + len, "%d", *((int8_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_UTINYINT:
- len += sprintf(str + len, "%u", *((uint8_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_UTINYINT:
+ len += sprintf(str + len, "%u", *((uint8_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_SMALLINT:
- len += sprintf(str + len, "%d", *((int16_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_SMALLINT:
+ len += sprintf(str + len, "%d", *((int16_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_USMALLINT:
- len += sprintf(str + len, "%u", *((uint16_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_USMALLINT:
+ len += sprintf(str + len, "%u", *((uint16_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_INT:
- len += sprintf(str + len, "%d", *((int32_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_INT:
+ len += sprintf(str + len, "%d", *((int32_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_UINT:
- len += sprintf(str + len, "%u", *((uint32_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_UINT:
+ len += sprintf(str + len, "%u", *((uint32_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_BIGINT:
- len += sprintf(str + len, "%" PRId64, *((int64_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_BIGINT:
+ len += sprintf(str + len, "%" PRId64, *((int64_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_UBIGINT:
- len += sprintf(str + len, "%" PRIu64, *((uint64_t *)row[i]));
- break;
+ case TSDB_DATA_TYPE_UBIGINT:
+ len += sprintf(str + len, "%" PRIu64, *((uint64_t *)row[i]));
+ break;
- case TSDB_DATA_TYPE_FLOAT: {
- float fv = 0;
- fv = GET_FLOAT_VAL(row[i]);
- len += sprintf(str + len, "%f", fv);
-} break;
+ case TSDB_DATA_TYPE_FLOAT: {
+ float fv = 0;
+ fv = GET_FLOAT_VAL(row[i]);
+ len += sprintf(str + len, "%f", fv);
+ } break;
- case TSDB_DATA_TYPE_DOUBLE: {
- double dv = 0;
- dv = GET_DOUBLE_VAL(row[i]);
- len += sprintf(str + len, "%lf", dv);
-} break;
+ case TSDB_DATA_TYPE_DOUBLE: {
+ double dv = 0;
+ dv = GET_DOUBLE_VAL(row[i]);
+ len += sprintf(str + len, "%lf", dv);
+ } break;
- case TSDB_DATA_TYPE_BINARY:
- case TSDB_DATA_TYPE_NCHAR: {
- int32_t charLen = varDataLen((char *)row[i] - VARSTR_HEADER_SIZE);
- if (fields[i].type == TSDB_DATA_TYPE_BINARY) {
- assert(charLen <= fields[i].bytes && charLen >= 0);
-} else {
- assert(charLen <= fields[i].bytes * TSDB_NCHAR_SIZE && charLen >= 0);
+ case TSDB_DATA_TYPE_BINARY:
+ case TSDB_DATA_TYPE_NCHAR: {
+ int32_t charLen = varDataLen((char *)row[i] - VARSTR_HEADER_SIZE);
+ if (fields[i].type == TSDB_DATA_TYPE_BINARY) {
+ assert(charLen <= fields[i].bytes && charLen >= 0);
+ } else {
+ assert(charLen <= fields[i].bytes * TSDB_NCHAR_SIZE && charLen >= 0);
+ }
+
+ memcpy(str + len, row[i], charLen);
+ len += charLen;
+ } break;
+
+ case TSDB_DATA_TYPE_TIMESTAMP:
+ len += sprintf(str + len, "%" PRId64, *((int64_t *)row[i]));
+ break;
+
+ case TSDB_DATA_TYPE_BOOL:
+ len += sprintf(str + len, "%d", *((int8_t *)row[i]));
+ default:
+ break;
+ }
+ }
+ str[len] = 0;
+
+ return len;
}
-
- memcpy(str + len, row[i], charLen);
- len += charLen;
-} break;
-
- case TSDB_DATA_TYPE_TIMESTAMP:
- len += sprintf(str + len, "%" PRId64, *((int64_t *)row[i]));
- break;
-
- case TSDB_DATA_TYPE_BOOL:
- len += sprintf(str + len, "%d", *((int8_t *)row[i]));
- default:
- break;
-}
-}
- str[len] = 0;
-
- return len;
-}
-
- ```
-
+
+```
+
### 异步查询示例
- 异步查询
+异步查询
- ```c
- {{#include examples/c/asyncdemo.c}}
- ```
+```c
+{{#include examples/c/asyncdemo.c}}
+```
### 参数绑定示例
- 参数绑定
+参数绑定
- ```c
- {{#include examples/c/prepare.c}}
- ```
+```c
+{{#include examples/c/prepare.c}}
+```
### 无模式写入示例
- 无模式写入
+无模式写入
- ```c
- {{#include examples/c/schemaless.c}}
- ```
+```c
+{{#include examples/c/schemaless.c}}
+```
### 订阅和消费示例
- 订阅和消费
+订阅和消费
- ```c
- {{#include examples/c/tmq.c}}
- ```
+```c
+ {{#include examples/c/tmq.c}}
+```
@@ -225,70 +225,70 @@ TDengine 客户端驱动的安装请参考 [安装指南](../#安装步骤)
- `int taos_init()`
-初始化运行环境。如果没有主动调用该 API，那么调用 `taos_connect()` 时驱动将自动调用该 API，故程序一般无需手动调用。
+ 初始化运行环境。如果没有主动调用该 API，那么调用 `taos_connect()` 时驱动将自动调用该 API，故程序一般无需手动调用。
- `void taos_cleanup()`
-清理运行环境，应用退出前应调用。
+ 清理运行环境，应用退出前应调用。
- `int taos_options(TSDB_OPTION option, const void * arg, ...)`
-设置客户端选项，目前支持区域设置（`TSDB_OPTION_LOCALE`）、字符集设置（`TSDB_OPTION_CHARSET`）、时区设置（`TSDB_OPTION_TIMEZONE`）、配置文件路径设置（`TSDB_OPTION_CONFIGDIR`）。区域设置、字符集、时区默认为操作系统当前设置。
+ 设置客户端选项，目前支持区域设置（`TSDB_OPTION_LOCALE`）、字符集设置（`TSDB_OPTION_CHARSET`）、时区设置（`TSDB_OPTION_TIMEZONE`）、配置文件路径设置（`TSDB_OPTION_CONFIGDIR`）。区域设置、字符集、时区默认为操作系统当前设置。
- `char *taos_get_client_info()`
-获取客户端版本信息。
+ 获取客户端版本信息。
- `TAOS *taos_connect(const char *host, const char *user, const char *pass, const char *db, int port)`
-创建数据库连接，初始化连接上下文。其中需要用户提供的参数包含：
+ 创建数据库连接，初始化连接上下文。其中需要用户提供的参数包含：
-- host：TDengine 集群中任一节点的 FQDN
-- user：用户名
-- pass：密码
-- db： 数据库名字，如果用户没有提供，也可以正常连接，用户可以通过该连接创建新的数据库，如果用户提供了数据库名字，则说明该数据库用户已经创建好，缺省使用该数据库
-- port：taosd 程序监听的端口
+ - host：TDengine 集群中任一节点的 FQDN
+ - user：用户名
+ - pass：密码
+ - db： 数据库名字，如果用户没有提供，也可以正常连接，用户可以通过该连接创建新的数据库，如果用户提供了数据库名字，则说明该数据库用户已经创建好，缺省使用该数据库
+ - port：taosd 程序监听的端口
-返回值为空表示失败。应用程序需要保存返回的参数，以便后续使用。
+ 返回值为空表示失败。应用程序需要保存返回的参数，以便后续使用。
-:::info
-同一进程可以根据不同的 host/port 连接多个 TDengine 集群
+ :::info
+ 同一进程可以根据不同的 host/port 连接多个 TDengine 集群
-:::
+ :::
-- `TAOS *taos_connect_auth(const char *host, const char *user, const char *auth, const char *db, uint16_t port)`
+- `TAOS *taos_connect_auth(const char *host, const char *user, const char *auth, const char *db, uint16_t port)`
-功能同 taos_connect。除 pass 参数替换为 auth 外，其他参数同 taos_connect。
-
-- auth: 原始密码取 32 位小写 md5
+ 功能同 taos_connect。除 pass 参数替换为 auth 外，其他参数同 taos_connect。
+
+ - auth: 原始密码取 32 位小写 md5
- `char *taos_get_server_info(TAOS *taos)`
-获取服务端版本信息。
+ 获取服务端版本信息。
- `int taos_select_db(TAOS *taos, const char *db)`
-将当前的缺省数据库设置为 `db`。
-
+ 将当前的缺省数据库设置为 `db`。
+
- `int taos_get_current_db(TAOS *taos, char *database, int len, int *required)`
-
-- database，len为用户在外面申请的空间，内部会把当前db赋值到database里。
-- 只要是没有正常把db名赋值到database中（包括截断），返回错误，返回值为-1，然后用户可以通过 taos_errstr(NULL) 来获取错误提示。
-- 如果，database == NULL 或者 len<=0 返回错误，required里保存存储db需要的空间（包含最后的'\0'）
-- 如果，len 小于 存储db需要的空间（包含最后的'\0'），返回错误，database里赋值截断的数据，以'\0'结尾。
-- 如果，len 大于等于 存储db需要的空间（包含最后的'\0'），返回正常0，database里赋值以'\0‘结尾的db名。
+
+ - database，len为用户在外面申请的空间，内部会把当前db赋值到database里。
+ - 只要是没有正常把db名赋值到database中（包括截断），返回错误，返回值为-1，然后用户可以通过 taos_errstr(NULL) 来获取错误提示。
+ - 如果，database == NULL 或者 len<=0 返回错误，required里保存存储db需要的空间（包含最后的'\0'）
+ - 如果，len 小于 存储db需要的空间（包含最后的'\0'），返回错误，database里赋值截断的数据，以'\0'结尾。
+ - 如果，len 大于等于 存储db需要的空间（包含最后的'\0'），返回正常0，database里赋值以'\0‘结尾的db名。
- `int taos_set_notify_cb(TAOS *taos, __taos_notify_fn_t fp, void *param, int type)`
-设置事件回调函数。
+ 设置事件回调函数。
-- fp 事件回调函数指针。函数声明：typedef void (*__taos_notify_fn_t)(void *param, void *ext, int type)；其中， param 为用户自定义参数，ext 为扩展参数(依赖事件类型，针对 TAOS_NOTIFY_PASSVER 返回用户密码版本)，type 为事件类型
-- param 用户自定义参数
-- type 事件类型。取值范围：1）TAOS_NOTIFY_PASSVER： 用户密码改变
+ - fp 事件回调函数指针。函数声明：typedef void (*__taos_notify_fn_t)(void *param, void *ext, int type)；其中， param 为用户自定义参数，ext 为扩展参数(依赖事件类型，针对 TAOS_NOTIFY_PASSVER 返回用户密码版本)，type 为事件类型
+ - param 用户自定义参数
+ - type 事件类型。取值范围：1）TAOS_NOTIFY_PASSVER： 用户密码改变
- `void taos_close(TAOS *taos)`
-关闭连接，其中`taos`是 `taos_connect()` 返回的句柄。
+ 关闭连接，其中`taos`是 `taos_connect()` 返回的句柄。
### 同步查询 API
@@ -296,35 +296,35 @@ TDengine 客户端驱动的安装请参考 [安装指南](../#安装步骤)
- `TAOS_RES* taos_query(TAOS *taos, const char *sql)`
-执行 SQL 语句，可以是 DQL、DML 或 DDL 语句。 其中的 `taos` 参数是通过 `taos_connect()` 获得的句柄。不能通过返回值是否是 `NULL` 来判断执行结果是否失败，而是需要用 `taos_errno()` 函数解析结果集中的错误代码来进行判断。
+ 执行 SQL 语句，可以是 DQL、DML 或 DDL 语句。 其中的 `taos` 参数是通过 `taos_connect()` 获得的句柄。不能通过返回值是否是 `NULL` 来判断执行结果是否失败，而是需要用 `taos_errno()` 函数解析结果集中的错误代码来进行判断。
- `int taos_result_precision(TAOS_RES *res)`
-返回结果集时间戳字段的精度，`0` 代表毫秒，`1` 代表微秒，`2` 代表纳秒。
+ 返回结果集时间戳字段的精度，`0` 代表毫秒，`1` 代表微秒，`2` 代表纳秒。
- `TAOS_ROW taos_fetch_row(TAOS_RES *res)`
-按行获取查询结果集中的数据。
+ 按行获取查询结果集中的数据。
- `int taos_fetch_block(TAOS_RES *res, TAOS_ROW *rows)`
-批量获取查询结果集中的数据，返回值为获取到的数据的行数。
+ 批量获取查询结果集中的数据，返回值为获取到的数据的行数。
- `int taos_num_fields(TAOS_RES *res)` 和 `int taos_field_count(TAOS_RES *res)`
-这两个 API 等价，用于获取查询结果集中的列数。
+ 这两个 API 等价，用于获取查询结果集中的列数。
- `int* taos_fetch_lengths(TAOS_RES *res)`
-获取结果集中每个字段的长度。返回值是一个数组，其长度为结果集的列数。
+ 获取结果集中每个字段的长度。返回值是一个数组，其长度为结果集的列数。
- `int taos_affected_rows(TAOS_RES *res)`
-获取被所执行的 SQL 语句影响的行数。
+ 获取被所执行的 SQL 语句影响的行数。
- `TAOS_FIELD *taos_fetch_fields(TAOS_RES *res)`
-获取查询结果集每列数据的属性（列的名称、列的数据类型、列的长度），与 `taos_num_fields()` 配合使用，可用来解析 `taos_fetch_row()` 返回的一个元组(一行)的数据。 `TAOS_FIELD` 的结构如下：
+ 获取查询结果集每列数据的属性（列的名称、列的数据类型、列的长度），与 `taos_num_fields()` 配合使用，可用来解析 `taos_fetch_row()` 返回的一个元组(一行)的数据。 `TAOS_FIELD` 的结构如下：
```c
typedef struct taosField {
@@ -336,19 +336,19 @@ typedef struct taosField {
- `void taos_stop_query(TAOS_RES *res)`
-停止当前查询的执行。
+ 停止当前查询的执行。
- `void taos_free_result(TAOS_RES *res)`
-释放查询结果集以及相关的资源。查询完成后，务必调用该 API 释放资源，否则可能导致应用内存泄露。但也需注意，释放资源后，如果再调用 `taos_consume()` 等获取查询结果的函数，将导致应用崩溃。
+ 释放查询结果集以及相关的资源。查询完成后，务必调用该 API 释放资源，否则可能导致应用内存泄露。但也需注意，释放资源后，如果再调用 `taos_consume()` 等获取查询结果的函数，将导致应用崩溃。
- `char *taos_errstr(TAOS_RES *res)`
-获取最近一次 API 调用失败的原因,返回值为字符串标识的错误提示信息。
+ 获取最近一次 API 调用失败的原因,返回值为字符串标识的错误提示信息。
- `int taos_errno(TAOS_RES *res)`
-获取最近一次 API 调用失败的原因，返回值为错误代码。
+ 获取最近一次 API 调用失败的原因，返回值为错误代码。
:::note
2.0 及以上版本 TDengine 推荐数据库应用的每个线程都建立一个独立的连接，或基于线程建立连接池。而不推荐在应用中将该连接 (TAOS\*) 结构体传递到不同的线程共享使用。基于 TAOS 结构体发出的查询、写入等操作具有多线程安全性，但 “USE statement” 等状态量有可能在线程之间相互干扰。此外，C 语言的连接器可以按照需求动态建立面向数据库的新连接（该过程对用户不可见），同时建议只有在程序最后退出的时候才调用 `taos_close()` 关闭连接。
@@ -366,19 +366,19 @@ TDengine 还提供性能更高的异步 API 处理数据插入、查询操作。
- `void taos_query_a(TAOS *taos, const char *sql, void (*fp)(void *param, TAOS_RES *, int code), void *param);`
-异步执行 SQL 语句。
+ 异步执行 SQL 语句。
-- taos：调用 `taos_connect()` 返回的数据库连接
-- sql：需要执行的 SQL 语句
-- fp：用户定义的回调函数，其第三个参数 `code` 用于指示操作是否成功，`0` 表示成功，负数表示失败（调用 `taos_errstr()` 可获取失败原因）。应用在定义回调函数的时候，主要处理第二个参数 `TAOS_RES *`，该参数是查询返回的结果集
-- param：应用提供一个用于回调的参数
+ - taos：调用 `taos_connect()` 返回的数据库连接
+ - sql：需要执行的 SQL 语句
+ - fp：用户定义的回调函数，其第三个参数 `code` 用于指示操作是否成功，`0` 表示成功，负数表示失败（调用 `taos_errstr()` 可获取失败原因）。应用在定义回调函数的时候，主要处理第二个参数 `TAOS_RES *`，该参数是查询返回的结果集
+ - param：应用提供一个用于回调的参数
- `void taos_fetch_rows_a(TAOS_RES *res, void (*fp)(void *param, TAOS_RES *, int numOfRows), void *param);`
-批量获取异步查询的结果集，只能与 `taos_query_a()` 配合使用。其中：
+ 批量获取异步查询的结果集，只能与 `taos_query_a()` 配合使用。其中：
-- res：`taos_query_a()` 回调时返回的结果集
-- fp：回调函数。其参数 `param` 是用户可定义的传递给回调函数的参数结构体；`numOfRows` 是获取到的数据的行数（不是整个查询结果集的函数）。 在回调函数中，应用可以通过调用 `taos_fetch_row()` 前向迭代获取批量记录中每一行记录。读完一块内的所有记录后，应用需要在回调函数中继续调用 `taos_fetch_rows_a()` 获取下一批记录进行处理，直到返回的记录数 `numOfRows` 为零（结果返回完成）或记录数为负值（查询出错）。
+ - res：`taos_query_a()` 回调时返回的结果集
+ - fp：回调函数。其参数 `param` 是用户可定义的传递给回调函数的参数结构体；`numOfRows` 是获取到的数据的行数（不是整个查询结果集的函数）。 在回调函数中，应用可以通过调用 `taos_fetch_row()` 前向迭代获取批量记录中每一行记录。读完一块内的所有记录后，应用需要在回调函数中继续调用 `taos_fetch_rows_a()` 获取下一批记录进行处理，直到返回的记录数 `numOfRows` 为零（结果返回完成）或记录数为负值（查询出错）。
TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多线程同时打开多张表，并可以同时对每张打开的表进行查询或者插入操作。需要指出的是，**客户端应用必须确保对同一张表的操作完全串行化**，即对同一个表的插入或查询操作未完成时（未返回时），不能够执行第二个插入或查询操作。
@@ -404,71 +404,71 @@ TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多
- `TAOS_STMT* taos_stmt_init(TAOS *taos)`
-创建一个 TAOS_STMT 对象用于后续调用。
+ 创建一个 TAOS_STMT 对象用于后续调用。
- `int taos_stmt_prepare(TAOS_STMT *stmt, const char *sql, unsigned long length)`
-解析一条 SQL 语句，将解析结果和参数信息绑定到 stmt 上，如果参数 length 大于 0，将使用此参数作为 SQL 语句的长度，如等于 0，将自动判断 SQL 语句的长度。
+ 解析一条 SQL 语句，将解析结果和参数信息绑定到 stmt 上，如果参数 length 大于 0，将使用此参数作为 SQL 语句的长度，如等于 0，将自动判断 SQL 语句的长度。
- `int taos_stmt_bind_param(TAOS_STMT *stmt, TAOS_MULTI_BIND *bind)`
-不如 `taos_stmt_bind_param_batch()` 效率高，但可以支持非 INSERT 类型的 SQL 语句。
-进行参数绑定，bind 指向一个数组（代表所要绑定的一行数据），需保证此数组中的元素数量和顺序与 SQL 语句中的参数完全一致。TAOS_MULTI_BIND 的使用方法与 MySQL 中的 MYSQL_BIND 类似，具体定义如下：
+ 不如 `taos_stmt_bind_param_batch()` 效率高，但可以支持非 INSERT 类型的 SQL 语句。
+ 进行参数绑定，bind 指向一个数组（代表所要绑定的一行数据），需保证此数组中的元素数量和顺序与 SQL 语句中的参数完全一致。TAOS_MULTI_BIND 的使用方法与 MySQL 中的 MYSQL_BIND 类似，具体定义如下：
-```c
-typedef struct TAOS_MULTI_BIND {
- int buffer_type;
- void *buffer;
- uintptr_t buffer_length;
- uint32_t *length;
- char *is_null;
- int num; // the number of columns
-} TAOS_MULTI_BIND;
+ ```c
+ typedef struct TAOS_MULTI_BIND {
+ int buffer_type;
+ void *buffer;
+ uintptr_t buffer_length;
+ uint32_t *length;
+ char *is_null;
+ int num; // the number of columns
+ } TAOS_MULTI_BIND;
```
- `int taos_stmt_set_tbname(TAOS_STMT* stmt, const char* name)`
-（2.1.1.0 版本新增，仅支持用于替换 INSERT 语句中的参数值）
-当 SQL 语句中的表名使用了 `?` 占位时，可以使用此函数绑定一个具体的表名。
+ （2.1.1.0 版本新增，仅支持用于替换 INSERT 语句中的参数值）
+ 当 SQL 语句中的表名使用了 `?` 占位时，可以使用此函数绑定一个具体的表名。
- `int taos_stmt_set_tbname_tags(TAOS_STMT* stmt, const char* name, TAOS_MULTI_BIND* tags)`
-（2.1.2.0 版本新增，仅支持用于替换 INSERT 语句中的参数值）
-当 SQL 语句中的表名和 TAGS 都使用了 `?` 占位时，可以使用此函数绑定具体的表名和具体的 TAGS 取值。最典型的使用场景是使用了自动建表功能的 INSERT 语句（目前版本不支持指定具体的 TAGS 列）。TAGS 参数中的列数量需要与 SQL 语句中要求的 TAGS 数量完全一致。
+ （2.1.2.0 版本新增，仅支持用于替换 INSERT 语句中的参数值）
+ 当 SQL 语句中的表名和 TAGS 都使用了 `?` 占位时，可以使用此函数绑定具体的表名和具体的 TAGS 取值。最典型的使用场景是使用了自动建表功能的 INSERT 语句（目前版本不支持指定具体的 TAGS 列）。TAGS 参数中的列数量需要与 SQL 语句中要求的 TAGS 数量完全一致。
- `int taos_stmt_bind_param_batch(TAOS_STMT* stmt, TAOS_MULTI_BIND* bind)`
-（2.1.1.0 版本新增，仅支持用于替换 INSERT 语句中的参数值）
-以多列的方式传递待绑定的数据，需要保证这里传递的数据列的顺序、列的数量与 SQL 语句中的 VALUES 参数完全一致。TAOS_MULTI_BIND 的具体定义如下：
+ （2.1.1.0 版本新增，仅支持用于替换 INSERT 语句中的参数值）
+ 以多列的方式传递待绑定的数据，需要保证这里传递的数据列的顺序、列的数量与 SQL 语句中的 VALUES 参数完全一致。TAOS_MULTI_BIND 的具体定义如下：
- `int taos_stmt_add_batch(TAOS_STMT *stmt)`
-将当前绑定的参数加入批处理中，调用此函数后，可以再次调用 `taos_stmt_bind_param()` 或 `taos_stmt_bind_param_batch()` 绑定新的参数。需要注意，此函数仅支持 INSERT/IMPORT 语句，如果是 SELECT 等其他 SQL 语句，将返回错误。
+ 将当前绑定的参数加入批处理中，调用此函数后，可以再次调用 `taos_stmt_bind_param()` 或 `taos_stmt_bind_param_batch()` 绑定新的参数。需要注意，此函数仅支持 INSERT/IMPORT 语句，如果是 SELECT 等其他 SQL 语句，将返回错误。
- `int taos_stmt_execute(TAOS_STMT *stmt)`
-执行准备好的语句。目前，一条语句只能执行一次。
+ 执行准备好的语句。目前，一条语句只能执行一次。
- `int taos_stmt_affected_rows(TAOS_STMT *stmt)`
-
-获取执行多次绑定语句影响的行数。
+
+ 获取执行多次绑定语句影响的行数。
- `int taos_stmt_affected_rows_once(TAOS_STMT *stmt)`
-获取执行一次绑定语句影响的行数。
+ 获取执行一次绑定语句影响的行数。
- `TAOS_RES* taos_stmt_use_result(TAOS_STMT *stmt)`
-获取语句的结果集。结果集的使用方式与非参数化调用时一致，使用完成后，应对此结果集调用 `taos_free_result()` 以释放资源。
+ 获取语句的结果集。结果集的使用方式与非参数化调用时一致，使用完成后，应对此结果集调用 `taos_free_result()` 以释放资源。
- `int taos_stmt_close(TAOS_STMT *stmt)`
-执行完毕，释放所有资源。
+ 执行完毕，释放所有资源。
- `char * taos_stmt_errstr(TAOS_STMT *stmt)`
-（2.1.3.0 版本新增）
-用于在其他 STMT API 返回错误（返回错误码或空指针）时获取错误信息。
+ （2.1.3.0 版本新增）
+ 用于在其他 STMT API 返回错误（返回错误码或空指针）时获取错误信息。
### 无模式（schemaless）写入 API
@@ -476,43 +476,43 @@ typedef struct TAOS_MULTI_BIND {
- `TAOS_RES* taos_schemaless_insert(TAOS* taos, const char* lines[], int numLines, int protocol, int precision)`
-**功能说明**
-- 该接口将行协议的文本数据写入到 TDengine 中。
+ **功能说明**
+ - 该接口将行协议的文本数据写入到 TDengine 中。
-**参数说明**
-- taos: 数据库连接，通过 `taos_connect()` 函数建立的数据库连接。
-- lines：文本数据。满足解析格式要求的无模式文本字符串。
-- numLines:文本数据的行数，不能为 0 。
-- protocol: 行协议类型，用于标识文本数据格式。
-- precision：文本数据中的时间戳精度字符串。
+ **参数说明**
+ - taos: 数据库连接，通过 `taos_connect()` 函数建立的数据库连接。
+ - lines：文本数据。满足解析格式要求的无模式文本字符串。
+ - numLines:文本数据的行数，不能为 0 。
+ - protocol: 行协议类型，用于标识文本数据格式。
+ - precision：文本数据中的时间戳精度字符串。
-**返回值**
-- TAOS_RES 结构体，应用可以通过使用 `taos_errstr()` 获得错误信息，也可以使用 `taos_errno()` 获得错误码。
-在某些情况下，返回的 TAOS_RES 为 `NULL`，此时仍然可以调用 `taos_errno()` 来安全地获得错误码信息。
-返回的 TAOS_RES 需要调用方来负责释放，否则会出现内存泄漏。
+ **返回值**
+ - TAOS_RES 结构体，应用可以通过使用 `taos_errstr()` 获得错误信息，也可以使用 `taos_errno()` 获得错误码。
+ 在某些情况下，返回的 TAOS_RES 为 `NULL`，此时仍然可以调用 `taos_errno()` 来安全地获得错误码信息。
+ 返回的 TAOS_RES 需要调用方来负责释放，否则会出现内存泄漏。
-**说明**
+ **说明**
+
+ 协议类型是枚举类型，包含以下三种格式：
-协议类型是枚举类型，包含以下三种格式：
+ - TSDB_SML_LINE_PROTOCOL：InfluxDB 行协议（Line Protocol)
+ - TSDB_SML_TELNET_PROTOCOL: OpenTSDB Telnet 文本行协议
+ - TSDB_SML_JSON_PROTOCOL: OpenTSDB Json 协议格式
-- TSDB_SML_LINE_PROTOCOL：InfluxDB 行协议（Line Protocol)
-- TSDB_SML_TELNET_PROTOCOL: OpenTSDB Telnet 文本行协议
-- TSDB_SML_JSON_PROTOCOL: OpenTSDB Json 协议格式
+ 时间戳分辨率的定义，定义在 `taos.h` 文件中，具体内容如下：
-时间戳分辨率的定义，定义在 `taos.h` 文件中，具体内容如下：
+ - TSDB_SML_TIMESTAMP_NOT_CONFIGURED = 0,
+ - TSDB_SML_TIMESTAMP_HOURS,
+ - TSDB_SML_TIMESTAMP_MINUTES,
+ - TSDB_SML_TIMESTAMP_SECONDS,
+ - TSDB_SML_TIMESTAMP_MILLI_SECONDS,
+ - TSDB_SML_TIMESTAMP_MICRO_SECONDS,
+ - TSDB_SML_TIMESTAMP_NANO_SECONDS
-- TSDB_SML_TIMESTAMP_NOT_CONFIGURED = 0,
-- TSDB_SML_TIMESTAMP_HOURS,
-- TSDB_SML_TIMESTAMP_MINUTES,
-- TSDB_SML_TIMESTAMP_SECONDS,
-- TSDB_SML_TIMESTAMP_MILLI_SECONDS,
-- TSDB_SML_TIMESTAMP_MICRO_SECONDS,
-- TSDB_SML_TIMESTAMP_NANO_SECONDS
+ 需要注意的是，时间戳分辨率参数只在协议类型为 `SML_LINE_PROTOCOL` 的时候生效。
+ 对于 OpenTSDB 的文本协议，时间戳的解析遵循其官方解析规则 — 按照时间戳包含的字符的数量来确认时间精度。
-需要注意的是，时间戳分辨率参数只在协议类型为 `SML_LINE_PROTOCOL` 的时候生效。
-对于 OpenTSDB 的文本协议，时间戳的解析遵循其官方解析规则 — 按照时间戳包含的字符的数量来确认时间精度。
-
-**schemaless 其他相关的接口**
+ **schemaless 其他相关的接口**
- `TAOS_RES *taos_schemaless_insert_with_reqid(TAOS *taos, char *lines[], int numLines, int protocol, int precision, int64_t reqid)`
- `TAOS_RES *taos_schemaless_insert_raw(TAOS *taos, char *lines, int len, int32_t *totalRows, int protocol, int precision)`
- `TAOS_RES *taos_schemaless_insert_raw_with_reqid(TAOS *taos, char *lines, int len, int32_t *totalRows, int protocol, int precision, int64_t reqid)`
@@ -521,11 +521,11 @@ typedef struct TAOS_MULTI_BIND {
- `TAOS_RES *taos_schemaless_insert_raw_ttl(TAOS *taos, char *lines, int len, int32_t *totalRows, int protocol, int precision, int32_t ttl)`
- `TAOS_RES *taos_schemaless_insert_raw_ttl_with_reqid(TAOS *taos, char *lines, int len, int32_t *totalRows, int protocol, int precision, int32_t ttl, int64_t reqid)`
-**说明**
-- 上面这7个接口是扩展接口，主要用于在schemaless写入时传递ttl、reqid参数，可以根据需要使用。
-- 带_raw的接口通过传递的参数lines指针和长度len来表示数据，为了解决原始接口数据包含'\0'而被截断的问题。totalRows指针返回解析出来的数据行数。
-- 带_ttl的接口可以传递ttl参数来控制建表的ttl到期时间。
-- 带_reqid的接口可以通过传递reqid参数来追踪整个的调用链。
+ **说明**
+ - 上面这7个接口是扩展接口，主要用于在schemaless写入时传递ttl、reqid参数，可以根据需要使用。
+ - 带_raw的接口通过传递的参数lines指针和长度len来表示数据，为了解决原始接口数据包含'\0'而被截断的问题。totalRows指针返回解析出来的数据行数。
+ - 带_ttl的接口可以传递ttl参数来控制建表的ttl到期时间。
+ - 带_reqid的接口可以通过传递reqid参数来追踪整个的调用链。
### 数据订阅 API
- `const char *tmq_err2str(int32_t code)`