From de4a50a360350f7fcb1a1e260caa7a70ee1b3744 Mon Sep 17 00:00:00 2001 From: Yu Chen <74105241+yu285@users.noreply.github.com> Date: Mon, 16 Dec 2024 17:21:53 +0800 Subject: [PATCH 1/3] docs/Update 01-faq.md --- docs/zh/27-train-faq/01-faq.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/zh/27-train-faq/01-faq.md b/docs/zh/27-train-faq/01-faq.md index f608002809..8b4cabf520 100644 --- a/docs/zh/27-train-faq/01-faq.md +++ b/docs/zh/27-train-faq/01-faq.md @@ -276,9 +276,13 @@ TDinsight插件中展示的数据是通过taosKeeper和taosAdapter服务收集 ### 30 为什么开源版 TDengine 的主进程会建立一个与公网的连接？ 这个连接只会上报不涉及任何用户数据的最基本信息，用于官方了解产品在世界范围内的分布情况，进而优化产品，提升用户体验，具体采集项目为：集群名、操作系统版本、cpu信息等。 + 该特性为可选配置项，在开源版中默认开启，具体参数为 telemetryReporting , 在官方文档中有做说明，链接如下：[参数简介](https://docs.taosdata.com/reference/components/taosd/#%E7%9B%91%E6%8E%A7%E7%9B%B8%E5%85%B3) + 您可以随时关闭该参数，只需要在taos.cfg 中修改telemetryReporting为 0，然后重启数据库服务即可。 + 代码位于:[点击此处](https://github.com/taosdata/TDengine/blob/62e609c558deb764a37d1a01ba84bc35115a85a4/source/dnode/mnode/impl/src/mndTelem.c) + 此外，对于安全性要求极高的企业版 TDengine Enterprise 来说，此参数不会工作。 ### 31 第一次连接集群时遇到“Sync leader is unreachable”怎么办？ From 57e9223816d4f5f01d9ab18910dec19ca8da0a33 Mon Sep 17 00:00:00 2001 From: sheyanjie-qq <249478495@qq.com> Date: Mon, 16 Dec 2024 20:26:21 +0800 Subject: [PATCH 2/3] improve doc format --- docs/en/14-reference/05-connector/35-node.md | 94 +++++++++---------- docs/en/14-reference/05-connector/50-odbc.md | 2 +- docs/zh/14-reference/05-connector/35-node.mdx | 4 +- docs/zh/14-reference/05-connector/50-odbc.mdx | 3 +- 4 files changed, 52 insertions(+), 51 deletions(-) diff --git a/docs/en/14-reference/05-connector/35-node.md b/docs/en/14-reference/05-connector/35-node.md index 82202b7d4e..19dae0357f 100644 --- a/docs/en/14-reference/05-connector/35-node.md +++ b/docs/en/14-reference/05-connector/35-node.md @@ -14,19 +14,19 @@ The source code for the Node.js connector is hosted on [GitHub](https://github.c ## Node.js Version Compatibility -- Supports Node.js 14 and above. +Supports Node.js 14 and above. ## Supported Platforms -- Support all platforms that can run Node.js. +Support all platforms that can run Node.js. ## Version History -| Node.js Connector Version | Major Changes | TDengine Version | -| ------------------ | ---------------------- | ----------------| -| 3.1.2 | Optimized data protocol and parsing, significantly improved performance.| - | -| 3.1.1 | Optimized data transmission performance. | 3.3.2.0 and higher versions | -| 3.1.0 | New release, supports WebSocket connection. | 3.2.0.0 and higher versions | +| Node.js Connector Version | Major Changes | TDengine Version | +| ------------------------- | ------------------------------------------------------------------------ | --------------------------- | +| 3.1.2 | Optimized data protocol and parsing, significantly improved performance. | - | +| 3.1.1 | Optimized data transmission performance. | 3.3.2.0 and higher versions | +| 3.1.0 | New release, supports WebSocket connection. | 3.2.0.0 and higher versions | ## Exception Handling @@ -36,19 +36,19 @@ Error description: Node.js connector error codes range from 100 to 110, errors o For specific connector error codes, please refer to: -| Error Code | Description | Suggested Actions | -| ---------- | -------------------------------------------------------------| ----------------------------------------------------------------------------------------- | -| 100 | invalid variables | The parameters are illegal, please check the corresponding interface specifications and adjust the parameter types and sizes. | -| 101 | invalid url | URL error, please check if the URL is correctly filled. | -| 102 | received server data but did not find a callback for processing | Received server data but no upper layer callback was found | -| 103 | invalid message type | Received message type unrecognized, please check if the server is normal. | -| 104 | connection creation failed | Connection creation failed, please check if the network is normal. | -| 105 | websocket request timeout | Request timed out | -| 106 | authentication fail | Authentication failed, please check if the username and password are correct. | -| 107 | unknown sql type in tdengine | Please check the Data Type types supported by TDengine. | -| 108 | connection has been closed | The connection has been closed, please check if the Connection is used again after closing, or if the connection is normal. | -| 109 | fetch block data parse fail | Failed to parse the fetched query data | -| 110 | websocket connection has reached its maximum limit | WebSocket connection has reached its maximum limit | +| Error Code | Description | Suggested Actions | +| ---------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | +| 100 | invalid variables | The parameters are illegal, please check the corresponding interface specifications and adjust the parameter types and sizes. | +| 101 | invalid url | URL error, please check if the URL is correctly filled. | +| 102 | received server data but did not find a callback for processing | Received server data but no upper layer callback was found | +| 103 | invalid message type | Received message type unrecognized, please check if the server is normal. | +| 104 | connection creation failed | Connection creation failed, please check if the network is normal. | +| 105 | websocket request timeout | Request timed out | +| 106 | authentication fail | Authentication failed, please check if the username and password are correct. | +| 107 | unknown sql type in tdengine | Please check the Data Type types supported by TDengine. | +| 108 | connection has been closed | The connection has been closed, please check if the Connection is used again after closing, or if the connection is normal. | +| 109 | fetch block data parse fail | Failed to parse the fetched query data | +| 110 | websocket connection has reached its maximum limit | WebSocket connection has reached its maximum limit | - [TDengine Node.js Connector Error Code](https://github.com/taosdata/taos-connector-node/blob/main/nodejs/src/common/wsError.ts) - For errors from other TDengine modules, please refer to [Error Codes](../../error-codes/) @@ -57,38 +57,38 @@ For specific connector error codes, please refer to: The table below shows the mapping between TDengine DataType and Node.js DataType -| TDengine DataType | Node.js DataType| -|-------------------|-------------| -| TIMESTAMP | bigint | -| TINYINT | number | -| SMALLINT | number | -| INT | number | -| BIGINT | bigint | -| TINYINT UNSIGNED | number | -| SMALLINT UNSIGNED | number | -| INT UNSIGNED | number | -| BIGINT UNSIGNED | bigint | -| FLOAT | number | -| DOUBLE | number | -| BOOL | boolean | -| BINARY | string | -| NCHAR | string | -| JSON | string | -| VARBINARY | ArrayBuffer | -| GEOMETRY | ArrayBuffer | +| TDengine DataType | Node.js DataType | +| ----------------- | ---------------- | +| TIMESTAMP | bigint | +| TINYINT | number | +| SMALLINT | number | +| INT | number | +| BIGINT | bigint | +| TINYINT UNSIGNED | number | +| SMALLINT UNSIGNED | number | +| INT UNSIGNED | number | +| BIGINT UNSIGNED | bigint | +| FLOAT | number | +| DOUBLE | number | +| BOOL | boolean | +| BINARY | string | +| NCHAR | string | +| JSON | string | +| VARBINARY | ArrayBuffer | +| GEOMETRY | ArrayBuffer | **Note**: JSON type is only supported in tags. ## More Example Programs -| Example Program | Description of Example Program | -| ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- | -| [sql_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/sql_example.js) | Basic usage such as establishing connections, executing SQL, etc. | -| [stmt_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/stmt_example.js) | Example of binding parameters for insertion. | -| [line_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/line_example.js) | Line protocol writing example. | -| [tmq_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/tmq_example.js) | Example of using subscriptions. | -| [all_type_query](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/all_type_query.js) | Example supporting all types. | -| [all_type_stmt](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/all_type_stmt.js) | Example of parameter binding supporting all types. | +| Example Program | Description of Example Program | +| ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | +| [sql_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/sql_example.js) | Basic usage such as establishing connections, executing SQL, etc. | +| [stmt_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/stmt_example.js) | Example of binding parameters for insertion. | +| [line_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/line_example.js) | Line protocol writing example. | +| [tmq_example](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/tmq_example.js) | Example of using subscriptions. | +| [all_type_query](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/all_type_query.js) | Example supporting all types. | +| [all_type_stmt](https://github.com/taosdata/TDengine/tree/main/docs/examples/node/websocketexample/all_type_stmt.js) | Example of parameter binding supporting all types. | ## Usage Restrictions diff --git a/docs/en/14-reference/05-connector/50-odbc.md b/docs/en/14-reference/05-connector/50-odbc.md index aa015b7ba7..6e5c801018 100644 --- a/docs/en/14-reference/05-connector/50-odbc.md +++ b/docs/en/14-reference/05-connector/50-odbc.md @@ -20,7 +20,7 @@ TDengine ODBC provides both 64-bit and 32-bit drivers. However, the 32-bit versi ## ODBC Version Compatibility -- Supports all ODBC versions. +Supports all ODBC versions. ## Installation diff --git a/docs/zh/14-reference/05-connector/35-node.mdx b/docs/zh/14-reference/05-connector/35-node.mdx index d188da9e4b..cb5d69d137 100644 --- a/docs/zh/14-reference/05-connector/35-node.mdx +++ b/docs/zh/14-reference/05-connector/35-node.mdx @@ -13,11 +13,11 @@ Node.js 连接器源码托管在 [GitHub](https://github.com/taosdata/taos-conne ## Node.js 版本兼容性 -- 支持 Node.js 14 及以上版本。 +支持 Node.js 14 及以上版本。 ## 支持的平台 -- 支持所有能运行 Node.js 的平台。 +支持所有能运行 Node.js 的平台。 ## 版本历史 diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index 322e90e138..7cb89d936d 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -15,7 +15,8 @@ TDengine ODBC 提供 64 位 和 32 位 两种驱动程序。但 32 位仅企业 想更多了解 TDengine 时序时序数据库的使用，可访问 [TDengine官方文档](https://docs.taosdata.com/intro/)。 ## ODBC 版本兼容性 -- 支持 ODBC 所有版本 + +支持 ODBC 所有版本 ## 安装 From 911da6efda6cfba84f9e4a0746cbb3115924ca33 Mon Sep 17 00:00:00 2001 From: danielclow <106956386+danielclow@users.noreply.github.com> Date: Mon, 16 Dec 2024 20:40:59 +0800 Subject: [PATCH 3/3] docs: adjust rust external image width --- docs/zh/14-reference/05-connector/26-rust.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/zh/14-reference/05-connector/26-rust.mdx b/docs/zh/14-reference/05-connector/26-rust.mdx index cfabed4c61..338df40e75 100644 --- a/docs/zh/14-reference/05-connector/26-rust.mdx +++ b/docs/zh/14-reference/05-connector/26-rust.mdx @@ -10,7 +10,9 @@ import TabItem from '@theme/TabItem'; import Preparation from "./_preparation.mdx" import RequestId from "./_request_id.mdx"; +
[![Crates.io](https://img.shields.io/crates/v/taos)](https://crates.io/crates/taos) ![Crates.io](https://img.shields.io/crates/d/taos) [![docs.rs](https://img.shields.io/docsrs/taos)](https://docs.rs/taos) +
`taos` 是 TDengine 的官方 Rust 语言连接器。Rust 开发人员可以通过它开发存取 TDengine 数据库的应用软件。