docs: change based on Jeff comments
|
@ -6,7 +6,7 @@ toc_max_heading_level: 4
|
||||||
|
|
||||||
TDengine 是一个高性能、分布式的时序数据库。通过集成的缓存、数据订阅、流计算和数据清洗与转换等功能,TDengine 已经发展成为一个专为物联网、工业互联网、金融和 IT 运维等关键行业量身定制的时序大数据平台。该平台能够高效地汇聚、存储、分析、计算和分发来自海量数据采集点的大规模数据流,每日处理能力可达 TB 乃至 PB 级别。借助 TDengine,企业可以实现实时的业务监控和预警,进而发掘出有价值的商业洞察。
|
TDengine 是一个高性能、分布式的时序数据库。通过集成的缓存、数据订阅、流计算和数据清洗与转换等功能,TDengine 已经发展成为一个专为物联网、工业互联网、金融和 IT 运维等关键行业量身定制的时序大数据平台。该平台能够高效地汇聚、存储、分析、计算和分发来自海量数据采集点的大规模数据流,每日处理能力可达 TB 乃至 PB 级别。借助 TDengine,企业可以实现实时的业务监控和预警,进而发掘出有价值的商业洞察。
|
||||||
|
|
||||||
自 2019 年 7 月 以 来, 涛 思 数 据 陆 续 将 TDengine 的 不 同 版 本 开 源, 包 括 单 机版(2019 年 7 月)、集群版(2020 年 8 月)以及云原生版(2022 年 8 月)。开源之后,TDengine 迅速获得了全球开发者的关注,多次在 GitHub 网站全球趋势排行榜上位居榜首。截至编写本书时,TDengine 在 GitHub 网站上已积累近 2.3 万颗星,安装实例超过53 万个,覆盖 60 多个国家和地区,广泛应用于电力、石油、化工、新能源、智能制造、汽车、环境监测等行业或领域,赢得了全球开发者的广泛认可
|
自 2019 年 7 月 以 来, 涛 思 数 据 陆 续 将 TDengine 的 不 同 版 本 开 源, 包 括 单 机版(2019 年 7 月)、集群版(2020 年 8 月)以及云原生版(2022 年 8 月)。开源之后,TDengine 迅速获得了全球开发者的关注,多次在 GitHub 网站全球趋势排行榜上位居榜首,最新的关注热度见[涛思数据首页](https://www.taosdata.com/)。
|
||||||
|
|
||||||
## TDengine 产品
|
## TDengine 产品
|
||||||
|
|
||||||
|
|
|
@ -71,4 +71,54 @@ taos>
|
||||||
|
|
||||||
## 快速体验
|
## 快速体验
|
||||||
|
|
||||||
想要快速体验 TDengine 的写入和查询能力,请参考[快速体验](../use)
|
### 体验写入
|
||||||
|
|
||||||
|
taosBenchmark 是一个专为测试 TDengine 性能而设计的工具,它能够全面评估TDengine 在写入、查询和订阅等方面的功能表现。该工具能够模拟大量设备产生的数据,并允许用户灵活控制数据库、超级表、标签列的数量和类型、数据列的数量和类型、子表数量、每张子表的数据量、写入数据的时间间隔、工作线程数量以及是否写入乱序数据等策略。
|
||||||
|
|
||||||
|
启动 TDengine 的服务,在终端中执行如下命令
|
||||||
|
|
||||||
|
```shell
|
||||||
|
taosBenchmark -y
|
||||||
|
```
|
||||||
|
|
||||||
|
系统将自动在数据库 test 下创建一张名为 meters的超级表。这张超级表将包含 10 000 张子表,表名从 d0 到 d9999,每张表包含 10,000条记录。每条记录包含 ts(时间戳)、current(电流)、voltage(电压)和 phase(相位)4个字段。时间戳范围从“2017-07-14 10:40:00 000”到“2017-07-14 10:40:09 999”。每张表还带有 location 和 groupId 两个标签,其中,groupId 设置为 1 到 10,而 location 则设置为 California.Campbell、California.Cupertino 等城市信息。
|
||||||
|
|
||||||
|
执行该命令后,系统将迅速完成 1 亿条记录的写入过程。实际所需时间取决于硬件性能,但即便在普通 PC 服务器上,这个过程通常也只需要十几秒。
|
||||||
|
|
||||||
|
taosBenchmark 提供了丰富的选项,允许用户自定义测试参数,如表的数目、记录条数等。要查看详细的参数列表,请在终端中输入如下命令
|
||||||
|
```shell
|
||||||
|
taosBenchmark --help
|
||||||
|
```
|
||||||
|
|
||||||
|
有关taosBenchmark 的详细使用方法,请参考[taosBenchmark 参考手册](../../reference/components/taosbenchmark)
|
||||||
|
|
||||||
|
### 体验查询
|
||||||
|
|
||||||
|
使用上述 taosBenchmark 插入数据后,可以在 TDengine CLI(taos)输入查询命令,体验查询速度。
|
||||||
|
|
||||||
|
1. 查询超级表 meters 下的记录总条数
|
||||||
|
```shell
|
||||||
|
SELECT COUNT(*) FROM test.meters;
|
||||||
|
```
|
||||||
|
|
||||||
|
2. 查询 1 亿条记录的平均值、最大值、最小值
|
||||||
|
```shell
|
||||||
|
SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters;
|
||||||
|
```
|
||||||
|
|
||||||
|
3. 查询 location = "California.SanFrancisco" 的记录总条数
|
||||||
|
```shell
|
||||||
|
SELECT COUNT(*) FROM test.meters WHERE location = "California.SanFrancisco";
|
||||||
|
```
|
||||||
|
|
||||||
|
4. 查询 groupId = 10 的所有记录的平均值、最大值、最小值
|
||||||
|
```shell
|
||||||
|
SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters WHERE groupId = 10;
|
||||||
|
```
|
||||||
|
|
||||||
|
5. 对表 d1001 按每 10 秒进行平均值、最大值和最小值聚合统计
|
||||||
|
```shell
|
||||||
|
SELECT _wstart, AVG(current), MAX(voltage), MIN(phase) FROM test.d1001 INTERVAL(10s);
|
||||||
|
```
|
||||||
|
|
||||||
|
在上面的查询中,使用系统提供的伪列_wstart 来给出每个窗口的开始时间。
|
|
@ -267,4 +267,54 @@ Query OK, 2 row(s) in set (0.003128s)
|
||||||
|
|
||||||
## 快速体验
|
## 快速体验
|
||||||
|
|
||||||
想要快速体验 TDengine 的写入和查询能力,请参考[快速体验](../use)
|
### 体验写入
|
||||||
|
|
||||||
|
taosBenchmark 是一个专为测试 TDengine 性能而设计的工具,它能够全面评估TDengine 在写入、查询和订阅等方面的功能表现。该工具能够模拟大量设备产生的数据,并允许用户灵活控制数据库、超级表、标签列的数量和类型、数据列的数量和类型、子表数量、每张子表的数据量、写入数据的时间间隔、工作线程数量以及是否写入乱序数据等策略。
|
||||||
|
|
||||||
|
启动 TDengine 的服务,在终端中执行如下命令
|
||||||
|
|
||||||
|
```shell
|
||||||
|
taosBenchmark -y
|
||||||
|
```
|
||||||
|
|
||||||
|
系统将自动在数据库 test 下创建一张名为 meters的超级表。这张超级表将包含 10 000 张子表,表名从 d0 到 d9999,每张表包含 10,000条记录。每条记录包含 ts(时间戳)、current(电流)、voltage(电压)和 phase(相位)4个字段。时间戳范围从“2017-07-14 10:40:00 000”到“2017-07-14 10:40:09 999”。每张表还带有 location 和 groupId 两个标签,其中,groupId 设置为 1 到 10,而 location 则设置为 California.Campbell、California.Cupertino 等城市信息。
|
||||||
|
|
||||||
|
执行该命令后,系统将迅速完成 1 亿条记录的写入过程。实际所需时间取决于硬件性能,但即便在普通 PC 服务器上,这个过程通常也只需要十几秒。
|
||||||
|
|
||||||
|
taosBenchmark 提供了丰富的选项,允许用户自定义测试参数,如表的数目、记录条数等。要查看详细的参数列表,请在终端中输入如下命令
|
||||||
|
```shell
|
||||||
|
taosBenchmark --help
|
||||||
|
```
|
||||||
|
|
||||||
|
有关taosBenchmark 的详细使用方法,请参考[taosBenchmark 参考手册](../../reference/components/taosbenchmark)
|
||||||
|
|
||||||
|
### 体验查询
|
||||||
|
|
||||||
|
使用上述 taosBenchmark 插入数据后,可以在 TDengine CLI(taos)输入查询命令,体验查询速度。
|
||||||
|
|
||||||
|
1. 查询超级表 meters 下的记录总条数
|
||||||
|
```shell
|
||||||
|
SELECT COUNT(*) FROM test.meters;
|
||||||
|
```
|
||||||
|
|
||||||
|
2. 查询 1 亿条记录的平均值、最大值、最小值
|
||||||
|
```shell
|
||||||
|
SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters;
|
||||||
|
```
|
||||||
|
|
||||||
|
3. 查询 location = "California.SanFrancisco" 的记录总条数
|
||||||
|
```shell
|
||||||
|
SELECT COUNT(*) FROM test.meters WHERE location = "California.SanFrancisco";
|
||||||
|
```
|
||||||
|
|
||||||
|
4. 查询 groupId = 10 的所有记录的平均值、最大值、最小值
|
||||||
|
```shell
|
||||||
|
SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters WHERE groupId = 10;
|
||||||
|
```
|
||||||
|
|
||||||
|
5. 对表 d1001 按每 10 秒进行平均值、最大值和最小值聚合统计
|
||||||
|
```shell
|
||||||
|
SELECT _wstart, AVG(current), MAX(voltage), MIN(phase) FROM test.d1001 INTERVAL(10s);
|
||||||
|
```
|
||||||
|
|
||||||
|
在上面的查询中,使用系统提供的伪列_wstart 来给出每个窗口的开始时间。
|
|
@ -8,6 +8,10 @@ sidebar_label: 集群维护
|
||||||
|
|
||||||
本节介绍 TDengine Enterprise 中提供的高阶集群维护手段,能够使 TDengine 集群长期运行得更健壮和高效。
|
本节介绍 TDengine Enterprise 中提供的高阶集群维护手段,能够使 TDengine 集群长期运行得更健壮和高效。
|
||||||
|
|
||||||
|
## 节点管理
|
||||||
|
|
||||||
|
如何管理集群节点请参考[节点管理](../../reference/taos-sql/node)
|
||||||
|
|
||||||
## 数据重整
|
## 数据重整
|
||||||
|
|
||||||
TDengine 面向多种写入场景,而很多写入场景下,TDengine 的存储会导致数据存储的放大或数据文件的空洞等。这一方面影响数据的存储效率,另一方面也会影响查询效率。为了解决上述问题,TDengine 企业版提供了对数据的重整功能,即 DATA COMPACT 功能,将存储的数据文件重新整理,删除文件空洞和无效数据,提高数据的组织度,从而提高存储和查询的效率。数据重整功能在 3.0.3.0 版本第一次发布,此后又经过了多次迭代优化,建议使用最新版本。
|
TDengine 面向多种写入场景,而很多写入场景下,TDengine 的存储会导致数据存储的放大或数据文件的空洞等。这一方面影响数据的存储效率,另一方面也会影响查询效率。为了解决上述问题,TDengine 企业版提供了对数据的重整功能,即 DATA COMPACT 功能,将存储的数据文件重新整理,删除文件空洞和无效数据,提高数据的组织度,从而提高存储和查询的效率。数据重整功能在 3.0.3.0 版本第一次发布,此后又经过了多次迭代优化,建议使用最新版本。
|
||||||
|
|
|
@ -4,27 +4,27 @@ sidebar_label: taosExplorer
|
||||||
toc_max_heading_level: 4
|
toc_max_heading_level: 4
|
||||||
---
|
---
|
||||||
|
|
||||||
taos-explorer 是一个为用户提供 TDengine 实例的可视化管理交互工具的 web 服务。本节主要讲述其安装和部署。它的各项功能都是基于简单易上手的图形界面,可以直接尝试,如果有需要也可以考高级功能和运维指南中的相关内容。
|
taosExplorer 是一个为用户提供 TDengine 实例的可视化管理交互工具的 web 服务。本节主要讲述其安装和部署。它的各项功能都是基于简单易上手的图形界面,可以直接尝试,如果有需要也可以考高级功能和运维指南中的相关内容。
|
||||||
|
|
||||||
## 安装
|
## 安装
|
||||||
|
|
||||||
taos-explorer 无需单独安装,从 TDengine 3.3.0.0 版本开始,它随着 TDengine Enterprise Server 安装包一起发布,安装完成后,就可以看到 `taos-explorer` 服务。
|
taosEexplorer 无需单独安装,从 TDengine 3.3.0.0 版本开始,它随着 TDengine Enterprise Server 安装包一起发布,安装完成后,就可以看到 `taos-explorer` 服务。
|
||||||
|
|
||||||
## 配置
|
## 配置
|
||||||
|
|
||||||
在启动 Explorer 之前,请确保配置文件中的内容正确。
|
在启动 taosExplorer 之前,请确保配置文件中的内容正确。
|
||||||
|
|
||||||
```TOML
|
```TOML
|
||||||
# Explorer listen port
|
# listen port
|
||||||
port = 6060
|
port = 6060
|
||||||
|
|
||||||
# Explorer listen address for IPv4
|
# listen address for IPv4
|
||||||
addr = "0.0.0.0"
|
addr = "0.0.0.0"
|
||||||
|
|
||||||
# Explorer listen address for IPv4
|
# listen address for IPv4
|
||||||
#ipv6 = "::1"
|
#ipv6 = "::1"
|
||||||
|
|
||||||
# Explorer log level. Possible: error,warn,info,debug,trace
|
# log level. Possible: error,warn,info,debug,trace
|
||||||
log_level = "info"
|
log_level = "info"
|
||||||
|
|
||||||
# taosAdapter address.
|
# taosAdapter address.
|
||||||
|
@ -49,9 +49,9 @@ cors = false
|
||||||
|
|
||||||
说明:
|
说明:
|
||||||
|
|
||||||
- `port`:Explorer 服务绑定的端口。
|
- `port`:taosExplorer 服务绑定的端口。
|
||||||
- `addr`:Explorer 服务绑定的 IPv4 地址,默认为 `0.0.0.0`。如需修改,请配置为 `localhost` 之外的地址以对外提供服务。
|
- `addr`:taosExplorer 服务绑定的 IPv4 地址,默认为 `0.0.0.0`。如需修改,请配置为 `localhost` 之外的地址以对外提供服务。
|
||||||
- `ipv6`:Explorer 服务绑定的 IPv6 地址,默认不绑定 IPv6 地址。
|
- `ipv6`:taosExplorer 服务绑定的 IPv6 地址,默认不绑定 IPv6 地址。
|
||||||
- `log_level`:日志级别,可选值为 "error", "warn", "info", "debug", "trace"。
|
- `log_level`:日志级别,可选值为 "error", "warn", "info", "debug", "trace"。
|
||||||
- `cluster`:TDengine 集群的 taosAdapter 地址。
|
- `cluster`:TDengine 集群的 taosAdapter 地址。
|
||||||
- `x_api`:taosX 的 gRPC 地址。
|
- `x_api`:taosX 的 gRPC 地址。
|
||||||
|
@ -62,7 +62,7 @@ cors = false
|
||||||
|
|
||||||
## 启动停止
|
## 启动停止
|
||||||
|
|
||||||
然后启动 Explorer,可以直接在命令行执行 taos-explorer 或者使用 systemctl 命令:
|
然后启动 taosExplorer,可以直接在命令行执行 taos-explorer 或者使用 systemctl 命令:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
systemctl start taos-explorer # Linux
|
systemctl start taos-explorer # Linux
|
||||||
|
@ -78,7 +78,7 @@ sc.exe stop taos-explorer # Windows
|
||||||
## 问题排查
|
## 问题排查
|
||||||
|
|
||||||
1. 当通过浏览器打开 Explorer 站点遇到“无法访问此网站”的错误信息时,请通过命令行登录 taosExplorer 所在机器,并使用命令 `systemctl status taos-explorer` 检查服务的状态,如果返回的状态是 `inactive`,请使用命令`systemctl start taos-explorer` 启动服务。
|
1. 当通过浏览器打开 Explorer 站点遇到“无法访问此网站”的错误信息时,请通过命令行登录 taosExplorer 所在机器,并使用命令 `systemctl status taos-explorer` 检查服务的状态,如果返回的状态是 `inactive`,请使用命令`systemctl start taos-explorer` 启动服务。
|
||||||
2. 如果需要获取 Explorer 的详细日志,可通过命令 `journalctl -u taos-explorer`。
|
2. 如果需要获取 taosExplorer 的详细日志,可通过命令 `journalctl -u taos-explorer`。
|
||||||
3. 当使用 Nginx 或其他工具进行转发时,注意进行 CORS 设置或在配置文件中使用 `cors = true`。
|
3. 当使用 Nginx 或其他工具进行转发时,注意进行 CORS 设置或在配置文件中使用 `cors = true`。
|
||||||
|
|
||||||
这是一个 Nginx 配置文件 CORS 设置的例子:
|
这是一个 Nginx 配置文件 CORS 设置的例子:
|
||||||
|
|
Before Width: | Height: | Size: 319 KiB After Width: | Height: | Size: 319 KiB |
Before Width: | Height: | Size: 179 KiB After Width: | Height: | Size: 179 KiB |
Before Width: | Height: | Size: 117 KiB After Width: | Height: | Size: 117 KiB |
Before Width: | Height: | Size: 133 KiB After Width: | Height: | Size: 133 KiB |
Before Width: | Height: | Size: 476 KiB After Width: | Height: | Size: 476 KiB |
Before Width: | Height: | Size: 105 KiB After Width: | Height: | Size: 105 KiB |
Before Width: | Height: | Size: 359 KiB After Width: | Height: | Size: 359 KiB |
Before Width: | Height: | Size: 118 KiB After Width: | Height: | Size: 118 KiB |
Before Width: | Height: | Size: 52 KiB After Width: | Height: | Size: 52 KiB |
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 30 KiB |
Before Width: | Height: | Size: 96 KiB After Width: | Height: | Size: 96 KiB |
Before Width: | Height: | Size: 133 KiB After Width: | Height: | Size: 133 KiB |
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
Before Width: | Height: | Size: 163 KiB After Width: | Height: | Size: 163 KiB |
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 25 KiB |
Before Width: | Height: | Size: 192 KiB After Width: | Height: | Size: 192 KiB |
Before Width: | Height: | Size: 46 KiB After Width: | Height: | Size: 46 KiB |
Before Width: | Height: | Size: 232 KiB After Width: | Height: | Size: 232 KiB |
Before Width: | Height: | Size: 5.6 KiB After Width: | Height: | Size: 5.6 KiB |
Before Width: | Height: | Size: 19 KiB After Width: | Height: | Size: 19 KiB |
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
Before Width: | Height: | Size: 75 KiB After Width: | Height: | Size: 75 KiB |
Before Width: | Height: | Size: 72 KiB After Width: | Height: | Size: 72 KiB |
Before Width: | Height: | Size: 231 KiB After Width: | Height: | Size: 231 KiB |
Before Width: | Height: | Size: 40 KiB After Width: | Height: | Size: 40 KiB |
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
Before Width: | Height: | Size: 61 KiB After Width: | Height: | Size: 61 KiB |
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 56 KiB |
Before Width: | Height: | Size: 215 KiB After Width: | Height: | Size: 215 KiB |
Before Width: | Height: | Size: 194 KiB After Width: | Height: | Size: 194 KiB |
Before Width: | Height: | Size: 106 KiB After Width: | Height: | Size: 106 KiB |
Before Width: | Height: | Size: 155 KiB After Width: | Height: | Size: 155 KiB |
Before Width: | Height: | Size: 15 KiB After Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 22 KiB After Width: | Height: | Size: 22 KiB |
Before Width: | Height: | Size: 27 KiB After Width: | Height: | Size: 27 KiB |