Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
taosdata
TDengine
提交
fa1c21ab
T
TDengine
项目概览
taosdata
/
TDengine
接近 2 年 前同步成功
通知
1191
Star
22018
Fork
4786
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
T
TDengine
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
fa1c21ab
编写于
4月 16, 2022
作者:
W
wade zhang
提交者:
GitHub
4月 16, 2022
浏览文件
操作
浏览文件
下载
差异文件
Merge pull request #11563 from taosdata/docs/TD-14786
docs: correct a lot of bad links and some refining
上级
998f95ce
9a857fd4
变更
36
隐藏空白更改
内联
并排
Showing
36 changed file
with
73 addition
and
74 deletion
+73
-74
docs-cn/03-get-started/03-get-started.md
docs-cn/03-get-started/03-get-started.md
+2
-2
docs-cn/03-get-started/_apt_get_install.mdx
docs-cn/03-get-started/_apt_get_install.mdx
+1
-1
docs-cn/03-get-started/_pkg_install.mdx
docs-cn/03-get-started/_pkg_install.mdx
+4
-2
docs-cn/04-connect/index.mdx
docs-cn/04-connect/index.mdx
+1
-1
docs-cn/05-model/index.mdx
docs-cn/05-model/index.mdx
+4
-4
docs-cn/06-insert-data/_category_.yml
docs-cn/06-insert-data/_category_.yml
+1
-1
docs-cn/07-query-data/index.mdx
docs-cn/07-query-data/index.mdx
+1
-1
docs-cn/08-advance-feature/02-subscribe.mdx
docs-cn/08-advance-feature/02-subscribe.mdx
+2
-2
docs-cn/08-advance-feature/04-udf.md
docs-cn/08-advance-feature/04-udf.md
+1
-1
docs-cn/08-advance-feature/08-advance-feature.md
docs-cn/08-advance-feature/08-advance-feature.md
+2
-2
docs-cn/09-third-party/01-grafana.mdx
docs-cn/09-third-party/01-grafana.mdx
+3
-3
docs-cn/09-third-party/03-telegraf.md
docs-cn/09-third-party/03-telegraf.md
+2
-2
docs-cn/09-third-party/05-collectd.md
docs-cn/09-third-party/05-collectd.md
+1
-1
docs-cn/09-third-party/06-statsd.md
docs-cn/09-third-party/06-statsd.md
+1
-1
docs-cn/09-third-party/07-icinga2.md
docs-cn/09-third-party/07-icinga2.md
+1
-1
docs-cn/09-third-party/08-tcollector.md
docs-cn/09-third-party/08-tcollector.md
+1
-1
docs-cn/10-cluster/01-deploy.md
docs-cn/10-cluster/01-deploy.md
+2
-2
docs-cn/10-cluster/02-cluster-mgmt.md
docs-cn/10-cluster/02-cluster-mgmt.md
+7
-9
docs-cn/11-operation/07-import.md
docs-cn/11-operation/07-import.md
+1
-1
docs-cn/11-operation/08-export.md
docs-cn/11-operation/08-export.md
+2
-3
docs-cn/11-operation/11-optimize.md
docs-cn/11-operation/11-optimize.md
+1
-1
docs-cn/13-tdinternal/01-arch.md
docs-cn/13-tdinternal/01-arch.md
+2
-2
docs-cn/13-tdinternal/02-replica.md
docs-cn/13-tdinternal/02-replica.md
+1
-1
docs-cn/13-tdinternal/03-taosd.md
docs-cn/13-tdinternal/03-taosd.md
+1
-1
docs-cn/14-reference/01-taos-sql/02-database.md
docs-cn/14-reference/01-taos-sql/02-database.md
+2
-2
docs-cn/14-reference/01-taos-sql/04-stable.md
docs-cn/14-reference/01-taos-sql/04-stable.md
+1
-1
docs-cn/14-reference/01-taos-sql/08-interval.md
docs-cn/14-reference/01-taos-sql/08-interval.md
+1
-1
docs-cn/14-reference/03-connector/03-connector.mdx
docs-cn/14-reference/03-connector/03-connector.mdx
+1
-1
docs-cn/14-reference/03-connector/cpp.mdx
docs-cn/14-reference/03-connector/cpp.mdx
+2
-2
docs-cn/14-reference/03-connector/java.mdx
docs-cn/14-reference/03-connector/java.mdx
+4
-4
docs-cn/14-reference/03-connector/python.mdx
docs-cn/14-reference/03-connector/python.mdx
+1
-1
docs-cn/14-reference/08-server-config/08-server-config.md
docs-cn/14-reference/08-server-config/08-server-config.md
+4
-4
docs-cn/14-reference/13-schemaless/13-schemaless.md
docs-cn/14-reference/13-schemaless/13-schemaless.md
+1
-1
docs-cn/15-application/03-immigrate.md
docs-cn/15-application/03-immigrate.md
+7
-7
docs-cn/17-train-fqa/01-faq.md
docs-cn/17-train-fqa/01-faq.md
+1
-1
docs-cn/17-train-fqa/03-docker.md
docs-cn/17-train-fqa/03-docker.md
+3
-3
未找到文件。
docs-cn/03-get-started/03-get-started.md
浏览文件 @
fa1c21ab
...
@@ -44,8 +44,8 @@ import PkgInstall from "./\_pkg_install.mdx";
...
@@ -44,8 +44,8 @@ import PkgInstall from "./\_pkg_install.mdx";
import AptGetInstall from "./
\_
apt_get_install.mdx";
import AptGetInstall from "./
\_
apt_get_install.mdx";
import SrcInstall from "./
\_
src_install.mdx";
import SrcInstall from "./
\_
src_install.mdx";
TDengine 包括服务端、客户端和周边生态工具软件,目前 2.0 版服务端仅在 Linux 系统上安装和运行,后续将支持 Windows、macOS 等系统。客户端可以在 Windows 或 Linux 上安装和运行。在任何操作系统上的应用都可以使用 RESTful 接口连接
服务端程序 taosd,其中 2.4 之后版本默认使用单独运行的独立组件 taosAdapter 提供 http 服务和更多数据写入方式。
taosAdapter 需要手动启动。
TDengine 包括服务端、客户端和周边生态工具软件,目前 2.0 版服务端仅在 Linux 系统上安装和运行,后续将支持 Windows、macOS 等系统。客户端可以在 Windows 或 Linux 上安装和运行。在任何操作系统上的应用都可以使用 RESTful 接口连接
TDengine,其中 2.4 之后版本默认使用单独运行的独立组件 taosAdapter 提供 http 服务和更多数据写入方式,
taosAdapter 需要手动启动。
之前版本 TDengine 服务端,以及所有服务端 lite 版,均使用内置
http 服务。
2.
4 之前的版本中 TDengine 服务端,以及所有服务端 lite 版,均使用由 taosd 内置的
http 服务。
TDengine 支持 X64/ARM64/MIPS64/Alpha64 硬件平台,后续将支持 ARM32、RISC-V 等 CPU 架构。
TDengine 支持 X64/ARM64/MIPS64/Alpha64 硬件平台,后续将支持 ARM32、RISC-V 等 CPU 架构。
...
...
docs-cn/03-get-started/_apt_get_install.mdx
浏览文件 @
fa1c21ab
如果,
可以使用 apt-get 工具从官方仓库安装。
可以使用 apt-get 工具从官方仓库安装。
**安装包仓库**
**安装包仓库**
...
...
docs-cn/03-get-started/_pkg_install.mdx
浏览文件 @
fa1c21ab
import PkgList from "./_pkg_list.mdx";
import PkgList from "./_pkg_list.mdx";
TDengine 的安装
非常简单,从下载到安装成功仅仅只要几秒钟。
使用安装包安装 TDengine
非常简单,从下载到安装成功仅仅只要几秒钟。
为方便使用,从 2.4.0.10 开始,标准的服务端安装包包含了 taos、taosd、taosAdapter、taosdump、taosBenchmark、TDinsight 安装脚本和示例代码;如果您只需要用到服务端程序和客户端连接的 C/C++ 语言支持,也可以仅下载 lite 版本的安装包。
为方便使用,从 2.4.0.10 开始,标准的服务端安装包包含了 taos、taosd、taosAdapter、taosdump、taosBenchmark、TDinsight 安装脚本和示例代码;如果您只需要用到服务端程序和客户端连接的 C/C++ 语言支持,也可以仅下载 lite 版本的安装包。
...
@@ -8,6 +8,8 @@ TDengine 的安装非常简单,从下载到安装成功仅仅只要几秒钟
...
@@ -8,6 +8,8 @@ TDengine 的安装非常简单,从下载到安装成功仅仅只要几秒钟
发布版本包括稳定版和 Beta 版,Beta 版含有更多新功能。正式上线或测试建议安装稳定版。您可以根据需要选择下载:
发布版本包括稳定版和 Beta 版,Beta 版含有更多新功能。正式上线或测试建议安装稳定版。您可以根据需要选择下载:
<PkgList />
**所有下载**
https://www.taosdata.com/all-downloads
具体的安装方法,请参见 [安装包的安装和卸载](/operation/pkg-install) 以及 [视频教程](https://www.taosdata.com/blog/2020/11/11/1941.html)。
具体的安装方法,请参见 [安装包的安装和卸载](/operation/pkg-install) 以及 [视频教程](https://www.taosdata.com/blog/2020/11/11/1941.html)。
docs-cn/04-connect/index.mdx
浏览文件 @
fa1c21ab
...
@@ -21,7 +21,7 @@ TDengine 提高了多种编程语言的连接器方便用户开发应用程序
...
@@ -21,7 +21,7 @@ TDengine 提高了多种编程语言的连接器方便用户开发应用程序
连接器建立连接的方式,从本质上分为三种:
连接器建立连接的方式,从本质上分为三种:
1. 通过 taosAdapter 组件提供的 RESTful API 建立连接。
1. 通过 taosAdapter 组件提供的 RESTful API 建立连接。
2. 通过 taosAdapter 组件提供的 WebSocket API 建立连接(目前只有 Java 连接器支持)。
2. 通过 taosAdapter 组件提供的 WebSocket API 建立连接(目前只有 Java 连接器支持)。
3. 通过客户端驱动程序直接与服务端程序
(taosd)
建立连接,这种连接方式下文中简称“本地连接”。
3. 通过客户端驱动程序直接与服务端程序
taosd
建立连接,这种连接方式下文中简称“本地连接”。
无论使用何种方式建立连接,连接器都提供了相同或相似的 API 操作数据库,都可以执行 SQL 语句,只是初始化连接的方式稍有不同,用户在使用上不会感到太大差别。
无论使用何种方式建立连接,连接器都提供了相同或相似的 API 操作数据库,都可以执行 SQL 语句,只是初始化连接的方式稍有不同,用户在使用上不会感到太大差别。
...
...
docs-cn/05-model/index.mdx
浏览文件 @
fa1c21ab
...
@@ -3,7 +3,7 @@ slug: /model
...
@@ -3,7 +3,7 @@ slug: /model
title: TDengine 数据建模
title: TDengine 数据建模
---
---
TDengine 采用关系型数据模型,需要建库、建表。因此对于一个具体的应用场景,需要考虑库、超级表和普通表的设计。本节不讨论细致的语法规则,只介绍概念。
TDengine 采用
类
关系型数据模型,需要建库、建表。因此对于一个具体的应用场景,需要考虑库、超级表和普通表的设计。本节不讨论细致的语法规则,只介绍概念。
关于数据建模请参考[视频教程](https://www.taosdata.com/blog/2020/11/11/1945.html)。
关于数据建模请参考[视频教程](https://www.taosdata.com/blog/2020/11/11/1945.html)。
...
@@ -49,7 +49,7 @@ CREATE STABLE meters (ts timestamp, current float, voltage int, phase float) TAG
...
@@ -49,7 +49,7 @@ CREATE STABLE meters (ts timestamp, current float, voltage int, phase float) TAG
每一种类型的数据采集点需要建立一个超级表,因此一个物联网系统,往往会有多个超级表。对于电网,我们就需要对智能电表、变压器、母线、开关等都建立一个超级表。在物联网中,一个设备就可能有多个数据采集点(比如一台风力发电的风机,有的采集点采集电流、电压等电参数,有的采集点采集温度、湿度、风向等环境参数),这个时候,对这一类型的设备,需要建立多张超级表。
每一种类型的数据采集点需要建立一个超级表,因此一个物联网系统,往往会有多个超级表。对于电网,我们就需要对智能电表、变压器、母线、开关等都建立一个超级表。在物联网中,一个设备就可能有多个数据采集点(比如一台风力发电的风机,有的采集点采集电流、电压等电参数,有的采集点采集温度、湿度、风向等环境参数),这个时候,对这一类型的设备,需要建立多张超级表。
一张超级表最多容许
1024 列,如果一个采集点采集的物理量个数超过 1024,需要建多张超级表来处理。一个系统可以有多个 DB,一个 DB 里可以有一到多个超级表。(从 2.1.7.0 版本开始,列数限制由 1024 列放宽到了 4096 列。)
一张超级表最多容许
4096 列 (在 2.1.7.0 版本之前,列数限制为 1024 列),如果一个采集点采集的物理量个数超过 4096,需要建多张超级表来处理。一个系统可以有多个 DB,一个 DB 里可以有一到多个超级表。
## 创建表
## 创建表
...
@@ -62,7 +62,7 @@ CREATE TABLE d1001 USING meters TAGS ("Beijing.Chaoyang", 2);
...
@@ -62,7 +62,7 @@ CREATE TABLE d1001 USING meters TAGS ("Beijing.Chaoyang", 2);
其中 d1001 是表名,meters 是超级表的表名,后面紧跟标签 Location 的具体标签值 ”Beijing.Chaoyang",标签 groupId 的具体标签值 2。虽然在创建表时,需要指定标签值,但可以事后修改。详细细则请见 [TAOS SQL 的表管理](/reference/taos-sql/table) 章节。
其中 d1001 是表名,meters 是超级表的表名,后面紧跟标签 Location 的具体标签值 ”Beijing.Chaoyang",标签 groupId 的具体标签值 2。虽然在创建表时,需要指定标签值,但可以事后修改。详细细则请见 [TAOS SQL 的表管理](/reference/taos-sql/table) 章节。
:::warning
:::warning
目前 TDengine 没有从技术层面限制使用一个 database (db
A)的超级表作为模板建立另一个 database (dbB)
的子表,后续会禁止这种用法,不建议使用这种方法建表。
目前 TDengine 没有从技术层面限制使用一个 database (db
1) 的超级表作为模板建立另一个 database (db2)
的子表,后续会禁止这种用法,不建议使用这种方法建表。
:::
:::
...
@@ -70,7 +70,7 @@ TDengine 建议将数据采集点的全局唯一 ID 作为表名(比如设备序
...
@@ -70,7 +70,7 @@ TDengine 建议将数据采集点的全局唯一 ID 作为表名(比如设备序
### 自动建表
### 自动建表
在某些特殊场景中,用户在写数据时并不确定某个数据采集点的表是否存在,此时可在写入数据时使用自动建表语法来创建不存在的表,若该表已存在则不会建立新表。比如:
在某些特殊场景中,用户在写数据时并不确定某个数据采集点的表是否存在,此时可在写入数据时使用自动建表语法来创建不存在的表,若该表已存在则不会建立新表
且后面的 USING 语句被忽略
。比如:
```sql
```sql
INSERT INTO d1001 USING meters TAGS ("Beijng.Chaoyang", 2) VALUES (now, 10.2, 219, 0.32);
INSERT INTO d1001 USING meters TAGS ("Beijng.Chaoyang", 2) VALUES (now, 10.2, 219, 0.32);
...
...
docs-cn/06-insert-data/_category_.yml
浏览文件 @
fa1c21ab
...
@@ -2,4 +2,4 @@ label: 写入数据
...
@@ -2,4 +2,4 @@ label: 写入数据
link
:
link
:
type
:
generated-index
type
:
generated-index
slug
:
/insert-data/
slug
:
/insert-data/
description
:
"
TDengine
支持多种
接口
写入协议,包括
SQL,InfluxDB
Line
协议,
OpentsDB
Telnet
协议,
OpentsDB
JSON
格式协议。数据可以单条插入,也可以批量插入,可以插入一个数据采集点的数据,也可以同时插入多个数据采集点的数据。支持多线程插入,支持时间乱序数据插入,也支持历史数据插入。InfluxDB
Line
协议、
OpentsDB
Telnet
协议和
OpentsDB
JSON
格式协议是
TDengine
支持的三种无模式写入协议。使用无模式方式写入无需提前创建超级表和子表,并且引擎能自适用数据对表结构做调整。"
description
:
"
TDengine
支持多种写入协议,包括
SQL,InfluxDB
Line
协议,
OpentsDB
Telnet
协议,
OpentsDB
JSON
格式协议。数据可以单条插入,也可以批量插入,可以插入一个数据采集点的数据,也可以同时插入多个数据采集点的数据。支持多线程插入,支持时间乱序数据插入,也支持历史数据插入。InfluxDB
Line
协议、
OpentsDB
Telnet
协议和
OpentsDB
JSON
格式协议是
TDengine
支持的三种无模式写入协议。使用无模式方式写入无需提前创建超级表和子表,并且引擎能自适用数据对表结构做调整。"
docs-cn/07-query-data/index.mdx
浏览文件 @
fa1c21ab
...
@@ -71,7 +71,7 @@ taos> SELECT count(*), max(current) FROM meters where groupId = 2 and ts > now -
...
@@ -71,7 +71,7 @@ taos> SELECT count(*), max(current) FROM meters where groupId = 2 and ts > now -
Query OK, 1 row(s) in set (0.002136s)
Query OK, 1 row(s) in set (0.002136s)
```
```
TDengine 仅容许对属于同一个超级表的表之间进行聚合查询,不同超级表之间的聚合查询不支持。在 [TAOS SQL 的数据查询](
https://www.taosdata.com/cn/documentation/taos-sql#
select) 一章,查询类操作都会注明是否支持超级表。
TDengine 仅容许对属于同一个超级表的表之间进行聚合查询,不同超级表之间的聚合查询不支持。在 [TAOS SQL 的数据查询](
/reference/taos-sql/
select) 一章,查询类操作都会注明是否支持超级表。
### 降采样查询、插值
### 降采样查询、插值
...
...
docs-cn/08-advance-feature/02-subscribe.mdx
浏览文件 @
fa1c21ab
...
@@ -18,7 +18,7 @@ import CDemo from "./_sub_c.mdx";
...
@@ -18,7 +18,7 @@ import CDemo from "./_sub_c.mdx";
TDengine 内嵌支持轻量级的消息订阅与推送服务。使用系统提供的 API,用户可使用普通查询语句订阅数据库中的一张或多张表。订阅的逻辑和操作状态的维护均是由客户端完成,客户端定时轮询服务器是否有新的记录到达,有新的记录到达就会将结果反馈到客户。
TDengine 内嵌支持轻量级的消息订阅与推送服务。使用系统提供的 API,用户可使用普通查询语句订阅数据库中的一张或多张表。订阅的逻辑和操作状态的维护均是由客户端完成,客户端定时轮询服务器是否有新的记录到达,有新的记录到达就会将结果反馈到客户。
TDengine 的订阅与推送服务的状态是
客户端维持,TDengine 服务器
并不维持。因此如果应用重启,从哪个时间点开始获取最新数据,由应用决定。
TDengine 的订阅与推送服务的状态是
由客户端维持,TDengine 服务端
并不维持。因此如果应用重启,从哪个时间点开始获取最新数据,由应用决定。
TDengine 的 API 中,与订阅相关的主要有以下三个:
TDengine 的 API 中,与订阅相关的主要有以下三个:
...
@@ -28,7 +28,7 @@ taos_consume
...
@@ -28,7 +28,7 @@ taos_consume
taos_unsubscribe
taos_unsubscribe
```
```
这些 API 的文档请见 [C/C++ Connector](
https://www.taosdata.com/cn/documentation/connector#c-
cpp),下面仍以智能电表场景为例介绍一下它们的具体用法(超级表和子表结构请参考上一节“连续查询”),完整的示例代码可以在 [这里](https://github.com/taosdata/TDengine/blob/master/examples/c/subscribe.c) 找到。
这些 API 的文档请见 [C/C++ Connector](
/reference/connector/
cpp),下面仍以智能电表场景为例介绍一下它们的具体用法(超级表和子表结构请参考上一节“连续查询”),完整的示例代码可以在 [这里](https://github.com/taosdata/TDengine/blob/master/examples/c/subscribe.c) 找到。
如果我们希望当某个电表的电流超过一定限制(比如 10A)后能得到通知并进行一些处理, 有两种方法:一是分别对每张子表进行查询,每次查询后记录最后一条数据的时间戳,后续只查询这个时间戳之后的数据:
如果我们希望当某个电表的电流超过一定限制(比如 10A)后能得到通知并进行一些处理, 有两种方法:一是分别对每张子表进行查询,每次查询后记录最后一条数据的时间戳,后续只查询这个时间戳之后的数据:
...
...
docs-cn/08-advance-feature/04-udf.md
浏览文件 @
fa1c21ab
...
@@ -23,7 +23,7 @@ TDengine 提供 3 个 UDF 的源代码示例,分别为:
...
@@ -23,7 +23,7 @@ TDengine 提供 3 个 UDF 的源代码示例,分别为:
-
udfNormalFunc 中各参数的具体含义是:
-
udfNormalFunc 中各参数的具体含义是:
-
data:输入数据。
-
data:输入数据。
-
itype:输入数据的类型。这里采用的是短整型表示法,与各种数据类型对应的值可以参见
[
column_meta 中的列类型说明
](
https://www.taosdata.com/cn/documentation/connector#column_meta
)
。例如 4 用于表示 INT 型。
-
itype:输入数据的类型。这里采用的是短整型表示法,与各种数据类型对应的值可以参见
[
column_meta 中的列类型说明
](
/reference/restful-api/
)
。例如 4 用于表示 INT 型。
-
iBytes:输入数据中每个值会占用的字节数。
-
iBytes:输入数据中每个值会占用的字节数。
-
numOfRows:输入数据的总行数。
-
numOfRows:输入数据的总行数。
-
ts:主键时间戳在输入中的列数据(只读)。
-
ts:主键时间戳在输入中的列数据(只读)。
...
...
docs-cn/08-advance-feature/08-advance-feature.md
浏览文件 @
fa1c21ab
...
@@ -10,11 +10,11 @@ title: 高级功能
...
@@ -10,11 +10,11 @@ title: 高级功能
## 订阅
## 订阅
轻量级的数据订阅与推送服务。连续写入到
TDengine中时序数据均能够推动
到订阅客户端。
轻量级的数据订阅与推送服务。连续写入到
TDengine 中的时序数据能够被自动推送
到订阅客户端。
## 缓存
## 缓存
提供写驱动的缓存管理机制,将每个表最近
的一条写入记录数据持续保存在缓存中,可以提供给
高性能的最近状态查询。
提供写驱动的缓存管理机制,将每个表最近
写入的一条记录持续保存在缓存中,可以提供
高性能的最近状态查询。
## 用户定义函数
## 用户定义函数
...
...
docs-cn/09-third-party/01-grafana.mdx
浏览文件 @
fa1c21ab
...
@@ -3,7 +3,7 @@ sidebar_label: Grafana
...
@@ -3,7 +3,7 @@ sidebar_label: Grafana
title: Grafana
title: Grafana
---
---
TDengine 能够与开源数据可视化系统 [Grafana](https://www.grafana.com/) 快速集成搭建数据监测报警系统,整个过程无需任何代码开发,TDengine 中数据表
中
内容可以在仪表盘(DashBoard)上进行可视化展现。关于 TDengine 插件的使用您可以在[GitHub](https://github.com/taosdata/grafanaplugin/blob/master/README.md)中了解更多。
TDengine 能够与开源数据可视化系统 [Grafana](https://www.grafana.com/) 快速集成搭建数据监测报警系统,整个过程无需任何代码开发,TDengine 中数据表
的
内容可以在仪表盘(DashBoard)上进行可视化展现。关于 TDengine 插件的使用您可以在[GitHub](https://github.com/taosdata/grafanaplugin/blob/master/README.md)中了解更多。
## 安装 Grafana
## 安装 Grafana
...
@@ -64,7 +64,7 @@ GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=tdengine-datasource
...
@@ -64,7 +64,7 @@ GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=tdengine-datasource


- Host: TDengine 集群
的中任意一台服务器的 IP 地址与 TDengine RESTful 接口的端口号(6041),默认 http://localhost:6041。注意:从 2.4 版本开始 RESTful 服务默认使用独立组件 taosAdapter 提供,请参考相关文档配置部署
。
- Host: TDengine 集群
中提供 RESTful 服务 (在 2.4 之前由 taosd 提供, 从 2.4 开始由 taosAdapter 提供)的组件所在服务器的 IP 地址与 TDengine RESTful 服务的端口号(6041),默认 http://localhost:6041
。
- User:TDengine 用户名。
- User:TDengine 用户名。
- Password:TDengine 用户密码。
- Password:TDengine 用户密码。
...
@@ -92,4 +92,4 @@ GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=tdengine-datasource
...
@@ -92,4 +92,4 @@ GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=tdengine-datasource
### 导入 Dashboard
### 导入 Dashboard
在 2.3.3.0 及以上版本,您可以导入 TDinsight Dashboard (Grafana Dashboard ID: [15167](https://grafana.com/grafana/dashboards/15167)) 作为 TDengine 集群的监控可视化工具。安装和使用说明请见 [TDinsight 用户手册](https://
www.taosdata.com/cn/documentation/tools/insight
)。
在 2.3.3.0 及以上版本,您可以导入 TDinsight Dashboard (Grafana Dashboard ID: [15167](https://grafana.com/grafana/dashboards/15167)) 作为 TDengine 集群的监控可视化工具。安装和使用说明请见 [TDinsight 用户手册](https://
github.com/taosdata/grafanaplugin/blob/master/dashboards/TDinsight-CN.md
)。
docs-cn/09-third-party/03-telegraf.md
浏览文件 @
fa1c21ab
...
@@ -5,9 +5,9 @@ title: Telegraf 写入
...
@@ -5,9 +5,9 @@ title: Telegraf 写入
安装 Telegraf 请参考
[
官方文档
](
https://portal.influxdata.com/downloads/
)
。
安装 Telegraf 请参考
[
官方文档
](
https://portal.influxdata.com/downloads/
)
。
TDengine 新版本(2.
3
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 Telegraf 的多种应用的数据写入。
TDengine 新版本(2.
4
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 Telegraf 的多种应用的数据写入。
配置方法,在 /etc/telegraf/telegraf.conf 增加如下
文字,其中 database name 请填写希望在 TDengine 保存 Telegraf 数据的数据库名,TDengine server/cluster host、username 和 password 填写 TDengine 实际值
:
配置方法,在 /etc/telegraf/telegraf.conf 增加如下
配置,其中 database name 请填写希望在 TDengine 保存 Telegraf 数据的数据库名,TDengine server、cluster host、username 和 password 填写 TDengine 集群中的实际配置
:
```
```
[[outputs.http]]
[[outputs.http]]
...
...
docs-cn/09-third-party/05-collectd.md
浏览文件 @
fa1c21ab
...
@@ -5,7 +5,7 @@ title: collectd 写入
...
@@ -5,7 +5,7 @@ title: collectd 写入
安装 collectd,请参考
[
官方文档
](
https://collectd.org/download.shtml
)
。
安装 collectd,请参考
[
官方文档
](
https://collectd.org/download.shtml
)
。
TDengine 新版本(2.
3
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 collectd 的多种应用的数据写入。
TDengine 新版本(2.
4
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 collectd 的多种应用的数据写入。
在
`/etc/collectd/collectd.conf`
文件中增加如下内容,其中 host 和 port 请填写 TDengine 和 taosAdapter 配置的实际值:
在
`/etc/collectd/collectd.conf`
文件中增加如下内容,其中 host 和 port 请填写 TDengine 和 taosAdapter 配置的实际值:
...
...
docs-cn/09-third-party/06-statsd.md
浏览文件 @
fa1c21ab
...
@@ -6,7 +6,7 @@ title: StatsD 直接写入
...
@@ -6,7 +6,7 @@ title: StatsD 直接写入
安装 StatsD
安装 StatsD
请参考
[
官方文档
](
https://github.com/statsd/statsd
)
。
请参考
[
官方文档
](
https://github.com/statsd/statsd
)
。
TDengine 新版本(2.
3
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 StatsD 的多种应用的数据写入。
TDengine 新版本(2.
4
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 StatsD 的多种应用的数据写入。
在
`config.js`
文件中增加如下内容后启动 StatsD,其中 host 和 port 请填写 TDengine 和 taosAdapter 配置的实际值:
在
`config.js`
文件中增加如下内容后启动 StatsD,其中 host 和 port 请填写 TDengine 和 taosAdapter 配置的实际值:
...
...
docs-cn/09-third-party/07-icinga2.md
浏览文件 @
fa1c21ab
...
@@ -6,7 +6,7 @@ title: icinga2 写入
...
@@ -6,7 +6,7 @@ title: icinga2 写入
安装 icinga2
安装 icinga2
请参考
[
官方文档
](
https://icinga.com/docs/icinga-2/latest/doc/02-installation/
)
请参考
[
官方文档
](
https://icinga.com/docs/icinga-2/latest/doc/02-installation/
)
TDengine 新版本(2.
3
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 icinga2 的多种应用的数据写入。
TDengine 新版本(2.
4
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 icinga2 的多种应用的数据写入。
icinga2 可以收集监控和性能数据并写入 OpenTSDB,taosAdapter 可以支持接收 icinga2 的数据并写入到 TDengine 中。
icinga2 可以收集监控和性能数据并写入 OpenTSDB,taosAdapter 可以支持接收 icinga2 的数据并写入到 TDengine 中。
...
...
docs-cn/09-third-party/08-tcollector.md
浏览文件 @
fa1c21ab
...
@@ -6,7 +6,7 @@ title: TCollector 写入
...
@@ -6,7 +6,7 @@ title: TCollector 写入
安装 TCollector
安装 TCollector
请参考
[
官方文档
](
http://opentsdb.net/docs/build/html/user_guide/utilities/tcollector.html#installation-of-tcollector
)
请参考
[
官方文档
](
http://opentsdb.net/docs/build/html/user_guide/utilities/tcollector.html#installation-of-tcollector
)
TDengine 新版本(2.
3
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 TCollector 的多种应用的数据写入。
TDengine 新版本(2.
4
.0.0+)包含一个 taosAdapter 独立程序,负责接收包括 TCollector 的多种应用的数据写入。
TCollector 是一个在客户侧收集本地收集器并发送数据到 OpenTSDB 的进程,taosAdapter 可以支持接收 TCollector 的数据并写入到 TDengine 中。
TCollector 是一个在客户侧收集本地收集器并发送数据到 OpenTSDB 的进程,taosAdapter 可以支持接收 TCollector 的数据并写入到 TDengine 中。
...
...
docs-cn/10-cluster/01-deploy.md
浏览文件 @
fa1c21ab
...
@@ -6,7 +6,7 @@ title: 集群部署
...
@@ -6,7 +6,7 @@ title: 集群部署
### 第零步
### 第零步
规划集群所有物理节点的 FQDN,将规划好的 FQDN 分别添加到每个物理节点的 /etc/host
name
;修改每个物理节点的 /etc/hosts,将所有集群物理节点的 IP 与 FQDN 的对应添加好。【如部署了 DNS,请联系网络管理员在 DNS 上做好相关配置】
规划集群所有物理节点的 FQDN,将规划好的 FQDN 分别添加到每个物理节点的 /etc/host
s
;修改每个物理节点的 /etc/hosts,将所有集群物理节点的 IP 与 FQDN 的对应添加好。【如部署了 DNS,请联系网络管理员在 DNS 上做好相关配置】
### 第一步
### 第一步
...
@@ -17,7 +17,7 @@ title: 集群部署
...
@@ -17,7 +17,7 @@ title: 集群部署
:::
:::
:::note
:::note
客户端也需要配置,确保它可以正确解析每个节点的 FQDN 配置,不管是通过 DNS 服务,还是修改 hosts 文件。
客户端
所在服务器
也需要配置,确保它可以正确解析每个节点的 FQDN 配置,不管是通过 DNS 服务,还是修改 hosts 文件。
:::
:::
### 第二步
### 第二步
...
...
docs-cn/10-cluster/02-cluster-mgmt.md
浏览文件 @
fa1c21ab
---
---
title
:
集群
管理
title
:
数据节点
管理
---
---
## 数据节点管理
上面已经介绍如何从零开始搭建集群。集群组建完后,还可以随时添加新的数据节点进行扩容,或删除数据节点,并检查集群当前状态。
上面已经介绍如何从零开始搭建集群。集群组建完后,还可以随时添加新的数据节点进行扩容,或删除数据节点,并检查集群当前状态。
:::note
:::note
...
@@ -14,7 +12,7 @@ title: 集群管理
...
@@ -14,7 +12,7 @@ title: 集群管理
## 添加数据节点
## 添加数据节点
执行 CLI 程序 taos,
执行:
启动 CLI 程序 taos,然后
执行:
```
sql
```
sql
CREATE
DNODE
"fqdn:port"
;
CREATE
DNODE
"fqdn:port"
;
...
@@ -24,13 +22,13 @@ CREATE DNODE "fqdn:port";
...
@@ -24,13 +22,13 @@ CREATE DNODE "fqdn:port";
## 删除数据节点
## 删除数据节点
执行 CLI 程序 taos,
执行:
启动 CLI 程序 taos,然后
执行:
```
sql
```
sql
DROP
DNODE
"fqdn:port | dnodeID"
;
DROP
DNODE
"fqdn:port | dnodeID"
;
```
```
通过
“fqdn:port”或“dnodeID”
来指定一个具体的节点都是可以的。其中 fqdn 是被删除的节点的 FQDN,port 是其对外服务器的端口号;dnodeID 可以通过 SHOW DNODES 获得。
通过
“fqdn:port” 或 “dnodeID”
来指定一个具体的节点都是可以的。其中 fqdn 是被删除的节点的 FQDN,port 是其对外服务器的端口号;dnodeID 可以通过 SHOW DNODES 获得。
:::warning
:::warning
...
@@ -45,7 +43,7 @@ dnodeID 是集群自动分配的,不得人工指定。它在生成时是递增
...
@@ -45,7 +43,7 @@ dnodeID 是集群自动分配的,不得人工指定。它在生成时是递增
手动将某个 vnode 迁移到指定的 dnode。
手动将某个 vnode 迁移到指定的 dnode。
执行 CLI 程序 taos,
执行:
启动 CLI 程序 taos,然后
执行:
```
sql
```
sql
ALTER
DNODE
<
source
-
dnodeId
>
BALANCE
"VNODE:<vgId>-DNODE:<dest-dnodeId>"
;
ALTER
DNODE
<
source
-
dnodeId
>
BALANCE
"VNODE:<vgId>-DNODE:<dest-dnodeId>"
;
...
@@ -63,7 +61,7 @@ ALTER DNODE <source-dnodeId> BALANCE "VNODE:<vgId>-DNODE:<dest-dnodeId>";
...
@@ -63,7 +61,7 @@ ALTER DNODE <source-dnodeId> BALANCE "VNODE:<vgId>-DNODE:<dest-dnodeId>";
## 查看数据节点
## 查看数据节点
执行 CLI 程序 taos,
执行:
启动 CLI 程序 taos,然后
执行:
```
sql
```
sql
SHOW
DNODES
;
SHOW
DNODES
;
...
@@ -75,7 +73,7 @@ SHOW DNODES;
...
@@ -75,7 +73,7 @@ SHOW DNODES;
为充分利用多核技术,并提供 scalability,数据需要分片处理。因此 TDengine 会将一个 DB 的数据切分成多份,存放在多个 vnode 里。这些 vnode 可能分布在多个数据节点 dnode 里,这样就实现了水平扩展。一个 vnode 仅仅属于一个 DB,但一个 DB 可以有多个 vnode。vnode 所在的数据节点是 mnode 根据当前系统资源的情况,自动进行分配的,无需任何人工干预。
为充分利用多核技术,并提供 scalability,数据需要分片处理。因此 TDengine 会将一个 DB 的数据切分成多份,存放在多个 vnode 里。这些 vnode 可能分布在多个数据节点 dnode 里,这样就实现了水平扩展。一个 vnode 仅仅属于一个 DB,但一个 DB 可以有多个 vnode。vnode 所在的数据节点是 mnode 根据当前系统资源的情况,自动进行分配的,无需任何人工干预。
执行 CLI 程序 taos,
执行:
启动 CLI 程序 taos,然后
执行:
```
sql
```
sql
USE
SOME_DATABASE
;
USE
SOME_DATABASE
;
...
...
docs-cn/11-operation/07-import.md
浏览文件 @
fa1c21ab
...
@@ -58,4 +58,4 @@ Query OK, 9 row(s) affected (0.004763s)
...
@@ -58,4 +58,4 @@ Query OK, 9 row(s) affected (0.004763s)
## taosdump 工具导入
## taosdump 工具导入
TDengine 提供了方便的数据库导入导出工具 taosdump。用户可以将 taosdump 从一个系统导出的数据,导入到其他系统中。具体使用方法,请参见:
[
TDengine 数据备份工具: taosdump
](
https://
www.taosdata.com/docs/cn/v2.0/tools/taosdump
)
。
TDengine 提供了方便的数据库导入导出工具 taosdump。用户可以将 taosdump 从一个系统导出的数据,导入到其他系统中。具体使用方法,请参见:
[
TDengine 数据备份工具: taosdump
](
https://
github.com/taosdata/taos-tools/blob/develop/taosdump-user-manual-CN.md
)
。
docs-cn/11-operation/08-export.md
浏览文件 @
fa1c21ab
...
@@ -16,6 +16,5 @@ select * from <tb_name> >> data.csv;
...
@@ -16,6 +16,5 @@ select * from <tb_name> >> data.csv;
## 用 taosdump 导出数据
## 用 taosdump 导出数据
利用 taosdump,用户可以根据需要选择导出所有数据库、一个数据库或者数据库中的一张表,所有数据或一时间段的数据,甚至仅仅表的定义。
利用 taosdump,用户可以根据需要选择导出所有数据库、一个数据库或者数据库中的一张表,所有数据或一时间段的数据,甚至仅仅表的定义。具体使用方法,请参见:
[
TDengine 数据备份工具: taosdump
](
https://github.com/taosdata/taos-tools/blob/develop/taosdump-user-manual-CN.md
)
。
具体使用方法,请参见博客:
[
TDengine DUMP 工具使用指南
](
https://github.com/taosdata/taos-tools/blob/develop/taosdump-user-manual-CN.md
)
。
docs-cn/11-operation/11-optimize.md
浏览文件 @
fa1c21ab
...
@@ -2,7 +2,7 @@
...
@@ -2,7 +2,7 @@
title
:
性能优化
title
:
性能优化
---
---
因数据行
[
update
](
https://www.taosdata.com/cn/documentation/faq
#update
)
、表删除、数据过期等原因,TDengine 的磁盘存储文件有可能出现数据碎片,影响查询操作的性能表现。从 2.1.3.0 版本开始,新增 SQL 指令 COMPACT 来启动碎片重整过程:
因数据行
[
update
](
/train-fqa/faq/
#update
)
、表删除、数据过期等原因,TDengine 的磁盘存储文件有可能出现数据碎片,影响查询操作的性能表现。从 2.1.3.0 版本开始,新增 SQL 指令 COMPACT 来启动碎片重整过程:
```
sql
```
sql
COMPACT
VNODES
IN
(
vg_id1
,
vg_id2
,
...)
COMPACT
VNODES
IN
(
vg_id1
,
vg_id2
,
...)
...
...
docs-cn/13-tdinternal/01-arch.md
浏览文件 @
fa1c21ab
...
@@ -187,7 +187,7 @@ TDengine 分布式架构的逻辑结构图如下:
...
@@ -187,7 +187,7 @@ TDengine 分布式架构的逻辑结构图如下:
-
集群数据节点对外提供 RESTful 服务占用一个 TCP 端口,是 serverPort+11。
-
集群数据节点对外提供 RESTful 服务占用一个 TCP 端口,是 serverPort+11。
-
集群内数据节点与 Arbitrator 节点之间通讯占用一个 TCP 端口,是 serverPort+12。
-
集群内数据节点与 Arbitrator 节点之间通讯占用一个 TCP 端口,是 serverPort+12。
因此一个数据节点总的端口范围为 serverPort 到 serverPort+12,总共 13 个 TCP/UDP 端口。使用时,需要确保防火墙将这些端口打开。每个数据节点可以配置不同的 serverPort。
(详细的端口情况请参见
[
TDengine 2.0 端口说明
](
https://www.taosdata.com/cn/documentation
/faq#port
)
因此一个数据节点总的端口范围为 serverPort 到 serverPort+12,总共 13 个 TCP/UDP 端口。使用时,需要确保防火墙将这些端口打开。每个数据节点可以配置不同的 serverPort。
详细的端口情况请参见
[
TDengine 2.0 端口说明
](
/train-fqa
/faq#port
)
**集群对外连接:**
TDengine 集群可以容纳单个、多个甚至几千个数据节点。应用只需要向集群中任何一个数据节点发起连接即可,连接需要提供的网络参数是一数据节点的 End Point(FQDN 加配置的端口号)。通过命令行 CLI 启动应用 taos 时,可以通过选项-h 来指定数据节点的 FQDN,-P 来指定其配置的端口号,如果端口不配置,将采用 TDengine 的系统配置参数 serverPort。
**集群对外连接:**
TDengine 集群可以容纳单个、多个甚至几千个数据节点。应用只需要向集群中任何一个数据节点发起连接即可,连接需要提供的网络参数是一数据节点的 End Point(FQDN 加配置的端口号)。通过命令行 CLI 启动应用 taos 时,可以通过选项-h 来指定数据节点的 FQDN,-P 来指定其配置的端口号,如果端口不配置,将采用 TDengine 的系统配置参数 serverPort。
...
@@ -317,7 +317,7 @@ Vnode 会保持一个数据版本号(version),对内存数据进行持久
...
@@ -317,7 +317,7 @@ Vnode 会保持一个数据版本号(version),对内存数据进行持久
3.
在线的虚拟节点数过半,而且有虚拟节点是 slave 的话,该虚拟节点自动成为 master
3.
在线的虚拟节点数过半,而且有虚拟节点是 slave 的话,该虚拟节点自动成为 master
4.
对于 2 和 3,如果多个虚拟节点满足成为 master 的要求,那么虚拟节点组的节点列表里,最前面的选为 master
4.
对于 2 和 3,如果多个虚拟节点满足成为 master 的要求,那么虚拟节点组的节点列表里,最前面的选为 master
更多的关于数据复制的流程,请见
[
《TDengine 2.0 数据复制模块设计》
](
https://www.taosdata.com/cn/documentation/architecture
/replica/
)
。
更多的关于数据复制的流程,请见
[
《TDengine 2.0 数据复制模块设计》
](
/tdinternal
/replica/
)
。
### 同步复制
### 同步复制
...
...
docs-cn/13-tdinternal/02-replica.md
浏览文件 @
fa1c21ab
...
@@ -13,7 +13,7 @@ TDengine面向的是物联网场景,需要支持数据的实时复制,来最
...
@@ -13,7 +13,7 @@ TDengine面向的是物联网场景,需要支持数据的实时复制,来最
数据复制是与数据存储(写入、读取)密切相关的,但两者又是相对独立,可以完全脱耦的。在TDengine系统中,有两种不同类型的数据,一种是时序数据,由TSDB模块负责;一种是元数据(Meta Data), 由MNODE负责。这两种性质不同的数据都需要同步功能。数据复制模块通过不同的实例启动配置参数,为这两种类型数据都提供同步功能。
数据复制是与数据存储(写入、读取)密切相关的,但两者又是相对独立,可以完全脱耦的。在TDengine系统中,有两种不同类型的数据,一种是时序数据,由TSDB模块负责;一种是元数据(Meta Data), 由MNODE负责。这两种性质不同的数据都需要同步功能。数据复制模块通过不同的实例启动配置参数,为这两种类型数据都提供同步功能。
在阅读本文之前,请先阅读《
[
TDengine 2.0 整体架构
](
https://www.taosdata.com/cn/documentation/architecture
/
)
》,了解TDengine的集群设计和基本概念
在阅读本文之前,请先阅读《
[
TDengine 2.0 整体架构
](
/tdinternal/arch
/
)
》,了解TDengine的集群设计和基本概念
特别注明:本文中提到数据更新操作包括数据的增加、删除与修改。
特别注明:本文中提到数据更新操作包括数据的增加、删除与修改。
...
...
docs-cn/13-tdinternal/03-taosd.md
浏览文件 @
fa1c21ab
...
@@ -95,7 +95,7 @@ TSDB 中存储的元数据包含属于其所在的 vnode 中表的类型,schem
...
@@ -95,7 +95,7 @@ TSDB 中存储的元数据包含属于其所在的 vnode 中表的类型,schem
该模块实现数据的多副本复制,包括vnode与mnode的数据复制,支持异步和同步两种复制方式,以满足meta data与时序数据不同复制的需求。因为它为mnode与vnode共享,系统为mnode副本预留了一个特殊的vgroup ID:1。因此vnode group的ID是从2开始的。
该模块实现数据的多副本复制,包括vnode与mnode的数据复制,支持异步和同步两种复制方式,以满足meta data与时序数据不同复制的需求。因为它为mnode与vnode共享,系统为mnode副本预留了一个特殊的vgroup ID:1。因此vnode group的ID是从2开始的。
每个vnode/mnode模块实例会有一对应的sync模块实例,他们是一一对应的。详细设计请见
[
TDengine 2.0 数据复制模块设计
](
https://www.taosdata.com/cn/documentation/architecture
/replica/
)
每个vnode/mnode模块实例会有一对应的sync模块实例,他们是一一对应的。详细设计请见
[
TDengine 2.0 数据复制模块设计
](
/tdinternal
/replica/
)
## WAL模块
## WAL模块
...
...
docs-cn/14-reference/01-taos-sql/02-database.md
浏览文件 @
fa1c21ab
...
@@ -21,13 +21,13 @@ CREATE DATABASE [IF NOT EXISTS] db_name [KEEP keep] [DAYS days] [UPDATE 1];
...
@@ -21,13 +21,13 @@ CREATE DATABASE [IF NOT EXISTS] db_name [KEEP keep] [DAYS days] [UPDATE 1];
3.
UPDATE 设为 2 时,表示支持更新部分列数据,即如果更新一个数据行,其中某些列没有提供取值,那么这些列会保持原有数据行中的对应值;
3.
UPDATE 设为 2 时,表示支持更新部分列数据,即如果更新一个数据行,其中某些列没有提供取值,那么这些列会保持原有数据行中的对应值;
4.
更多关于 UPDATE 参数的用法,请参考
[
FAQ
](
https://www.taosdata.com/cn/documentation
/faq
)
。
4.
更多关于 UPDATE 参数的用法,请参考
[
FAQ
](
/train-fqa
/faq
)
。
3.
数据库名最大长度为 33;
3.
数据库名最大长度为 33;
4.
一条 SQL 语句的最大长度为 65480 个字符;
4.
一条 SQL 语句的最大长度为 65480 个字符;
5.
数据库还有更多与存储相关的配置参数,请参见
[
服务端配置
](
https://www.taosdata.com/cn/documentation/administrator#config
)
章节。
5.
数据库还有更多与存储相关的配置参数,请参见
[
配置参数
](
/reference/server-config/
)
章节。
:::
:::
...
...
docs-cn/14-reference/01-taos-sql/04-stable.md
浏览文件 @
fa1c21ab
...
@@ -21,7 +21,7 @@ CREATE STABLE [IF NOT EXISTS] stb_name (timestamp_field_name TIMESTAMP, field1_n
...
@@ -21,7 +21,7 @@ CREATE STABLE [IF NOT EXISTS] stb_name (timestamp_field_name TIMESTAMP, field1_n
1.
TAGS 列的数据类型不能是 timestamp 类型;(从 2.1.3.0 版本开始,TAGS 列中支持使用 timestamp 类型,但需注意在 TAGS 中的 timestamp 列写入数据时需要提供给定值,而暂不支持四则运算,例如
`NOW + 10s`
这类表达式)
1.
TAGS 列的数据类型不能是 timestamp 类型;(从 2.1.3.0 版本开始,TAGS 列中支持使用 timestamp 类型,但需注意在 TAGS 中的 timestamp 列写入数据时需要提供给定值,而暂不支持四则运算,例如
`NOW + 10s`
这类表达式)
2.
TAGS 列名不能与其他列名相同;
2.
TAGS 列名不能与其他列名相同;
3.
TAGS 列名不能为预留关键字(参见:
[
参数限制与保留关键字
](
https://www.taosdata.com/cn/documentation/administrator#keywords
)
章节);
3.
TAGS 列名不能为预留关键字(参见:
[
参数限制与保留关键字
](
/reference/keywords/
)
章节);
4.
TAGS 最多允许 128 个,至少 1 个,总长度不超过 16 KB。
4.
TAGS 最多允许 128 个,至少 1 个,总长度不超过 16 KB。
:::
:::
...
...
docs-cn/14-reference/01-taos-sql/08-interval.md
浏览文件 @
fa1c21ab
...
@@ -93,7 +93,7 @@ SELECT function_list FROM stb_name
...
@@ -93,7 +93,7 @@ SELECT function_list FROM stb_name
:::
:::
时间聚合也常被用于连续查询场景,可以参考文档
[
连续查询(Continuous Query)
](
https://www.taosdata.com/cn/documentation/advanced-features#
continuous-query
)
。
时间聚合也常被用于连续查询场景,可以参考文档
[
连续查询(Continuous Query)
](
/advance-feature/
continuous-query
)
。
## 示例
## 示例
...
...
docs-cn/14-reference/03-connector/03-connector.mdx
浏览文件 @
fa1c21ab
...
@@ -51,7 +51,7 @@ TDengine 提供了丰富的应用程序开发接口,其中包括支持使用 C
...
@@ -51,7 +51,7 @@ TDengine 提供了丰富的应用程序开发接口,其中包括支持使用 C
- 在没有安装 TDengine 服务端软件的系统中使用连接器(除 RESTful 外)访问 TDengine 数据库,需要安装相应版本的客户端安装包来使应用驱动(Linux 系统中文件名为 libtaos.so,Windows 系统中为 taos.dll)被安装在系统中,否则会产生无法找到相应库文件的错误。
- 在没有安装 TDengine 服务端软件的系统中使用连接器(除 RESTful 外)访问 TDengine 数据库,需要安装相应版本的客户端安装包来使应用驱动(Linux 系统中文件名为 libtaos.so,Windows 系统中为 taos.dll)被安装在系统中,否则会产生无法找到相应库文件的错误。
- 所有执行 SQL 语句的 API,例如 C/C++ Connector 中的 `tao_query`、`taos_query_a`、`taos_subscribe` 等,以及其它语言中与它们对应的 API,每次都只能执行一条 SQL 语句,如果实际参数中包含了多条语句,它们的行为是未定义的。
- 所有执行 SQL 语句的 API,例如 C/C++ Connector 中的 `tao_query`、`taos_query_a`、`taos_subscribe` 等,以及其它语言中与它们对应的 API,每次都只能执行一条 SQL 语句,如果实际参数中包含了多条语句,它们的行为是未定义的。
- 升级 TDengine 到 2.0.8.0 版本的用户,必须更新 JDBC。连接 TDengine 必须升级 taos-jdbcdriver 到 2.0.12 及以上。详细的版本依赖关系请参见 [taos-jdbcdriver 文档](
https://www.taosdata.com/cn/documentation
/connector/java#version)。
- 升级 TDengine 到 2.0.8.0 版本的用户,必须更新 JDBC。连接 TDengine 必须升级 taos-jdbcdriver 到 2.0.12 及以上。详细的版本依赖关系请参见 [taos-jdbcdriver 文档](
/reference
/connector/java#version)。
- 无论选用何种编程语言的连接器,2.0 及以上版本的 TDengine 推荐数据库应用的每个线程都建立一个独立的连接,或基于线程建立连接池,以避免连接内的“USE statement”状态量在线程之间相互干扰(但连接的查询和写入操作都是线程安全的)。
- 无论选用何种编程语言的连接器,2.0 及以上版本的 TDengine 推荐数据库应用的每个线程都建立一个独立的连接,或基于线程建立连接池,以避免连接内的“USE statement”状态量在线程之间相互干扰(但连接的查询和写入操作都是线程安全的)。
:::
:::
...
...
docs-cn/14-reference/03-connector/cpp.mdx
浏览文件 @
fa1c21ab
...
@@ -199,7 +199,7 @@ TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多
...
@@ -199,7 +199,7 @@ TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多
说明:如果 `taos_stmt_execute` 执行成功,假如不需要改变 SQL 语句的话,那么是可以复用 `taos_stmt_prepare` 的解析结果,直接进行第 3 ~ 6 步绑定新数据的。但如果执行出错,那么并不建议继续在当前的环境上下文下继续工作,而是建议释放资源,然后从 `taos_stmt_init` 步骤重新开始。
说明:如果 `taos_stmt_execute` 执行成功,假如不需要改变 SQL 语句的话,那么是可以复用 `taos_stmt_prepare` 的解析结果,直接进行第 3 ~ 6 步绑定新数据的。但如果执行出错,那么并不建议继续在当前的环境上下文下继续工作,而是建议释放资源,然后从 `taos_stmt_init` 步骤重新开始。
除 C/C++ 语言外,TDengine 的 Java 语言 JNI Connector 也提供参数绑定接口支持,具体请另外参见:[参数绑定接口的 Java 用法](
https://www.taosdata.com/cn/documentation/connector/java#stmt-java
)。
除 C/C++ 语言外,TDengine 的 Java 语言 JNI Connector 也提供参数绑定接口支持,具体请另外参见:[参数绑定接口的 Java 用法](
/reference/connector/java#通过参数绑定写入数据
)。
接口相关的具体函数如下(也可以参考 [prepare.c](https://github.com/taosdata/TDengine/blob/develop/examples/c/prepare.c) 文件中使用对应函数的方式):
接口相关的具体函数如下(也可以参考 [prepare.c](https://github.com/taosdata/TDengine/blob/develop/examples/c/prepare.c) 文件中使用对应函数的方式):
...
@@ -277,7 +277,7 @@ TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多
...
@@ -277,7 +277,7 @@ TDengine 的异步 API 均采用非阻塞调用模式。应用程序可以用多
## Schemaless 方式写入接口
## Schemaless 方式写入接口
除了使用 SQL 方式或者使用参数绑定 API 写入数据外,还可以使用 Schemaless 的方式完成写入。Schemaless 可以免于预先创建超级表/数据子表的数据结构,而是可以直接写入数据,TDengine 系统会根据写入的数据内容自动创建和维护所需要的表结构。Schemaless 的使用方式详见 [Schemaless 写入](
https://www.taosdata.com/cn/documentation/insert#schemaless
) 章节,这里介绍与之配套使用的 C/C++ API。
除了使用 SQL 方式或者使用参数绑定 API 写入数据外,还可以使用 Schemaless 的方式完成写入。Schemaless 可以免于预先创建超级表/数据子表的数据结构,而是可以直接写入数据,TDengine 系统会根据写入的数据内容自动创建和维护所需要的表结构。Schemaless 的使用方式详见 [Schemaless 写入](
/reference/schemaless/
) 章节,这里介绍与之配套使用的 C/C++ API。
- `TAOS_RES* taos_schemaless_insert(TAOS* taos, const char* lines[], int numLines, int protocol, int precision)`
- `TAOS_RES* taos_schemaless_insert(TAOS* taos, const char* lines[], int numLines, int protocol, int precision)`
...
...
docs-cn/14-reference/03-connector/java.mdx
浏览文件 @
fa1c21ab
...
@@ -113,7 +113,7 @@ TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对
...
@@ -113,7 +113,7 @@ TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对
- libtaos.so 在 Linux 系统中成功安装 TDengine 后,依赖的本地函数库 libtaos.so 文件会被自动拷贝至 /usr/lib/libtaos.so,该目录包含在 Linux 自动扫描路径上,无需单独指定。
- libtaos.so 在 Linux 系统中成功安装 TDengine 后,依赖的本地函数库 libtaos.so 文件会被自动拷贝至 /usr/lib/libtaos.so,该目录包含在 Linux 自动扫描路径上,无需单独指定。
- taos.dll 在 Windows 系统中安装完客户端之后,驱动包依赖的 taos.dll 文件会自动拷贝到系统默认搜索路径 C:/Windows/System32 下,同样无需要单独指定。
- taos.dll 在 Windows 系统中安装完客户端之后,驱动包依赖的 taos.dll 文件会自动拷贝到系统默认搜索路径 C:/Windows/System32 下,同样无需要单独指定。
**注意**:在 Windows 环境开发时需要安装 TDengine 对应的 [windows 客户端](https://www.taosdata.com/cn/all-downloads/#TDengine-Windows-Client),Linux 服务器安装完 TDengine 之后默认已安装 client,也可以单独安装 [Linux 客户端](
https://www.taosdata.com/cn/getting-started/#快速上手
) 连接远程 TDengine Server。
**注意**:在 Windows 环境开发时需要安装 TDengine 对应的 [windows 客户端](https://www.taosdata.com/cn/all-downloads/#TDengine-Windows-Client),Linux 服务器安装完 TDengine 之后默认已安装 client,也可以单独安装 [Linux 客户端](
/get-started/
) 连接远程 TDengine Server。
### 通过 maven 获取 JDBC driver
### 通过 maven 获取 JDBC driver
...
@@ -190,7 +190,7 @@ Connection conn = DriverManager.getConnection(jdbcUrl);
...
@@ -190,7 +190,7 @@ Connection conn = DriverManager.getConnection(jdbcUrl);
**注意**:使用 JDBC-JNI 的 driver,taos-jdbcdriver 驱动包时需要依赖系统对应的本地函数库(Linux 下是 libtaos.so;Windows 下是 taos.dll)。
**注意**:使用 JDBC-JNI 的 driver,taos-jdbcdriver 驱动包时需要依赖系统对应的本地函数库(Linux 下是 libtaos.so;Windows 下是 taos.dll)。
> 在 Windows 环境开发时需要安装 TDengine 对应的 [windows 客户端](https://www.taosdata.com/cn/all-downloads/#TDengine-Windows-Client),Linux 服务器安装完 TDengine 之后默认已安装 client,也可以单独安装 [Linux 客户端](
https://www.taosdata.com/cn/getting-started/#%E5%AE%A2%E6%88%B7%E7%AB%AF
) 连接远程 TDengine Server。
> 在 Windows 环境开发时需要安装 TDengine 对应的 [windows 客户端](https://www.taosdata.com/cn/all-downloads/#TDengine-Windows-Client),Linux 服务器安装完 TDengine 之后默认已安装 client,也可以单独安装 [Linux 客户端](
/get-started/
) 连接远程 TDengine Server。
JDBC-JNI 的使用请参见[视频教程](https://www.taosdata.com/blog/2020/11/11/1955.html)。
JDBC-JNI 的使用请参见[视频教程](https://www.taosdata.com/blog/2020/11/11/1955.html)。
...
@@ -293,7 +293,7 @@ TDengine 中,只要保证 firstEp 和 secondEp 中一个节点有效,就可
...
@@ -293,7 +293,7 @@ TDengine 中,只要保证 firstEp 和 secondEp 中一个节点有效,就可
例如:在 url 中指定了 password 为 taosdata,在 Properties 中指定了 password 为 taosdemo,那么,JDBC 会使用 url 中的 password 建立连接。
例如:在 url 中指定了 password 为 taosdata,在 Properties 中指定了 password 为 taosdemo,那么,JDBC 会使用 url 中的 password 建立连接。
> 更多详细配置请参考[客户端配置](
https://www.taosdata.com/cn/documentation/administrator/#client
)
> 更多详细配置请参考[客户端配置](
/reference/server-config/#仅客户端适用
)
### 创建数据库和表
### 创建数据库和表
...
@@ -640,7 +640,7 @@ public void setNString(int columnIndex, ArrayList<String> list, int size) throws
...
@@ -640,7 +640,7 @@ public void setNString(int columnIndex, ArrayList<String> list, int size) throws
### 无模式写入
### 无模式写入
从 2.2.0.0 版本开始,TDengine 增加了对无模式写入功能。无模式写入兼容 InfluxDB 的 行协议(Line Protocol)、OpenTSDB 的 telnet 行协议和 OpenTSDB 的 JSON 格式协议。详情请参见[无模式写入](
https://www.taosdata.com/docs/cn/v2.0/insert#schemaless
)。
从 2.2.0.0 版本开始,TDengine 增加了对无模式写入功能。无模式写入兼容 InfluxDB 的 行协议(Line Protocol)、OpenTSDB 的 telnet 行协议和 OpenTSDB 的 JSON 格式协议。详情请参见[无模式写入](
/reference/schemaless/
)。
注意:
注意:
...
...
docs-cn/14-reference/03-connector/python.mdx
浏览文件 @
fa1c21ab
...
@@ -255,7 +255,7 @@ k1 = conn.query("select info->'k1' as k1 from s1").fetch_all_into_dict()
...
@@ -255,7 +255,7 @@ k1 = conn.query("select info->'k1' as k1 from s1").fetch_all_into_dict()
"""
"""
```
```
更多 JSON 类型的操作方式请参考 [JSON 类型使用说明](
https://www.taosdata.com/cn/documentation/taos-sql
)。
更多 JSON 类型的操作方式请参考 [JSON 类型使用说明](
/reference/taos-sql/
)。
## 关于纳秒 (nanosecond) 在 Python 连接器中的说明
## 关于纳秒 (nanosecond) 在 Python 连接器中的说明
...
...
docs-cn/14-reference/08-server-config/08-server-config.md
浏览文件 @
fa1c21ab
...
@@ -87,7 +87,7 @@ taos --dump-config
...
@@ -87,7 +87,7 @@ taos --dump-config
| TCP | 6030 | 客户端与服务端之间通讯。 | 由配置文件设置 serverPort 决定。 |
| TCP | 6030 | 客户端与服务端之间通讯。 | 由配置文件设置 serverPort 决定。 |
| TCP | 6035 | 多节点集群的节点间通讯。 | 随 serverPort 端口变化。 |
| TCP | 6035 | 多节点集群的节点间通讯。 | 随 serverPort 端口变化。 |
| TCP | 6040 | 多节点集群的节点间数据同步。 | 随 serverPort 端口变化。 |
| TCP | 6040 | 多节点集群的节点间数据同步。 | 随 serverPort 端口变化。 |
| TCP | 6041 | 客户端与服务端之间的 RESTful 通讯。 | 随 serverPort 端口变化。注意 taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
www.taosdata.com/cn/documentation/tools/adapter
)
。 |
| TCP | 6041 | 客户端与服务端之间的 RESTful 通讯。 | 随 serverPort 端口变化。注意 taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
github.com/taosdata/taosadapter/blob/develop/README-CN.md
)
。 |
| TCP | 6042 | Arbitrator 的服务端口。 | 随 Arbitrator 启动参数设置变化。 |
| TCP | 6042 | Arbitrator 的服务端口。 | 随 Arbitrator 启动参数设置变化。 |
| TCP | 6043 | TaosKeeper 监控服务端口。 | 随 TaosKeeper 启动参数设置变化。 |
| TCP | 6043 | TaosKeeper 监控服务端口。 | 随 TaosKeeper 启动参数设置变化。 |
| TCP | 6044 | 支持 StatsD 的数据接入端口。 | 随 taosAdapter 启动参数设置变化(2.3.0.1+以上版本)。 |
| TCP | 6044 | 支持 StatsD 的数据接入端口。 | 随 taosAdapter 启动参数设置变化(2.3.0.1+以上版本)。 |
...
@@ -783,7 +783,7 @@ taos --dump-config
...
@@ -783,7 +783,7 @@ taos --dump-config
:::note
:::note
HTTP服务在2.4.0.0(不含)以前的版本中由taosd提供,在2.4.0.0以后(含)由taosAdapter提供。
HTTP服务在2.4.0.0(不含)以前的版本中由taosd提供,在2.4.0.0以后(含)由taosAdapter提供。
本节的配置参数仅在2.4.0.0(不含)以前的版本中生效。如果您使用的是2.4.0.0(含)及以后的版本请参考
[
文档
](
https://
www.taosdata.com/cn/documentation/tools/adapter
)
。
本节的配置参数仅在2.4.0.0(不含)以前的版本中生效。如果您使用的是2.4.0.0(含)及以后的版本请参考
[
文档
](
https://
github.com/taosdata/taosadapter/blob/develop/README-CN.md
)
。
:::
:::
...
@@ -810,7 +810,7 @@ HTTP服务在2.4.0.0(不含)以前的版本中由taosd提供,在2.4.0.0以
...
@@ -810,7 +810,7 @@ HTTP服务在2.4.0.0(不含)以前的版本中由taosd提供,在2.4.0.0以
| 属性 | 说明 |
| 属性 | 说明 |
| -------- | --------------------------------------------------------------------------------------------------------------------------- |
| -------- | --------------------------------------------------------------------------------------------------------------------------- |
| 适用范围 | 仅服务端适用 |
| 适用范围 | 仅服务端适用 |
| 含义 | RESTFul 接口的线程数。taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
www.taosdata.com/cn/documentation/tools/adapter
)
。 |
| 含义 | RESTFul 接口的线程数。taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
github.com/taosdata/taosadapter/blob/develop/README-CN.md
)
。 |
| 缺省值 | 2 |
| 缺省值 | 2 |
### restfulRowLimit
### restfulRowLimit
...
@@ -818,7 +818,7 @@ HTTP服务在2.4.0.0(不含)以前的版本中由taosd提供,在2.4.0.0以
...
@@ -818,7 +818,7 @@ HTTP服务在2.4.0.0(不含)以前的版本中由taosd提供,在2.4.0.0以
| 属性 | 说明 |
| 属性 | 说明 |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| 适用范围 | 仅服务端适用 |
| 适用范围 | 仅服务端适用 |
| 含义 | RESTFul 接口单次返回的记录条数。taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
www.taosdata.com/cn/documentation/tools/adapter
)
。 |
| 含义 | RESTFul 接口单次返回的记录条数。taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
github.com/taosdata/taosadapter/blob/develop/README-CN.md
)
。 |
| 缺省值 | 10240 |
| 缺省值 | 10240 |
| 补充说明 | 最大 10,000,000 |
| 补充说明 | 最大 10,000,000 |
...
...
docs-cn/14-reference/13-schemaless/13-schemaless.md
浏览文件 @
fa1c21ab
...
@@ -83,7 +83,7 @@ st,t1=3,t2=4,t3=t3 c1=3i64,c3="passit",c2=false,c4=4f64 1626006833639000000
...
@@ -83,7 +83,7 @@ st,t1=3,t2=4,t3=t3 c1=3i64,c3="passit",c2=false,c4=4f64 1626006833639000000
:::tip
:::tip
无模式所有的处理逻辑,仍会遵循 TDengine 对数据结构的底层限制,例如每行数据的总长度不能超过
无模式所有的处理逻辑,仍会遵循 TDengine 对数据结构的底层限制,例如每行数据的总长度不能超过
16k 字节。这方面的具体限制约束请参见
[
TAOS SQL 边界限制
](
https://www.taosdata.com/cn/documentation/taos-sql#limitation
)
16k 字节。这方面的具体限制约束请参见
[
TAOS SQL 边界限制
](
/reference/taos-sql/limit
)
:::
:::
...
...
docs-cn/15-application/03-immigrate.md
浏览文件 @
fa1c21ab
...
@@ -47,7 +47,7 @@ title: OpenTSDB 应用迁移到 TDengine 的最佳实践
...
@@ -47,7 +47,7 @@ title: OpenTSDB 应用迁移到 TDengine 的最佳实践
用户可以根据需求弹性部署 taosAdapter 实例,结合场景的需要,快速提升数据写入的吞吐量,为不同应用场景下的数据写入提供保障。
用户可以根据需求弹性部署 taosAdapter 实例,结合场景的需要,快速提升数据写入的吞吐量,为不同应用场景下的数据写入提供保障。
通过 taosAdapter,用户可以将 collectd 和 StatsD 收集的数据直接推送到 TDengine ,实现应用场景的无缝迁移,非常的轻松便捷。taosAdapter 还支持 Telegraf、Icinga、TCollector 、node_exporter 的数据接入,使用详情参考
[
taosAdapter
](
https://
www.taosdata.com/cn/documentation/tools/adapter
)
。
通过 taosAdapter,用户可以将 collectd 和 StatsD 收集的数据直接推送到 TDengine ,实现应用场景的无缝迁移,非常的轻松便捷。taosAdapter 还支持 Telegraf、Icinga、TCollector 、node_exporter 的数据接入,使用详情参考
[
taosAdapter
](
https://
github.com/taosdata/taosadapter/blob/develop/README-CN.md
)
。
如果使用 collectd,修改其默认位置
`/etc/collectd/collectd.conf`
的配置文件为指向 taosAdapter 部署的节点 IP 地址和端口。假设 taosAdapter 的 IP 地址为 192.168.1.130,端口为 6046,配置如下:
如果使用 collectd,修改其默认位置
`/etc/collectd/collectd.conf`
的配置文件为指向 taosAdapter 部署的节点 IP 地址和端口。假设 taosAdapter 的 IP 地址为 192.168.1.130,端口为 6046,配置如下:
...
@@ -65,7 +65,7 @@ LoadPlugin write_tsdb
...
@@ -65,7 +65,7 @@ LoadPlugin write_tsdb
-
**调整看板(Dashborad)系统**
-
**调整看板(Dashborad)系统**
在数据能够正常写入 TDengine 后,可以调整适配 Grafana 将写入 TDengine 的数据可视化呈现出来。获取和使用 TDengine 提供的 Grafana 插件请参考
[
与其他工具的连接
](
https://www.taosdata.com/cn/documentation/connections#
grafana
)
。
在数据能够正常写入 TDengine 后,可以调整适配 Grafana 将写入 TDengine 的数据可视化呈现出来。获取和使用 TDengine 提供的 Grafana 插件请参考
[
与其他工具的连接
](
/third-party/
grafana
)
。
TDengine 提供了默认的两套 Dashboard 模板,用户只需要将 Grafana 目录下的模板导入到 Grafana 中即可激活使用。
TDengine 提供了默认的两套 Dashboard 模板,用户只需要将 Grafana 目录下的模板导入到 Grafana 中即可激活使用。
...
@@ -360,7 +360,7 @@ WHERE ts>=1510560000 AND ts<=1515000009
...
@@ -360,7 +360,7 @@ WHERE ts>=1510560000 AND ts<=1515000009
### 计算资源估算
### 计算资源估算
由于物联网数据的特殊性,数据产生的频率固定以后,TDengine 写入的过程对于(计算和存储)资源消耗都保持一个相对固定的量。《
[
TDengine
的运营与维护
](
https://www.taosdata.com/cn/documentation/administrator
)
》上的描述,该系统中每秒 22000 个写入,消耗 CPU 不到 1 个核。
由于物联网数据的特殊性,数据产生的频率固定以后,TDengine 写入的过程对于(计算和存储)资源消耗都保持一个相对固定的量。《
[
TDengine
运维指南
](
/operation/
)
》上的描述,该系统中每秒 22000 个写入,消耗 CPU 不到 1 个核。
在针对查询所需要消耗的 CPU 资源的估算上,假设应用要求数据库提供的 QPS 为 10000,每次查询消耗的 CPU 时间约 1 ms,那么每个核每秒提供的查询为 1000 QPS,满足 10000 QPS 的查询请求,至少需要 10 个核。为了让系统整体上 CPU 负载小于 50%,整个集群需要 10 个核的两倍,即 20 个核。
在针对查询所需要消耗的 CPU 资源的估算上,假设应用要求数据库提供的 QPS 为 10000,每次查询消耗的 CPU 时间约 1 ms,那么每个核每秒提供的查询为 1000 QPS,满足 10000 QPS 的查询请求,至少需要 10 个核。为了让系统整体上 CPU 负载小于 50%,整个集群需要 10 个核的两倍,即 20 个核。
...
@@ -384,11 +384,11 @@ TDengine 提供了丰富的帮助文档说明集群安装、部署的诸多方
...
@@ -384,11 +384,11 @@ TDengine 提供了丰富的帮助文档说明集群安装、部署的诸多方
为确保系统能够正常获取运行的必要信息。请在服务端正确设置以下关键参数:
为确保系统能够正常获取运行的必要信息。请在服务端正确设置以下关键参数:
FQDN、firstEp、secondEP、dataDir、logDir、tmpDir、serverPort。各参数的具体含义及设置的要求,可参见文档《
[
TDengine 集群安装、管理
](
https://www.taosdata.com/cn/documentation/cluster
)
》
FQDN、firstEp、secondEP、dataDir、logDir、tmpDir、serverPort。各参数的具体含义及设置的要求,可参见文档《
[
TDengine 集群安装、管理
](
/cluster/
)
》
按照相同的步骤,在需要运行的节点上设置参数,并启动 taosd 服务,然后添加 Dnode 到集群中。
按照相同的步骤,在需要运行的节点上设置参数,并启动 taosd 服务,然后添加 Dnode 到集群中。
最后启动 taos,执行命令 show dnodes,如果能看到所有的加入集群的节点,那么集群顺利搭建完成。具体的操作流程及注意事项,请参阅文档《
[
TDengine 集群安装、管理
](
https://www.taosdata.com/cn/documentation/cluster
)
》
最后启动 taos,执行命令 show dnodes,如果能看到所有的加入集群的节点,那么集群顺利搭建完成。具体的操作流程及注意事项,请参阅文档《
[
TDengine 集群安装、管理
](
/cluster/
)
》
## 附录 4: 超级表名称
## 附录 4: 超级表名称
...
@@ -396,5 +396,5 @@ FQDN、firstEp、secondEP、dataDir、logDir、tmpDir、serverPort。各参数
...
@@ -396,5 +396,5 @@ FQDN、firstEp、secondEP、dataDir、logDir、tmpDir、serverPort。各参数
## 附录 5:参考文章
## 附录 5:参考文章
1.
[
使用 TDengine + collectd/StatsD + Grafana 快速搭建 IT 运维监控系统
](
https://www.taosdata.com/cn/documentation20/devops/collectd
)
1.
[
使用 TDengine + collectd/StatsD + Grafana 快速搭建 IT 运维监控系统
](
/application/collectd/
)
2.
[
通过 collectd 将采集数据直接写入 TDengine
](
https://www.taosdata.com/cn/documentation20/insert#collectd
)
2.
[
通过 collectd 将采集数据直接写入 TDengine
](
/third-party/collectd/
)
docs-cn/17-train-fqa/01-faq.md
浏览文件 @
fa1c21ab
...
@@ -199,7 +199,7 @@ TDengine 中时间戳的时区总是由客户端进行处理,而与服务端
...
@@ -199,7 +199,7 @@ TDengine 中时间戳的时区总是由客户端进行处理,而与服务端
| TCP | 6030 | 客户端与服务端之间通讯。 | 由配置文件设置 serverPort 决定。 |
| TCP | 6030 | 客户端与服务端之间通讯。 | 由配置文件设置 serverPort 决定。 |
| TCP | 6035 | 多节点集群的节点间通讯。 | 随 serverPort 端口变化。 |
| TCP | 6035 | 多节点集群的节点间通讯。 | 随 serverPort 端口变化。 |
| TCP | 6040 | 多节点集群的节点间数据同步。 | 随 serverPort 端口变化。 |
| TCP | 6040 | 多节点集群的节点间数据同步。 | 随 serverPort 端口变化。 |
| TCP | 6041 | 客户端与服务端之间的 RESTful 通讯。 | 随 serverPort 端口变化。注意 taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
www.taosdata.com/cn/documentation/tools/adapter
)
。 |
| TCP | 6041 | 客户端与服务端之间的 RESTful 通讯。 | 随 serverPort 端口变化。注意 taosAdapter 配置或有不同,请参考相应
[
文档
](
https://
github.com/taosdata/taosadapter/blob/develop/README-CN.md
)
。 |
| TCP | 6042 | Arbitrator 的服务端口。 | 随 Arbitrator 启动参数设置变化。 |
| TCP | 6042 | Arbitrator 的服务端口。 | 随 Arbitrator 启动参数设置变化。 |
| TCP | 6043 | TaosKeeper 监控服务端口。 | 随 TaosKeeper 启动参数设置变化。 |
| TCP | 6043 | TaosKeeper 监控服务端口。 | 随 TaosKeeper 启动参数设置变化。 |
| TCP | 6044 | 支持 StatsD 的数据接入端口。 | 随 taosAdapter 启动参数设置变化(2.3.0.1+以上版本)。 |
| TCP | 6044 | 支持 StatsD 的数据接入端口。 | 随 taosAdapter 启动参数设置变化(2.3.0.1+以上版本)。 |
...
...
docs-cn/17-train-fqa/03-docker.md
浏览文件 @
fa1c21ab
...
@@ -26,7 +26,7 @@ $ docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp tdengine/tdeng
...
@@ -26,7 +26,7 @@ $ docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp tdengine/tdeng
526aa188da767ae94b244226a2b2eec2b5f17dd8eff592893d9ec0cd0f3a1ccd
526aa188da767ae94b244226a2b2eec2b5f17dd8eff592893d9ec0cd0f3a1ccd
```
```
这条命令,启动一个运行了 TDengine server 的 docker 容器,并且将容器的 6030 到 6049 端口映射到宿主机的 6030 到 6049 端口上。如果宿主机已经运行了 TDengine server 并占用了相同端口,需要映射容器的端口到不同的未使用端口段。(详情参见
[
TDengine 2.0 端口说明
](
https://www.taosdata.com/cn/documentation/faq#port
)
)。为了支持 TDengine 客户端操作 TDengine server 服务, TCP 和 UDP 端口都需要打开。
这条命令,启动一个运行了 TDengine server 的 docker 容器,并且将容器的 6030 到 6049 端口映射到宿主机的 6030 到 6049 端口上。如果宿主机已经运行了 TDengine server 并占用了相同端口,需要映射容器的端口到不同的未使用端口段。(详情参见
[
TDengine 2.0 端口说明
](
/train-fqa/faq#port
)。为了支持
TDengine 客户端操作 TDengine server 服务, TCP 和 UDP 端口都需要打开。
-
**docker run**
:通过 Docker 运行一个容器
-
**docker run**
:通过 Docker 运行一个容器
-
**-d**
:让容器在后台运行
-
**-d**
:让容器在后台运行
...
@@ -90,7 +90,7 @@ taos>
...
@@ -90,7 +90,7 @@ taos>
TDengine 终端成功连接服务端,打印出了欢迎消息和版本信息。如果失败,会有错误信息打印出来。
TDengine 终端成功连接服务端,打印出了欢迎消息和版本信息。如果失败,会有错误信息打印出来。
在 TDengine 终端中,可以通过 SQL 命令来创建/删除数据库、表、超级表等,并可以进行插入和查询操作。具体可以参考
[
TAOS SQL 说明文档
](
https://www.taosdata.com/cn/documentation/taos-sql
)
。
在 TDengine 终端中,可以通过 SQL 命令来创建/删除数据库、表、超级表等,并可以进行插入和查询操作。具体可以参考
[
TAOS SQL 说明文档
](
/reference/taos-sql/
)
。
### 在宿主机访问 Docker 容器中的 TDengine server
### 在宿主机访问 Docker 容器中的 TDengine server
...
@@ -119,7 +119,7 @@ curl -u root:taosdata -d 'show databases' 127.0.0.1:6041/rest/sql
...
@@ -119,7 +119,7 @@ curl -u root:taosdata -d 'show databases' 127.0.0.1:6041/rest/sql
这条命令,通过 RESTful 接口访问 TDengine server,这时连接的是本机的 6041 端口,可见连接成功。
这条命令,通过 RESTful 接口访问 TDengine server,这时连接的是本机的 6041 端口,可见连接成功。
TDengine RESTful 接口详情请参考
[
官方文档
](
https://www.taosdata.com/cn/documentation/connector#restful
)
。
TDengine RESTful 接口详情请参考
[
官方文档
](
/reference/restful-api/
)
。
### 使用 Docker 容器运行 TDengine server 和 taosAdapter
### 使用 Docker 容器运行 TDengine server 和 taosAdapter
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录