ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

三步装好并跑通 TDengine 时序数据库:Linux 安装配置完整指南

三步装好并跑通 TDengine 时序数据库:Linux 安装配置完整指南 三步装好并跑通 TDengine 时序数据库Linux 安装配置完整指南【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine如果你手边的设备、车辆或产线传感器正在持续吐出带时间戳的数据你需要一款能高效存取这类数据的时序数据库。TDengine 正是为此而生的开源时序数据库为物联网、车联网、工业互联网IIoT等场景做了深度优化。本文以 Linux x64 为例带你走完 TDengine 安装全流程环境自检、安装包落地、服务启动直到第一条查询结果返回。动手前先给环境打个勾安装本身很快卡住你的往往是环境不达标。开始之前对照下面这张清单逐项确认全部打勾再往下走64 位操作系统x64 架构TDengine 的 Linux 主包面向 x64内存 ≥ 2GB如果跑生产负载建议 8GB 起可用磁盘空间 ≥ 10GB时序数据会持续增长提前留足更稳妥发行版支持 systemd例如 Ubuntu 16.04、CentOS 7——后面启动服务全靠它你有sudo权限安装脚本需要 root 身份任何一项不满足先补环境再装库能省掉后面一大圈排查。第一阶段让安装包落地先到 TDengine 官方下载渠道拿到最新的 Linux 安装包文件名形如TDengine-server-3.3.0.0-Linux-x64.tar.gz。把它放到任意有写权限的目录比如~/然后做两件事解压、进目录。# 解压安装包得到同名目录 tar -zxvf TDengine-server-3.3.0.0-Linux-x64.tar.gz # 进入解压出的安装目录 cd TDengine-server-3.3.0.0到此为止你只是准备好了原料真正的安装由下一条命令完成。第二阶段把重活交给 install.sh sudo ./install.sh执行期间脚本会替你干完四件琐碎但容易出错的事建系统用户和组——让服务以独立账号运行而不是裸用 root设置环境变量——保证taos、taosd等命令在任何终端里直接可用注册 systemd 服务——把taosd挂到系统服务管理器上之后启停、开机自启都走systemctl创建数据与日志目录——/var/lib/taos存数据、/var/log/taos存日志后面会反复用到。等脚本跑完并返回提示符安装即完成无需手动编译或配置。第三阶段拉起服务确认它真的活着启动只需一条命令sudo systemctl start taosd但命令没报错不等于服务健康所以紧接着用 status 看一眼sudo systemctl status taosd输出里出现Active: active (running)这一行才算真正启动成功看到inactive或failed直接跳到文末的故障排查一节。冒烟测试四步确认你没白装 ✅服务活着只是及格线。用下面的小闭环把装对了这件事坐实——连接、建库建表、压一把数据、看一眼日志1. 连进去。终端里敲taos进入交互式命令行下称 shell看到taos提示符说明客户端和服务端握手成功。2. 建库建表。在 shell 里执行两条 SQL各以分号结尾CREATE DATABASE demo; -- 建一个测试库 USE demo; CREATE TABLE demo_table (ts TIMESTAMP, val FLOAT); -- 建一张最简单的时间序列表能顺利执行并切到demo库说明元数据链路正常。3. 跑一把压测。退出 shell 后执行taosBenchmark -y它会模拟上万张子表、上亿条记录批量写入普通服务器上十几秒就能跑完。这一步既能感受写入吞吐也顺带验证了大规模写入路径。4. 翻一眼日志。打开/var/log/taos目录下的日志文件确认没有红色错误刷屏。到这里一套可用的 TDengine 就算真正立起来了。日常运维服务管理与工具速查装好之后你最高频的操作就是服务管理四条命令建议直接背下来命令干什么sudo systemctl start taosd启动服务sudo systemctl stop taosd停止服务sudo systemctl restart taosd重启服务sudo systemctl status taosd查看服务状态⚠️ 一个容易忽略的细节执行stop时TDengine 会先把未落盘的数据全部安全写盘再退出。数据量越大这一步耗时越长——停服卡住通常不是死锁而是落盘还没跑完耐心等一下即可。除服务管理外安装包里还有几个值得认识的工具都在/usr/local/taos/bin下taosd服务端主程序所有数据的读写都经它处理taos命令行 shell跑 SQL、查状态的第一现场taosdump数据导入导出工具做备份迁移时用taosBenchmark性能测试工具冒烟测试里出场过taosadapterRESTful 接口服务让 HTTP 客户端也能访问库remove.sh卸载脚本动作不可逆执行前务必想清楚。附录装完之后东西都在哪遇到配置改哪数据存哪这类问题时对照下表即可路径里面是什么/usr/local/taos/bin全部可执行文件taosd、taos、taosdump、taosBenchmark 等/usr/local/taos/driver各语言驱动依赖的动态链接库/usr/local/taos/examplesC 等各语言的使用示例代码/usr/local/taos/includeC 语言接口头文件写客户端程序要 include 它/etc/taos/taos.cfg主配置文件调参基本都改这里/var/lib/taos数据存储目录/var/log/taos日志目录故障排查按现象对号入座 现象一服务起不来status 显示 failed。先排查/var/log/taos/taosdlog.0报错原因通常写得很直白端口占用、目录权限、残留进程。定位后处理对应问题再systemctl restart taosd验证。现象二taos客户端连不上服务端。按顺序确认三件事taosd是否在跑status 看一眼、防火墙是否放行服务端口、客户端与服务端是否同一网络可达。三者排查完仍连不上回到taosdlog找拒绝连接的具体原因。现象三查询慢、写入压上量就吃力。硬件没问题的话大概率是默认参数不匹配你的负载。打开/etc/taos/taos.cfg按实际内存、磁盘和并发情况调整相关项改完重启服务生效。装完之后然后呢用 数据建模 把一张表存所有设备升级为超级表 子表 标签的正确姿势跟着 数据写入 和 数据查询 把真实数据灌进去并聚合分析进阶玩法如流式计算、数据订阅可直接从 快速上手目录 挑章节往下读。更深度的参数调优与生产部署建议以 官方文档 为准——它永远比任何一篇指南更新。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进