用安装包快速体验 TDengine TSDB从下载安装、服务启动到写入查询的完整实战【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine本文面向希望在本地快速搭建 TDengine 时序数据库TSDB进行功能体验的开发者围绕官方安装包方式展开从环境准备、Linux/Windows 两种平台的下载安装到使用start-all.sh/start-all.bat启动服务、通过taos命令行执行 SQL、借助taosBenchmark写入 1 亿条测试数据并完成聚合查询。读完本文你将掌握基于安装包完成 TDengine 全流程上手的能力并为后续数据建模、流式计算等进阶章节打下基础。本文对应仓库文档用安装包快速体验 及其快速体验部分 resource/_get_started.mdx并以仓库中的安装脚本 packaging/tools/install.sh、systemd 服务单元 packaging/cfg/taosd.service 为源码级依据展开。安装前的环境准备动手安装前请先确认以下三项准备是否完成操作系统与最低配置选择要安装 TDengine 的操作系统环境并确认机器满足最低要求。不同平台的详细支持情况见 支持的平台资源规划与系统要求见 系统要求部署规划。权限要求Linux 环境需要具备sudo权限Windows 环境需要使用管理员权限运行相关命令。仅 Windows安装程序会检查 Microsoft Visual C Redistributable 2015-2022 x64 14.44 或更高版本。若缺失或版本过旧确认提示后可由安装程序自动安装自带的 14.50.35719.0 运行库无需手工处理。下载并安装 TDengine 安装包安装包分为 Linux 通用平台tar.gz与 Windows安装程序两类分别说明如下。Linux解压 tar.gz 并执行 install.sh从官方下载中心选择 TDengine TSDB-Enterprise 的 Linux-Generic 平台安装包。进入安装包所在目录使用tar解压以 x64 架构为例tar -zxvf tdengine-tsdb-enterprise-{{VERSION}}-linux-x64.tar.gz进入解压后的目录执行安装脚本sudo ./install.sh从安装脚本 packaging/tools/install.sh 的源码看install.sh还支持若干可选参数便于无人值守或自定义安装参数说明-h显示帮助信息-v [server \| client]安装类型server默认含全部服务或client仅安装客户端工具不含服务-e [yes \| no]是否交互式设置 FQDNno表示跳过交互-d [install dir]自定义安装目录脚本会在其后自动追加taos子目录-s静默模式安装同时将 FQDN 交互置为no脚本会依据系统发行版Ubuntu/Debian/Kylin 等走 deb 系、CentOS/Fedora 走 rpm 系自动选择服务管理方式优先使用 systemd其次回退到service/chkconfig/insserv/update-rc.d。安装时若检测到已有 TDengine 服务会询问是否继续默认按升级处理并保留原安装目录。默认安装路径root 用户、systemd 环境下如下实际以安装过程提示为准安装目录/usr/local/taos数据目录/var/lib/taos日志目录/var/log/taos配置文件目录/etc/taossystemd 服务单元/etc/systemd/system此外脚本支持非 root 用户安装需要 systemd 232此时默认安装到$HOME/taos并将bin目录加入用户的PATH、lib目录加入LD_LIBRARY_PATH。安装过程中还会引导设置 FQDN主机名或本机 IP不能为localhost并自动写入/etc/hosts该值将写入 packaging/cfg/taos.cfg 对应的fqdn配置项是集群节点间通信的关键标识。Windows运行安装程序从官方下载中心下载最新的 Windows 安装程序。以管理员身份运行安装程序根据提示完成安装。默认安装目录为C:\TDengine。Windows 安装目录有两个需要注意的规则你可以自定义安装根目录如果所选路径未以TDengine结尾安装程序会自动在其下创建TDengine目录。例如选择D:\apps后实际安装目录为D:\apps\TDengine而直接选择D:\apps\TDengine时不会重复创建目录。升级安装会继续使用已有安装目录且不能更改该目录。安装完成后程序会将实际安装目录添加到PATH环境变量因此后续taos、taosBenchmark等命令可在任意 cmd 窗口中直接使用。更多类型和版本的安装包可前往 TDengine 产品下载中心选择对应产品线如 TDengine TSDB-Enterprise与平台下载。启动服务TDengine 的所有组件均以系统服务方式统一管理安装完成后即可启动。Linuxstart-all.sh 与 systemctl在终端执行以下脚本启动全部服务sudo start-all.sh从 packaging/tools/install.sh 的源码可以看到安装脚本会把start-all.sh、stop-all.sh等工具一并安装到bin目录并针对不同版本edge/cluster、full/lite注册对应的服务集合。默认完整安装会注册的服务包括taosd时序数据库核心服务、taosadapterRESTful/接入适配服务、taoskeeper监控告警服务、taos-explorer可视化界面服务集群版还包括taosx数据同步工具。TDengine 的所有组件均使用 systemd 进行服务管理可用以下命令逐一查看服务状态sudo systemctl status taosd sudo systemctl status taosadapter sudo systemctl status taoskeeper sudo systemctl status taos-explorer如果输出中包含Active: active (running) since ...说明对应服务已启动成功。以核心服务为例其 systemd 单元 packaging/cfg/taosd.service 的关键配置体现了对时序数据库运行的专门调优LimitNOFILE1048576放开单进程文件描述符上限支撑海量数据文件与连接Restartalways与StartLimitBurst3/StartLimitInterval900s异常退出自动拉起并限制短时间内的重启风暴OOMScoreAdjust-100降低核心服务被 OOM Killer 优先回收的概率TimeoutStopSec1000000s为数据落盘与正常退出预留充足时间。Windowsstart-all.bat 与 sc query安装程序会将实际安装目录加入PATH。安装完成后以管理员身份重新打开 cmd 窗口进入实际安装目录即可用start-all.bat统一管理服务。无参数时默认执行启动同时支持status和stop两个子命令。启动所有服务start-all.bat如果只需启动服务并跳过连通性检查以及 Snode 和 Xnode 初始化可使用-S参数start-all.bat -S查看服务状态start-all.bat status停止所有服务start-all.bat stop如需分别查看各个 Windows Service 的原始状态可使用sc query taosd sc query taosadapter sc query taosx sc query taoskeeper sc query taos-explorer如果start-all.bat status显示服务状态为running或者sc query输出中包含RUNNING则说明对应服务已经启动成功。打开命令行taos shellTDengine 提供命令行工具taos shell即taos可用于检查服务状态、执行 SQL、管理数据库和表。进入 shell 后可以直接体验写入和查询功能。在 Linux 或 macOS 终端中执行taos在 Windows 中执行taos.exe进入 shell 后提示符为taos在 shell 中SQL 语句必须以分号;结尾。下面的示例会创建数据库、写入两条数据并查询结果CREATE DATABASE demo; USE demo; CREATE TABLE t (ts TIMESTAMP, speed INT); INSERT INTO t VALUES (2019-07-15 00:00:00, 10); INSERT INTO t VALUES (2019-07-15 01:00:00, 20); SELECT * FROM t; ts | speed | 2019-07-15 00:00:00.000 | 10 | 2019-07-15 01:00:00.000 | 20 | Query OK, 2 row(s) in set (0.003128s)除执行 SQL 外你还可以通过 shell 检查系统运行状态、管理用户账号等。shell 和应用驱动也可以独立安装在其他机器上运行详情可参考 TDengine 命令行工具 taos。写入测试数据taosBenchmarktaosBenchmark是 TDengine 提供的测试工具可用于快速生成测试数据并体验写入、查询和订阅等功能。它可以模拟大量设备产生的数据支持配置数据库、超级表、标签列、数据列、子表数量、每张子表的数据量、写入间隔、工作线程数量以及是否写入乱序数据等参数。确认 TDengine 服务已经启动后在终端中执行下面的命令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 到 10location为California.Campbell、California.Cupertino等城市信息。该命令共写入1 亿条记录。实际耗时取决于硬件性能即使在普通 PC 服务器上这个过程通常也只需要十几秒。taosBenchmark提供了丰富的参数可用于自定义表数量、记录条数等测试配置。执行下面的命令可以查看完整参数列表taosBenchmark --help关于taosBenchmark的详细使用方法可参考 taosBenchmark 参考手册。查询测试数据使用taosBenchmark写入数据后可以在 shell 中执行下面的查询体验 TDengine 在亿级数据规模下的查询能力。1. 查询超级表meters下的记录总条数SELECT COUNT(*) FROM test.meters; count(*) | 100000000 | Query OK, 1 row(s) in set (0.075247s)2. 查询 1 亿条记录的平均值、最大值和最小值SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters; avg(current) | max(voltage) | min(phase) | 10.2084751316071 | 258 | 145 | Query OK, 1 row(s) in set (0.094037s)3. 按标签过滤查询location California.SanFrancisco的记录总条数SELECT COUNT(*) FROM test.meters WHERE location California.SanFrancisco; count(*) | 10340000 | Query OK, 1 row(s) in set (0.050540s)4. 按标签过滤查询groupId 10的所有记录的平均值、最大值和最小值SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters WHERE groupId 10; avg(current) | max(voltage) | min(phase) | 10.2084751316071 | 258 | 145 | Query OK, 1 row(s) in set (0.033754s)5. 对表d1001按每 10 秒进行平均值、最大值和最小值聚合统计时间窗口查询SELECT _wstart, AVG(current), MAX(voltage), MIN(phase) FROM test.d1001 INTERVAL(10s); _wstart | avg(current) | max(voltage) | min(phase) | 2017-07-14 10:40:00.000 | 10.2084751316071 | 258 | 145 | Query OK, 1 row(s) in set (0.004716s)在上面的查询中系统伪列_wstart表示每个时间窗口的开始时间是时间窗口聚合查询的常用辅助列。进阶体验与下一步完成以上内容后你可以沿着快速入门系列继续深入以下主题基本概念数据建模数据写入数据查询数据订阅流式计算可视化管理Grafana 集成零代码数据写入此外如果你的环境不便使用安装包还可以参考 使用 Docker 快速体验 或 使用云服务 两种替代方式。完成上述快速体验后即可进一步了解 TDengine 的数据建模、写入、查询、数据订阅和流式计算等核心能力。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考