Windows 安装 TDengine 图形化管理工具教程

本教程介绍三种在 Windows 上管理 CentOS 服务器上 TDengine 数据库的图形化工具方案

---

方案对比

方案	优点	缺点	推荐度
TDengineGUI	免费开源、轻量级、免安装客户端	功能相对简单	⭐⭐⭐⭐⭐
taosExplorer	功能全面、官方自带、Web访问	需服务器开放端口	⭐⭐⭐⭐
DBeaver	功能强大、支持多数据库	需安装客户端和驱动	⭐⭐⭐

---

方案一：TDengineGUI（推荐）

TDengineGUI 是一款基于 Electron 构建的免费开源桌面管理工具，通过 RESTful API 连接，无需安装 TDengine 客户端。

1.1 下载安装

下载地址：

• GitHub: https://github.com/arielyang/TDengineGUI/releases
• 国内镜像: https://gitcode.com/gh_mirrors/tde/TDengineGUI
• Gitee: https://gitee.com/skyebaobao/TDengineGUI

下载步骤：

1. 访问 GitHub Releases 页面
2. 下载最新版本的 TDengineGUI Setup x.x.x.exe 文件
3. 双击安装程序，按提示完成安装

1.2 连接数据库

安装完成后启动 TDengineGUI：

步骤一：新建连接

点击「新建连接」按钮，填写连接信息：

字段	值	说明
IP 地址	192.168.10.26	CentOS 服务器 IP
端口	6041	REST API 默认端口
用户名	root	默认用户名
密码	taosdata	默认密码

步骤二：测试连接

点击「连接」按钮，如果成功会在左侧显示服务器列表和数据库列表。

1.3 主要功能

• ✅ 数据库创建/删除
• ✅ 查看超级表和普通表
• ✅ 数据浏览（分页、时间过滤、排序）
• ✅ SQL 控制台执行
• ✅ 查看数据库属性

1.4 使用示例

创建数据库：

1. 点击服务器连接旁的「+」图标
2. 输入数据库名称，配置参数（KEEP、PRECISION 等）
3. 点击「创建」

执行 SQL：

1. 选择目标数据库
2. 切换到「控制台」标签页
3. 输入 SQL 语句，点击执行

查询数据：

1. 点击左侧表名
2. 右侧显示数据，支持：
   • 时间范围筛选
   • 字段过滤
   • 排序
   • 分页

---

方案二：taosExplorer（官方 Web 界面）

taosExplorer 是 TDengine 3.3.0+ 自带的 Web 管理界面，功能最全面。

2.1 服务器端配置

在 CentOS 服务器上执行：

# 检查 taosExplorer 服务状态
systemctl status taos-explorer

# 如果未启动，启动服务
systemctl start taos-explorer
systemctl enable taos-explorer

# 开放防火墙端口
firewall-cmd --zone=public --add-port=6060/tcp --permanent
firewall-cmd --reload

2.2 跳过注册（可选）

TDengine 3.3.7.1+ 版本支持跳过手机注册：

# 创建环境变量文件
echo 'EXPLORER_SKIP_REGISTER=true' > /etc/default/taos-explorer

# 重启服务
systemctl restart taos-explorer

2.3 Windows 访问

在 Windows 浏览器中访问：

http://192.168.10.26:6060

登录信息：

• 用户名：root
• 密码：taosdata

2.4 主要功能

功能模块	说明
数据浏览器	创建/删除数据库、表，执行 SQL
流计算	创建和管理流计算任务
数据订阅	创建和管理订阅主题
系统管理	用户管理、权限配置、备份恢复
编程	查看各语言连接示例代码

2.5 常见问题

问题：无法访问 6060 端口

检查步骤：

# 1. 确认服务运行
systemctl status taos-explorer

# 2. 确认端口监听
netstat -tlnp | grep 6060

# 3. 检查防火墙
firewall-cmd --list-ports

# 4. 临时关闭防火墙测试
systemctl stop firewalld

问题：需要手机注册

使用跳过注册方法，或确保服务器可访问外网完成注册后，将 /etc/taos/explorer-register.cfg 复制到内网环境。

---

方案三：DBeaver（通用数据库工具）

DBeaver 是一款强大的通用数据库管理工具，支持通过 JDBC 连接 TDengine。

3.1 安装 DBeaver

下载地址：https://dbeaver.io/download/

1. 下载 Windows 64 位安装包
2. 双击安装，按提示完成

3.2 下载 TDengine JDBC 驱动

下载地址：

• Maven: https://repo1.maven.org/maven2/com/taosdata/jdbc/taos-jdbcdriver/
• 选择最新版本，下载 taos-jdbcdriver-x.x.x-dist.jar

3.3 配置驱动

1. 打开 DBeaver
2. 点击「数据库」→「驱动管理器」
3. 点击「新建」按钮

驱动配置：

字段	值
驱动名称	TDengine
类名	com.taosdata.jdbc.rs.RestfulDriver
URL 模板	jdbc:TAOS-RS://{host}:{port}/{database}
默认端口	6041
默认用户	root

4. 切换到「库」标签页
5. 点击「添加文件」，选择下载的 taos-jdbcdriver-x.x.x-dist.jar
6. 点击「找到类」，选择 com.taosdata.jdbc.rs.RestfulDriver
7. 点击「确定」保存

3.4 创建连接

1. 点击「新建数据库连接」
2. 搜索「TDengine」
3. 填写连接信息：

字段	值
主机	192.168.10.26
端口	6041
数据库	bridge_monitor_ts（或留空）
用户名	root
密码	taosdata

4. 点击「测试连接」，成功后点击「完成」

3.5 使用说明

• 左侧显示数据库和表结构
• 右键表 →「查看数据」浏览数据
• 右键数据库 →「SQL 编辑器」执行 SQL
• 支持 SQL 高亮、自动补全、结果导出等

---

常用 SQL 速查

连接成功后，可以在任一工具中执行以下常用操作：

-- 查看所有数据库
SHOW DATABASES;

-- 切换数据库
USE bridge_monitor_ts;

-- 查看所有超级表
SHOW STABLES;

-- 查看所有表
SHOW TABLES;

-- 查看超级表结构
DESCRIBE sensor_data;

-- 查询最新数据
SELECT * FROM sensor_data ORDER BY ts DESC LIMIT 100;

-- 查询特定测点数据
SELECT * FROM sensor_data 
WHERE sid = 170 AND point_code = '187' 
ORDER BY ts DESC LIMIT 50;

-- 时间范围查询
SELECT * FROM sensor_data 
WHERE ts >= '2026-04-08 00:00:00' 
  AND ts < '2026-04-08 23:59:59'
ORDER BY ts ASC;

-- 聚合查询（按小时统计）
SELECT 
    _wstart AS time,
    COUNT(*) AS count,
    AVG(avg) AS avg_value,
    MAX(max) AS max_value,
    MIN(min) AS min_value
FROM sensor_data
WHERE sid = 170
INTERVAL(1h);

-- 查看告警记录
SELECT * FROM alert_records 
WHERE status = 0 
ORDER BY ts DESC 
LIMIT 20;

---

总结

需求	推荐方案
快速查看数据、简单操作	TDengineGUI
完整功能管理、流计算配置	taosExplorer
复杂 SQL 开发、数据导出	DBeaver
同时管理多种数据库	DBeaver

推荐组合：日常使用 TDengineGUI（轻量快捷），复杂操作用 taosExplorer（功能全面）。