Merge branch 'docs/wade-3.0' of github.com:taosdata/TDengine into docs/wade-3.0

2024-08-03 14:49:06 +08:00 · 2024-08-03 14:49:06 +08:00 · 2f475a413c
parent da79d889ee d3018f9e05
commit 2f475a413c
13 changed files with 250 additions and 222 deletions
--- a/docs/examples/c/connect_example.c
+++ b/docs/examples/c/connect_example.c
@ -13,12 +13,18 @@ int main() {
  uint16_t    port = 0;  // 0 means use the default port
  TAOS       *taos = taos_connect(host, user, passwd, db, port);
  if (taos == NULL) {
-    int   errno = taos_errno(NULL);
-    char *msg = taos_errstr(NULL);
+    int errno = taos_errno(NULL);
+    const char *msg = taos_errstr(NULL);
    printf("%d, %s\n", errno, msg);
-  } else {
-    printf("connected\n");
-    taos_close(taos);
+    printf("failed to connect to server %s, errno: %d, msg: %s\n", host, errno, msg);
+    taos_cleanup();
+    return -1;
  }
+  printf("success to connect server %s\n", host);
+  
+  /* put your code here for read and write */
+
+  // close & clean
+  taos_close(taos);
  taos_cleanup();
 }
--- a/docs/examples/c/create_db_demo.c
+++ b/docs/examples/c/create_db_demo.c
@ -14,7 +14,7 @@
 */

 // TAOS standard API example. The same syntax as MySQL, but only a subset
-// to compile: gcc -o CCreateDBDemo CCreateDBDemo.c -ltaos
+// to compile: gcc -o create_db_demo create_db_demo.c -ltaos

 #include <inttypes.h>
 #include <stdio.h>
@ -32,22 +32,23 @@ const char *password  = "taosdata";
 // connect
 TAOS *taos = taos_connect(ip, user, password, NULL, 0);
 if (taos == NULL) {
-  printf("failed to connect to server, reason: %s\n", taos_errstr(NULL));
+  printf("failed to connect to server %s, reason: %s\n", ip, taos_errstr(NULL));
  taos_cleanup();
  return -1;
 }
+printf("success to connect server %s\n", ip);

 // create database
 TAOS_RES *result = taos_query(taos, "CREATE DATABASE IF NOT EXISTS power");
 int code = taos_errno(result);
 if (code != 0) {
-  printf("failed to create database, reason: %s\n", taos_errstr(result));
+  printf("failed to create database power, reason: %s\n", taos_errstr(result));
  taos_close(taos);
  taos_cleanup();
  return -1;
 }
 taos_free_result(result);
-printf("success to create database\n");
+printf("success to create database power\n");

 // use database
 result = taos_query(taos, "USE power");
@ -58,13 +59,13 @@ const char* sql = "CREATE STABLE IF NOT EXISTS meters (ts TIMESTAMP, current FLO
 result = taos_query(taos, sql);
 code = taos_errno(result);
 if (code != 0) {
-  printf("failed to create table, reason: %s\n", taos_errstr(result));
+  printf("failed to create stable meters, reason: %s\n", taos_errstr(result));
  taos_close(taos);
  taos_cleanup();
  return -1;
 }
 taos_free_result(result);
-printf("success to create table\n");
+printf("success to create table meters\n");

 // close & clean
 taos_close(taos);
--- a/docs/examples/c/insert_data_demo.c
+++ b/docs/examples/c/insert_data_demo.c
@ -14,7 +14,7 @@
 */

 // TAOS standard API example. The same syntax as MySQL, but only a subset
-// to compile: gcc -o CInsertDataDemo CInsertDataDemo.c -ltaos
+// to compile: gcc -o insert_data_demo insert_data_demo.c -ltaos

 #include <inttypes.h>
 #include <stdio.h>
@ -31,10 +31,11 @@ const char *password  = "taosdata";
 // connect
 TAOS *taos = taos_connect(ip, user, password, NULL, 0);
 if (taos == NULL) {
-  printf("failed to connect to server, reason: %s\n", taos_errstr(NULL));
+  printf("failed to connect to server %s, reason: %s\n", ip, taos_errstr(NULL));
  taos_cleanup();
  return -1;
 }
+printf("success to connect server %s\n", ip);

 // use database
 TAOS_RES *result = taos_query(taos, "USE power");
@ -53,7 +54,7 @@ const char* sql = "INSERT INTO "
 result = taos_query(taos, sql);
 int code = taos_errno(result);
 if (code != 0) {
-  printf("failed to insert rows, reason: %s\n", taos_errstr(result));
+  printf("failed to insert data to power.meters, ip: %s, reason: %s\n", ip, taos_errstr(result));
  taos_close(taos);
  taos_cleanup();
  return -1;
@ -62,7 +63,7 @@ taos_free_result(result);

 // you can check affectedRows here
 int rows = taos_affected_rows(result);
-printf("success to insert %d rows\n", rows);
+printf("success to insert %d rows data to power.meters\n", rows);

 // close & clean
 taos_close(taos);
--- a/docs/examples/c/query_data_demo.c
+++ b/docs/examples/c/query_data_demo.c
@ -14,7 +14,7 @@
 */

 // TAOS standard API example. The same syntax as MySQL, but only a subset
-// to compile: gcc -o CQueryDataDemo CQueryDataDemo.c -ltaos
+// to compile: gcc -o query_data_demo query_data_demo.c -ltaos

 #include <inttypes.h>
 #include <stdio.h>
@ -32,21 +32,22 @@ const char *password  = "taosdata";
 // connect
 TAOS *taos = taos_connect(ip, user, password, NULL, 0);
 if (taos == NULL) {
-  printf("failed to connect to server, reason: %s\n", taos_errstr(NULL));
+  printf("failed to connect to server %s, reason: %s\n", ip, taos_errstr(NULL));
  taos_cleanup();
  return -1;
 }
+printf("success to connect server %s\n", ip);

 // use database
 TAOS_RES *result = taos_query(taos, "USE power");
 taos_free_result(result);

 // query data, please make sure the database and table are already created
-const char* sql = "SELECT * FROM power.meters";
+const char* sql = "SELECT ts, current, location FROM power.meters limit 100";
 result = taos_query(taos, sql);
 int code = taos_errno(result);
 if (code != 0) {
-  printf("failed to select, reason: %s\n", taos_errstr(result));
+  printf("failed to query data from power.meters, ip: %s, reason: %s\n", ip, taos_errstr(result));
  taos_close(taos);
  taos_cleanup();
  return -1;
@ -69,6 +70,7 @@ while ((row = taos_fetch_row(result))) {
 }
 printf("total rows: %d\n", rows);
 taos_free_result(result);
+printf("success to query data from power.meters\n");

 // close & clean
 taos_close(taos);
--- a/docs/examples/c/sml_insert_demo.c
+++ b/docs/examples/c/sml_insert_demo.c
@ -14,7 +14,7 @@
 */

 // TAOS standard API example. The same syntax as MySQL, but only a subset
-// to compile: gcc -o CSmlInsertDemo CSmlInsertDemo.c -ltaos
+// to compile: gcc -o sml_insert_demo sml_insert_demo.c -ltaos

 #include <stdio.h>
 #include <stdlib.h>
@ -31,22 +31,23 @@ const char *password  = "taosdata";
 // connect
 TAOS *taos = taos_connect(ip, user, password, NULL, 0);
 if (taos == NULL) {
-  printf("failed to connect to server, reason: %s\n", taos_errstr(NULL));
+  printf("failed to connect to server %s, reason: %s\n", ip, taos_errstr(NULL));
  taos_cleanup();
  return -1;
 }
+printf("success to connect server %s\n", ip);

 // create database
 TAOS_RES *result = taos_query(taos, "CREATE DATABASE IF NOT EXISTS power");
 int code = taos_errno(result);
 if (code != 0) {
-  printf("failed to create database, reason: %s\n", taos_errstr(result));
+  printf("failed to create database power, reason: %s\n", taos_errstr(result));
  taos_close(taos);
  taos_cleanup();
  return -1;
 }
 taos_free_result(result);
-printf("success to create database\n");
+printf("success to create database power\n");

 // use database
 result = taos_query(taos, "USE power");
--- a/docs/examples/c/stmt_insert_demo.c
+++ b/docs/examples/c/stmt_insert_demo.c
@ -14,7 +14,7 @@
 */

 // TAOS standard API example. The same syntax as MySQL, but only a subset
-// to compile: gcc -o CStmtInsertDemo CStmtInsertDemo.c -ltaos
+// to compile: gcc -o stmt_insert_demo stmt_insert_demo.c -ltaos

 #include <stdio.h>
 #include <stdlib.h>
--- a/docs/examples/c/with_reqid_demo.c
+++ b/docs/examples/c/with_reqid_demo.c
@ -14,7 +14,7 @@
 */

 // TAOS standard API example. The same syntax as MySQL, but only a subset
-// to compile: gcc -o CWithReqIdDemo CWithReqIdDemo.c -ltaos
+// to compile: gcc -o with_reqid_demo with_reqid_demo.c -ltaos

 #include <inttypes.h>
 #include <stdio.h>
@ -32,23 +32,24 @@ const char *password  = "taosdata";
 // connect
 TAOS *taos = taos_connect(ip, user, password, NULL, 0);
 if (taos == NULL) {
-  printf("failed to connect to server, reason: %s\n", taos_errstr(NULL));
+  printf("failed to connect to server %s, reason: %s\n", ip, taos_errstr(NULL));
  taos_cleanup();
  return -1;
 }
+printf("success to connect server %s\n", ip);

 // create database
 TAOS_RES *result = taos_query_with_reqid(taos, "CREATE DATABASE IF NOT EXISTS power", 1L);
 int code = taos_errno(result);
 if (code != 0) {
-  printf("failed to create database, reason: %s\n", taos_errstr(result));
+  printf("failed to create database power, reason: %s\n", taos_errstr(result));
  taos_free_result(result);
  taos_close(taos);
  taos_cleanup();
  return -1;
 }
 taos_free_result(result);
-printf("success to create database\n");
+printf("success to create database power\n");

 // use database
 result = taos_query_with_reqid(taos, "USE power", 2L);
@ -59,7 +60,7 @@ const char* sql = "SELECT * FROM power.meters";
 result = taos_query_with_reqid(taos, sql, 3L);
 code = taos_errno(result);
 if (code != 0) {
-  printf("failed to select, reason: %s\n", taos_errstr(result));
+  printf("failed to query data from power.meters, ip: %s, reason: %s\n", ip, taos_errstr(result));
  taos_close(taos);
  taos_cleanup();
  return -1;
@ -82,6 +83,7 @@ while ((row = taos_fetch_row(result))) {
 }
 printf("total rows: %d\n", rows);
 taos_free_result(result);
+printf("success to query data from power.meters\n");

 // close & clean
 taos_close(taos);
--- a/docs/zh/08-develop/01-connect/index.md
+++ b/docs/zh/08-develop/01-connect/index.md
@ -322,6 +322,28 @@ Rust 连接器使用 DSN 来创建连接， DSN 描述字符串基本结构如
 DSN 的详细说明和如何使用详见 [连接功能](../../reference/connector/rust/#连接功能)

    </TabItem>
+    <TabItem label="Node.js" value="node">
+    Node.js 连接器使用 DSN 来创建连接， DSN 描述字符串基本结构如下：
+
+    ```text
+    [+<protocol>]://[[<username>:<password>@]<host>:<port>][/<database>][?<p1>=<v1>[&<p2>=<v2>]]
+    |------------|---|-----------|-----------|------|------|------------|-----------------------|
+    |   protocol |   | username  | password  | host | port |  database  |  params               |
+    ```
+
+    - **protocol**: 使用 websocket 协议建立连接。例如`ws://localhost:6041`
+    - **username/password**: 数据库的用户名和密码。
+    - **host/port**: 主机地址和端口号。例如`localhost:6041`
+    - **database**: 数据库名称。
+    - **params**: 其他参数。 例如token。
+
+    - 完整 D 示例：
+
+    ```js
+        ws://root:taosdata@localhost:6041
+    ``` 
+    </TabItem>
+
    <TabItem label="C#" value="csharp">
    ConnectionStringBuilder 使用 key-value 对方式设置连接参数，key 为参数名，value 为参数值，不同参数之间使用分号 `;` 分割。

@ -358,16 +380,7 @@ DSN 的详细说明和如何使用详见 [连接功能](../../reference/connecto
 下面为建立连接的示例代码，其中省略了查询和写入部分，展示了如何建立连接、关闭连接以及清除资源。

 ```c
-  TAOS *taos = taos_connect("localhost:6030", "root", "taosdata", NULL, 0);
-  if (taos == NULL) {
-    printf("failed to connect to server, reason:%s\n", "null taos" /*taos_errstr(taos)*/);
-    exit(1);
-  }
-
-  /* put your code here for read and write */
-
-  taos_close(taos);
-  taos_cleanup();
+{{#include docs/examples/c/connect_example.c}}
 ```

 在上面的示例代码中， `taos_connect()` 建立到客户端程序所在主机的 6030 端口的连接，`taos_close()`关闭当前连接，`taos_cleanup()`清除客户端驱动所申请和使用的资源。
--- a/docs/zh/08-develop/02-sql.md
+++ b/docs/zh/08-develop/02-sql.md
@ -69,7 +69,7 @@ REST API：直接调用 `taosadapter` 提供的 REST API 接口，进行数据
 </TabItem>
 <TabItem label="C" value="c">
 ```c
-{{#include docs/examples/c/CCreateDBDemo.c:create_db_and_table}}
+{{#include docs/examples/c/create_db_demo.c:create_db_and_table}}
 ```
 > **注意**：如果不使用 `USE power` 指定数据库，则后续对表的操作都需要增加数据库名称作为前缀，如 power.meters。
 </TabItem>
@ -146,7 +146,7 @@ NOW 为系统内部函数，默认为客户端所在计算机当前时间。 NOW
 </TabItem>
 <TabItem label="C" value="c">
 ```c
-{{#include docs/examples/c/CInsertDataDemo.c:insert_data}}
+{{#include docs/examples/c/insert_data_demo.c:insert_data}}
 ```

 **Note**
@ -215,7 +215,7 @@ curl --location -uroot:taosdata 'http://127.0.0.1:6041/rest/sql' \
 </TabItem>
 <TabItem label="C" value="c">
 ```c
-{{#include docs/examples/c/CQueryDataDemo.c:query_data}}
+{{#include docs/examples/c/query_data_demo.c:query_data}}
 ```
 </TabItem>
 <TabItem label="REST API" value="rest">
@ -290,7 +290,7 @@ reqId 可用于请求链路追踪，reqId 就像分布式系统中的 traceId
 </TabItem>
 <TabItem label="C" value="c">
 ```c
-{{#include docs/examples/c/CWithReqIdDemo.c:with_reqid}}
+{{#include docs/examples/c/with_reqid_demo.c:with_reqid}}
 ```
 </TabItem>
 <TabItem label="REST API" value="rest">
--- a/docs/zh/08-develop/04-schemaless.md
+++ b/docs/zh/08-develop/04-schemaless.md
@ -246,7 +246,7 @@ writer.write(lineDemo, SchemalessProtocolType.LINE, SchemalessTimestampType.NANO
 </TabItem>
 <TabItem label="C" value="c">
 ```c
-{{#include docs/examples/c/CSmlInsertDemo.c:schemaless}}
+{{#include docs/examples/c/sml_insert_demo.c:schemaless}}
 ```
 </TabItem>

--- a/docs/zh/08-develop/05-stmt.md
+++ b/docs/zh/08-develop/05-stmt.md
@ -99,7 +99,7 @@ import TabItem from "@theme/TabItem";
 </TabItem>
 <TabItem label="C" value="c">
 ```c
-{{#include docs/examples/c/CStmtInsertDemo.c}}
+{{#include docs/examples/c/stmt_insert_demo.c}}
 ```
 </TabItem>

--- a/docs/zh/14-reference/05-connector/10-cpp.mdx
+++ b/docs/zh/14-reference/05-connector/10-cpp.mdx
@ -811,12 +811,12 @@ TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多
 - `TAOS *tmq_get_connect(tmq_t *tmq)`
  - **接口说明**：从 TMQ 消费者对象中获取与 TDengine 数据库的连接句柄。
    - tmq：[入参] 指向一个有效的 tmq_t 结构体指针，该结构体代表一个 TMQ 消费者对象。
-  - **返回值**：非NULL`：成功，返回一个 TAOS * 类型的指针，指向与 TDengine 数据库的连接句柄。`NULL`：失败，非法的输入参数。
+  - **返回值**：非 `NULL`：成功，返回一个 TAOS * 类型的指针，指向与 TDengine 数据库的连接句柄。`NULL`：失败，非法的输入参数。

 - `const char *tmq_get_table_name(TAOS_RES *res)`
  - **接口说明**：从 TMQ 消费者获取的消息结果中获取所属的的表名。
    - res：[入参] 指向一个有效的 TAOS_RES 结构体指针，该结构体包含了从 TMQ 消费者轮询得到的消息。
-  - **返回值**：非NULL`：成功，返回一个 const char * 类型的指针，指向表名字符串。`NULL`：失败，非法的输入参数。
+  - **返回值**：非 `NULL`：成功，返回一个 const char * 类型的指针，指向表名字符串。`NULL`：失败，非法的输入参数。

 - `tmq_res_t tmq_get_res_type(TAOS_RES *res)`
  - **接口说明**：从 TMQ 消费者获取的消息结果中获取消息类型。
@ -835,9 +835,9 @@ TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多
 - `const char *tmq_get_topic_name(TAOS_RES *res)`
  - **接口说明**：从 TMQ 消费者获取的消息结果中获取所属的 topic 名称。
    - res：[入参] 指向一个有效的 TAOS_RES 结构体指针，该结构体包含了从 TMQ 消费者轮询得到的消息。
-  - **返回值**：非NULL`：成功，返回一个 const char * 类型的指针，指向 topic 名称字符串。`NULL`：失败，非法的输入参数。
+  - **返回值**：非 `NULL`：成功，返回一个 const char * 类型的指针，指向 topic 名称字符串。`NULL`：失败，非法的输入参数。

 - `const char *tmq_get_db_name(TAOS_RES *res)`
  - **接口说明**：从 TMQ 消费者获取的消息结果中获取所属的数据库名称。
    - res：[入参] 指向一个有效的 TAOS_RES 结构体指针，该结构体包含了从 TMQ 消费者轮询得到的消息。
-  - **返回值**：非NULL`：成功，返回一个 const char * 类型的指针，指向数据库名称字符串。`NULL`：失败，非法的输入参数。
+  - **返回值**：非 `NULL`：成功，返回一个 const char * 类型的指针，指向数据库名称字符串。`NULL`：失败，非法的输入参数。
--- a/docs/zh/14-reference/05-connector/35-node.mdx
+++ b/docs/zh/14-reference/05-connector/35-node.mdx
@ -49,6 +49,8 @@ Node.js 连接器目前仅支持 Websocket 连接器， 其通过 taosAdapter
 | 108     | connection has been closed                                      | 连接已经关闭，请检查 Connection 是否关闭后再次使用，或是连接是否正常。  |
 | 109     | fetch block data parse fail                                     | 获取到的查询数据，解析失败                    |
 | 110     | websocket connection has reached its maximum limit              | Websocket 连接达到上限                                                   |
+- [TDengine Node.js Connector Error Code](https://github.com/taosdata/taos-connector-node/blob/main/nodejs/src/common/wsError.ts)
+<!-- - [TDengine_ERROR_CODE](../error-code) -->

 ## 数据类型映射