taosExplorer 快速上手指南：把 TDengine 的日常运维搬进浏览器
【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine
凌晨两点，机房里一台电表集群的节点告了。你不想再 SSH 进去敲一串 shell 命令，而是希望打开浏览器就能登录集群、查慢 SQL、看备份状态、顺手把流计算任务暂停一下——这正是 taosExplorer 想解决的问题。taosExplorer 是 TDengine 随安装包自带的 Web 可视化管理组件，用图形界面完成数据库浏览、SQL 执行、数据接入、流计算、数据订阅和集群运维，特别适合不熟悉命令行的新手，也适合 DBA 做日常巡检。下面按"接上集群 → 查数据 → 灌数据 → 做计算 → 订阅变更 → 盯着监控"的实际干活顺序带你走一遍。
5 分钟完成首次登录：记住 taosExplorer 登录端口 6060
启动 TDengine 并确认 taos-explorer 服务在运行后，直接打开浏览器：
- 访问
http://<服务器IP>:6060（本机就是http://localhost:6060） - 用 TDengine 的账号密码登录，默认是
root/taosdata，也可以用自己创建的、带相应权限的账户 - 登录后默认落在"数据浏览器"页面，左侧导航栏列出各功能模块
远程访问打不开时，先查防火墙或云安全组有没有放通6060端口；如果是 Docker 部署，确认端口映射写没写6060。注意浏览器建议用 Chrome 79 及以上版本，旧版本界面可能错乱。
在数据浏览器里摸清库表结构
日常查数，八成时间花在这里。左侧树状结构就是整个实例的对象层级：
- 数据库：可以图形化创建、删除，也可以直接改参数，比如缓存大小（
cachesize，影响查询性能）和数据保留时长（days，超期数据自动清理）。改参数前想清楚：缓存调大省查询开销但吃内存，保留期调短省磁盘但丢历史数据 - 超级表（Super Table，TDengine 用来管理一组结构相同子表的模板表）：支持创建、修改、删除。建议先用向导式的建表页面填字段和标签，比手写 SQL 少出错
- 子表：挂在超级表下面，可以查看表结构、标签值和部分数据
用内置 SQL 编辑器查数、存 SQL
图形化界面之外，taosExplorer 的 SQL 编辑器才是高频入口，几个小功能值得用起来：
- 语法高亮：写多行 SQL 时不费劲，关键字和字符串颜色分明
- 多语句执行：可以框选部分语句单独执行，不必整页重跑——调试长脚本时特别省事
- 执行历史：最近跑过的 SQL 都有记录，忘了上一条写什么直接翻
- SQL 收藏：常用查询可存为个人收藏，也能设成共享收藏让团队成员复用；收藏支持搜索，收藏多了也能找到
顺手收藏两条常用查询试试：
-- 看某张子表最近的 10 条数据 SELECT tbname, ts, current, voltage FROM test.meters WHERE tbname = 'd1' ORDER BY ts DESC LIMIT 10;从 CSV、Kafka、OPC-UA 到 TDengine 的数据导入
taosExplorer 的"数据写入"模块解决的是"数据怎么进来"的问题。支持的数据源覆盖面很广：
- 时序数据库：InfluxDB、OpenTSDB、TDengine 2.x/3.x（老集群迁移场景）
- 工业协议：OPC-UA/DA、AVEVA PI System
- 消息队列：Kafka、MQTT
- 文件：CSV
配一个导入任务，核心就三步：
- 选数据源类型并填连接信息，点连接测试——测试通过再往下走，连不上时页面会给出失败原因，多数是地址或版本选错
- 配置字段映射：源字段对到目标表的列、过滤条件、时间戳转换（比如把 10 位秒级时间戳转成毫秒级）
- 保存任务后启动，之后可随时停止、查看执行日志和任务性能
CSV 这类文件导入更直观，官方有专门的零代码接入文档可对照操作：docs/zh/08-data-ingest-and-delivery/01-no-code-ingestion/11-csv.md。
图形化创建流计算任务：taosExplorer 流计算
流计算（Stream，把实时数据按窗口聚合成统计结果并写入目标表的持续任务）在 taosExplorer 里有两种创建姿势：
- 向导模式：选数据源表、设时间窗口、挑聚合函数（求平均、求和、计数等）、指定结果表，全程点选，适合不想写 SQL 的场景
- SQL 模式：直接写
CREATE STREAM语句，窗口、分区、触发条件都更灵活
创建成功后，任务列表里可以查看执行状态、启动/暂停、修改配置。窗口大小是个关键参数：窗口太小算得多写得多，太大统计结果不够实时——先按业务粒度定窗口，再根据写入量微调。
taosExplorer 数据订阅配置：把数据变更"推"出去
如果下游系统需要实时感知库里的数据变化（比如同步到另一套系统），用"数据订阅"：
- 创建主题（Topic，订阅数据变更的通道）：向导模式填几个选项就行；复杂条件走 SQL 模式
- 共享主题：可以把主题共享给其他用户并设置访问权限，跨团队消费同一份变更流
- 消费者管理：查看当前活跃消费者、监控消费进度，卡住了能立刻发现
- 消费示例：页面内置多种语言的消费代码示例，复制改改就能跑，省去从零写消费逻辑
订阅功能在快速上手章节还有更细的介绍：docs/zh/04-quick-start/06-data-subscription.md。
用 Grafana 数据源搭集群监控面板
taosExplorer 集成了 Grafana 监控能力，把集群健康度变成一眼能看懂的曲线：
- 在 Grafana 中安装 TDengine 数据源插件并配置指向 taosAdapter（默认地址
http://localhost:6041） - 导入预置的 Dashboard 模板，CPU 使用率、内存占用、磁盘 I/O、查询延迟这些关键指标直接就有
- 在 Grafana 里配置告警规则，指标越线时自动通知
Grafana 集成的完整步骤在官方文档里有图文版：docs/zh/04-quick-start/09-grafana-integration.md。
系统管理：用户、备份与许可证
系统管理模块是 DBA 的地盘：
- 用户与权限：创建/删除用户、给账户授予数据库级权限、启用或禁用账户。人离职了就禁用而不是立刻删，审计留痕
- 数据备份与恢复：支持全量备份和增量备份，恢复时按备份点操作
- 集群状态：查看各节点健康状态和资源使用情况
- 许可证：查看当前授权信息
- 慢 SQL 分析：定位跑得慢的查询，是性能优化的第一手材料
三条排障思路：连接、权限、性能
遇到问题先对号入座：
- 连不上：浏览器打不开 6060 → 先查 taosAdapter 服务状态和网络连通性；Docker/云环境再查端口映射和安全组
- 权限不足：登录成功但看不到对象或操作被拒 → 确认该账户是否被授予对应数据库权限，顺带检查白名单/访问控制设置
- 性能变差：先打开慢 SQL 分析找瓶颈查询，再看集群监控里的 CPU、内存、磁盘指标，判断是查询写法问题还是资源不够
taosExplorer 的详细配置（端口、taosAdapter 地址、Grafana 集成等参数）可查参考手册：docs/zh/12-operations-and-tooling/03-components/04-explorer.md。
上手自查清单：把经验变成习惯
最后给一份可以贴在工位上的检查项：
- 建超级表前，先定好标签字段（设备 ID、位置这类维度），指标放普通列——标签设计好坏决定后面能不能高效地"按设备分组查"
- 数据库参数按数据特点配：写入量大的库缩短保留期，查询密集的库加大缓存
- 流计算窗口跟着业务节奏走，别为了"看起来实时"把窗口切得太碎
- 每周花十分钟翻一次慢 SQL，高频慢查询改写掉，比扩容划算
- 权限走最小化：只给每个账户它需要的库、需要的操作
- 备份别只备份不演练——恢复流程没人真跑过，等于没有
taosExplorer 把"登录、查数、灌数、计算、订阅、监控、备份"这条链路收进了一个浏览器页面，配合 docs/zh/04-quick-start/08-visual-management.md 的可视化管理章节继续深入，基本能覆盖日常 90% 的运维动作。剩下的 10%，交给命令行。
【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
