diff --git a/docs-cn/03-get-started/03-get-started.md b/docs-cn/03-get-started/03-get-started.md index c2193940d690ddf3654f3b9e8dc56176154f690e..11ed177bd0089ea3b5a959de9ad2293be8a11c1a 100644 --- a/docs-cn/03-get-started/03-get-started.md +++ b/docs-cn/03-get-started/03-get-started.md @@ -36,7 +36,7 @@ docker exec -it bash 然后就可以执行相关的 Linux 命令操作和访问 TDengine -详细操作方法请参照 [通过 Docker 快速体验 TDengine](/train-fqa/docker)。 +详细操作方法请参照 [通过 Docker 快速体验 TDengine](/train-faq/docker)。 :::info 从 2.4.0.10 开始，除 taosd 以外，Docker 镜像还包含：taos、taosAdapter、taosdump、taosBenchmark、TDinsight 安装脚本和示例代码。启动 Docker 容器时，将同时启动 taosAdapter 和 taosd，实现对 RESTful 的支持。 @@ -104,7 +104,7 @@ which systemctl taos ``` -如果连接服务成功，将会打印出欢迎消息和版本信息。如果失败，则会打印错误消息出来（请参考 [FAQ](/train-fqa/faq) 来解决终端连接服务端失败的问题）。 TDengine CLI 的提示符号如下： +如果连接服务成功，将会打印出欢迎消息和版本信息。如果失败，则会打印错误消息出来（请参考 [FAQ](/train-faq/faq) 来解决终端连接服务端失败的问题）。 TDengine CLI 的提示符号如下： ```cmd taos> diff --git a/docs-cn/04-develop/01-connect/index.md b/docs-cn/04-develop/01-connect/index.md index 5da3838e3ef715287acd692d434ad4d489b58699..5c62f69a52674dcfac2511b94a83dd3ed9106a2b 100644 --- a/docs-cn/04-develop/01-connect/index.md +++ b/docs-cn/04-develop/01-connect/index.md @@ -234,6 +234,6 @@ install.packages("RJDBC") :::tip -如果建立连接失败，大部分情况下是 FQDN 或防火墙的配置不正确，详细的排查方法请看[《常见问题及反馈》](https://docs.taosdata.com/train-fqa/faq)中的“遇到错误 Unable to establish connection, 我怎么办？” +如果建立连接失败，大部分情况下是 FQDN 或防火墙的配置不正确，详细的排查方法请看[《常见问题及反馈》](https://docs.taosdata.com/train-faq/faq)中的“遇到错误 Unable to establish connection, 我怎么办？” ::: diff --git a/docs-cn/12-taos-sql/02-database.md b/docs-cn/12-taos-sql/02-database.md index 764b0ad12204c8abc4a78e0d0ced3e47fe806af4..5240efa26fc98aaa0ffe83abbb3e44a23dbf338c 100644 --- a/docs-cn/12-taos-sql/02-database.md +++ b/docs-cn/12-taos-sql/02-database.md @@ -15,7 +15,7 @@ CREATE DATABASE [IF NOT EXISTS] db_name [KEEP keep] [DAYS days] [UPDATE 1]; 1. UPDATE 设为 0 时，表示不允许更新数据，后发送的相同时间戳的数据会被直接丢弃； 2. UPDATE 设为 1 时，表示更新全部列数据，即如果更新一个数据行，其中某些列没有提供取值，那么这些列会被设为 NULL； 3. UPDATE 设为 2 时，表示支持更新部分列数据，即如果更新一个数据行，其中某些列没有提供取值，那么这些列会保持原有数据行中的对应值； - 4. 更多关于 UPDATE 参数的用法，请参考[FAQ](/train-fqa/faq)。 + 4. 更多关于 UPDATE 参数的用法，请参考[FAQ](/train-faq/faq)。 3. 数据库名最大长度为 33； 4. 一条 SQL 语句的最大长度为 65480 个字符； 5. 数据库还有更多与数据库相关的配置参数，如 cache, blocks, days, keep, minRows, maxRows, wal, fsync, update, cacheLast, replica, quorum, maxVgroupsPerDb, ctime, comp, prec, 具体细节请参见 [配置参数](/reference/config/) 章节。 diff --git a/docs-cn/13-operation/11-optimize.md b/docs-cn/13-operation/11-optimize.md index 348a97912a096dd1864b6d2b9d2c6bd39c2dc203..57411dbbb0705ae4c9c4568bb09909918bcee6a3 100644 --- a/docs-cn/13-operation/11-optimize.md +++ b/docs-cn/13-operation/11-optimize.md @@ -2,7 +2,7 @@ title: 性能优化 --- -因数据行 [update](/train-fqa/faq/#update)、表删除、数据过期等原因，TDengine 的磁盘存储文件有可能出现数据碎片，影响查询操作的性能表现。从 2.1.3.0 版本开始，新增 SQL 指令 COMPACT 来启动碎片重整过程： +因数据行 [update](/train-faq/faq/#update)、表删除、数据过期等原因，TDengine 的磁盘存储文件有可能出现数据碎片，影响查询操作的性能表现。从 2.1.3.0 版本开始，新增 SQL 指令 COMPACT 来启动碎片重整过程： ```sql COMPACT VNODES IN (vg_id1, vg_id2, ...) diff --git a/docs-cn/14-reference/03-connector/java.mdx b/docs-cn/14-reference/03-connector/java.mdx index 12f9355f8bc45020452389891dded117fd176b66..6f33af949cc60a72b6aba0e28cb91bfa526f709a 100644 --- a/docs-cn/14-reference/03-connector/java.mdx +++ b/docs-cn/14-reference/03-connector/java.mdx @@ -9,9 +9,9 @@ import Preparition from "./_preparition.mdx" ## 总体介绍 -`taos-jdbcdriver` 是 TDengine 的官方 Java 语言连接器。Java 语言开发人员可以通过它开发存取 TDengine 数据库的应用软件。`taos-jdbcdriver` 实现了 JDBC driver 标准的接口。支持通过客户端驱动程序（taosc）原生连接 TDengine 服务端，支持数据写入、查询、订阅、schemaless 接口和参数绑定接口等功能。 +`taos-jdbcdriver` 是 TDengine 的官方 Java 语言连接器。Java 开发人员可以通过它开发存取 TDengine 数据库的应用软件。`taos-jdbcdriver` 实现了 JDBC driver 标准的接口。支持通过客户端驱动程序（taosc）原生连接 TDengine 集群，支持数据写入、查询、订阅、schemaless 接口和参数绑定接口等功能。 -`taos-jdbcdriver`（2.0.18 及更高版本）也支持使用 REST 连接 TDengine 数据库。REST 连接实现的功能集合和原生连接有少量不同。 +`taos-jdbcdriver`（2.0.18 及更高版本）也支持使用 REST 连接 TDengine 集群。REST 连接实现的功能集合和原生连接有少量不同。 ![tdengine-connector](/img/tdengine-jdbc-connector.png) @@ -32,6 +32,7 @@ TDengine 的 JDBC 驱动实现尽可能与关系型数据库驱动保持一致 ## 支持的平台 请参考[支持的平台列表](/reference/connector#支持的平台) + **注意**： - 与原生连接方式不同，RESTful 接口是无状态的。在使用 JDBC-RESTful 时，需要在 SQL 中指定表、超级表的数据库名称。例如： @@ -849,10 +850,6 @@ Query OK, 1 row(s) in set (0.000141s) | 2.0.37 | 增加对 json tag 支持 | | 2.0.38 | 增加对 RESTful 中批量拉取功能 | -## API 参考 - -[taos-jdbcdriver doc](https://docs.taosdata.com/api/taos-jdbcdriver) - ## 常见问题 - 使用 Statement 的 addBatch 和 executeBatch 来执行“批量写入/更行”，为什么没有带来性能上的提升？ @@ -866,4 +863,9 @@ Query OK, 1 row(s) in set (0.000141s) **原因**：目前 TDengine 只支持 64 位 JDK。 **解决方法**：重新安装 64 位 JDK。 -- 其它问题请参考 [Issues](https://github.com/taosdata/TDengine/issues) +- 其它问题请参考 [FAQ](/train-faq/faq) + +## API 参考 + +[taos-jdbcdriver doc](https://docs.taosdata.com/api/taos-jdbcdriver) + diff --git a/docs-cn/14-reference/08-taos-shell.md b/docs-cn/14-reference/08-taos-shell.md index a95fdc1b63f2fd53bd98b030e3054c0169e039b5..c9167fcf2643954981925fb5ef67a60cbad97a6d 100644 --- a/docs-cn/14-reference/08-taos-shell.md +++ b/docs-cn/14-reference/08-taos-shell.md @@ -17,7 +17,7 @@ TDengine 命令行程序（以下简称 TDengine CLI）是用户操作 TDengine ```bash taos ``` -如果连接服务成功，将会打印出欢迎消息和版本信息。如果失败，则会打印错误消息出来（请参考 [FAQ](/train-fqa/faq) 来解决终端连接服务端失败的问题）。TDengine CLI 的提示符号如下： +如果连接服务成功，将会打印出欢迎消息和版本信息。如果失败，则会打印错误消息出来（请参考 [FAQ](/train-faq/faq) 来解决终端连接服务端失败的问题）。TDengine CLI 的提示符号如下： ```cmd taos> diff --git a/docs-cn/21-tdinternal/01-arch.md b/docs-cn/21-tdinternal/01-arch.md index 2a4661e89b698be305aee1cbb8acf46f8d85f4d6..84f6d239dd9fb347a4850966d391cb0b629a7944 100644 --- a/docs-cn/21-tdinternal/01-arch.md +++ b/docs-cn/21-tdinternal/01-arch.md @@ -41,7 +41,7 @@ TDengine 分布式架构的逻辑结构图如下： - 集群数据节点对外提供 RESTful 服务占用一个 TCP 端口，是 serverPort+11。 - 集群内数据节点与 Arbitrator 节点之间通讯占用一个 TCP 端口，是 serverPort+12。 -因此一个数据节点总的端口范围为 serverPort 到 serverPort+12，总共 13 个 TCP/UDP 端口。使用时，需要确保防火墙将这些端口打开。每个数据节点可以配置不同的 serverPort。详细的端口情况请参见 [TDengine 2.0 端口说明](/train-fqa/faq#port) +因此一个数据节点总的端口范围为 serverPort 到 serverPort+12，总共 13 个 TCP/UDP 端口。使用时，需要确保防火墙将这些端口打开。每个数据节点可以配置不同的 serverPort。详细的端口情况请参见 [TDengine 2.0 端口说明](/train-faq/faq#port) **集群对外连接：**TDengine 集群可以容纳单个、多个甚至几千个数据节点。应用只需要向集群中任何一个数据节点发起连接即可，连接需要提供的网络参数是一数据节点的 End Point（FQDN 加配置的端口号）。通过命令行 CLI 启动应用 taos 时，可以通过选项-h 来指定数据节点的 FQDN，-P 来指定其配置的端口号，如果端口不配置，将采用 TDengine 的系统配置参数 serverPort。 diff --git a/docs-cn/27-train-fqa/01-faq.md b/docs-cn/27-train-faq/01-faq.md similarity index 100% rename from docs-cn/27-train-fqa/01-faq.md rename to docs-cn/27-train-faq/01-faq.md diff --git a/docs-cn/27-train-fqa/02-video.mdx b/docs-cn/27-train-faq/02-video.mdx similarity index 100% rename from docs-cn/27-train-fqa/02-video.mdx rename to docs-cn/27-train-faq/02-video.mdx diff --git a/docs-cn/27-train-fqa/03-docker.md b/docs-cn/27-train-faq/03-docker.md similarity index 99% rename from docs-cn/27-train-fqa/03-docker.md rename to docs-cn/27-train-faq/03-docker.md index 4b8dee8c816be773d2b0634bd700eb0dcbf1221d..a86b72a39e94c4db7d3b229fba2260df36ef2a88 100644 --- a/docs-cn/27-train-fqa/03-docker.md +++ b/docs-cn/27-train-faq/03-docker.md @@ -26,7 +26,7 @@ $ docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp tdengine/tdeng 526aa188da767ae94b244226a2b2eec2b5f17dd8eff592893d9ec0cd0f3a1ccd ``` -这条命令，启动一个运行了 TDengine server 的 docker 容器，并且将容器的 6030 到 6049 端口映射到宿主机的 6030 到 6049 端口上。如果宿主机已经运行了 TDengine server 并占用了相同端口，需要映射容器的端口到不同的未使用端口段。（详情参见 [TDengine 2.0 端口说明](/train-fqa/faq#port）。为了支持 TDengine 客户端操作 TDengine server 服务， TCP 和 UDP 端口都需要打开。 +这条命令，启动一个运行了 TDengine server 的 docker 容器，并且将容器的 6030 到 6049 端口映射到宿主机的 6030 到 6049 端口上。如果宿主机已经运行了 TDengine server 并占用了相同端口，需要映射容器的端口到不同的未使用端口段。（详情参见 [TDengine 2.0 端口说明](/train-faq/faq#port）。为了支持 TDengine 客户端操作 TDengine server 服务， TCP 和 UDP 端口都需要打开。 - **docker run**：通过 Docker 运行一个容器 - **-d**：让容器在后台运行 diff --git a/docs-cn/27-train-fqa/_category_.yml b/docs-cn/27-train-faq/_category_.yml similarity index 100% rename from docs-cn/27-train-fqa/_category_.yml rename to docs-cn/27-train-faq/_category_.yml