如何用 taosgen 编排并运行 TDengine 写入基准测试作业-北京尧图网络

如何用 taosgen 编排并运行 TDengine 写入基准测试作业【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine在评估 TDengine 的写入吞吐量、延迟或稳定性时手动拼 SQL 插入测试数据既慢又难以复现。TDengine 官方文档提供的taosgen工具就是为这类写入性能基准测试设计的它以作业Job为基本单元通过 YAML 配置文件描述建库建表 → 批量建子表 → 并发写入数据的完整流程并支持 DAG 式的作业依赖编排。本文以生成器方式生成数据、STMT 方式写入 TDengine这条最短主路径为例说明如何编排并运行一次写入基准测试作业。适用前提目标 TDengine 集群或单节点已经在正常运行——文档明确提示在运行 taosgen 之前要确保所有待写入的目标 TDengine 集群已在正常运行taosgen 目前支持 Windows、Linux 和 macOS 系统。安装与验证 taosgen根据系统架构下载对应版本的 taosgen 二进制发布包文档给出的下载入口是 taosgen 的 releases 页面解压缩并创建符号链接方便调用。Linux 系统下的文档示例tar zxvf taosgen-v0.8.6-linux-x64.tar.gz cd taosgen ln -sf pwd/taosgen /usr/bin/taosgenln -sf会将taosgen二进制链接到系统执行目录/usr/bin/下通常需要先获得对应目录的写权限之后在任意路径下都可直接执行taosgen。下载的文件名、版本号以 releases 页面实际提供的包为准上面的taosgen-v0.8.6-linux-x64.tar.gz是文档中的示例文件名。安装完成后可先用版本命令确认工具可用-V显示版本信息并退出且不能与其它参数混用taosgen -V编写写入基准测试作业配置taosgen 支持命令行参数和 YAML 配置文件两种方式指定参数相同参数配置下命令行优先级高于配置文件。启动示例taosgen -h 127.0.0.1 -c config.yaml常用命令行参数默认值来自文档参数说明-h/--host要连接的服务器主机名或 IP默认localhost-P/--port服务器端口号默认6030-u/--user连接用户名默认root-p/--password连接密码默认taosdata-c/--config-fileYAML 配置文件路径-d/--log-dir日志输出目录默认./log-o/--log-file完整日志文件路径优先级高于--log-dir-v/--verbose提高输出详细程度作业与步骤的结构配置文件整体分为tdengine、mqtt、kafka、influxdb、schema、concurrency、jobs等部分。与 TDengine 写入基准测试相关的核心是tdengine连接与库属性、schema表结构与数据生成规则和jobs作业编排作业Job有唯一的键名和name显示名needs字段声明依赖的其他作业标识符多个作业可据此组成 DAG 执行流程作业默认继承全局配置。步骤Step由name、uses指向哪个 Action、with传给 Action 的参数组成按顺序执行。TDengine 写入场景用到的内置 Actiontdengine/create-super-table创建超级表tdengine/create-child-table基于超级表批量创建子表with.batch.size控制每批子表数量默认 1000batch.concurrency控制并发批次默认 10tdengine/insert写入数据支持sql、stmt、schemaless三种格式默认stmt参数化写入适合高性能批量写入with.concurrency为并发写入线程数默认 8失败处理通过failure_handling.on_failure控制默认exit失败后退出程序也可设为skip警告并跳过继续执行。完整示例生成器 STMT 写入下面这份配置模拟一万台智能电表每台采集电流、电压、相位三个物理量、每隔 5 分钟产生一条记录经 WebSocket 写入tsbench库的meters超级表示例内容来自 docs/examples/taosgen/taosgen_config.yamltdengine: dsn: taosws://root:taosdata127.0.0.1:6041/tsbench drop_if_exists: true props: precision ms vgroups 4 schema: name: meters tbname: prefix: d count: 10000 from: 0 columns: - name: ts type: timestamp start: 1700000000000 precision : ms step: 300s - name: current type: float min: 0 max: 100 - name: voltage type: int expr: 220 * math.sqrt(2) * math.sin(_i) - name: phase type: float min: 0 max: 360 tags: - name: groupid type: int min: 1 max: 10 - name: location type: binary(24) values: - New York - Los Angeles - Chicago - Houston - Phoenix - Philadelphia - San Antonio - San Diego - Dallas - Austin generation: interlace: 1 rows_per_table: 10000 rows_per_batch: 10000 num_cached_batches: 0 jobs: # TDengine insert job insert: steps: - uses: tdengine/create-super-table - uses: tdengine/create-child-table with: batch: size: 1000 concurrency: 10 - uses: tdengine/insert with: concurrency: 8配置要点均按文档说明tdengine.dsnWebSocket 连接串示例使用默认账号root:taosdata、本机 6041 端口、目标库tsbench。如果你的集群账号密码不同替换 DSN 中对应字段即可。drop_if_exists: true数据库已存在时先删除重建保证基准测试从零开始。注意这是破坏性设置会清掉同名旧库。props: precision ms vgroups 4创建数据库的属性这里设置毫秒精度和 4 个虚拟组vgroup文档示例中还展示过replica 3 keep 3650副本数、数据保留期限等属性写法。schema.tbname生成 d0~d9999 共一万张子表的命名规则。columns中时间列从时间戳17000000000002023-11-14 22:13:20 UTC开始、按 300 秒步长递增current、phase用随机数voltage用 lua 表达式生成正弦波expr中_i为从 0 开始的调用索引。generation交错模式生成数据interlace: 1每张子表 1 万条每批写入请求最大 1 万行num_cached_batches: 0关闭数据预生成缓存。jobs.insert编排了三个步骤先建超级表再以每批 1000 张、10 线程并发创建子表最后 8 线程并发 STMT 写入。简化版配置可选文档指出tdengine、schema::name、schema::tbname、schema::tags、tdengine/create-child-table::batch、tdengine/insert::concurrency都可以使用默认值。只关心每 5 分钟一条、正弦波电压这一数据特征时配置可以缩减为schema: columns: - name: ts type: timestamp start: 1700000000000 precision : ms step: 300s - name: current type: float min: 0 max: 100 - name: voltage type: int expr: 220 * math.sqrt(2) * math.sin(_i) - name: phase type: float min: 0 max: 360 generation: interlace: 1 num_cached_batches: 0 jobs: # TDengine insert job insert: steps: - uses: tdengine/create-super-table - uses: tdengine/create-child-table - uses: tdengine/insert需要控制 vgroups、并发度或每批行数等影响基准测试结论的参数时再回到完整配置显式指定。运行作业并确认执行结果在 TDengine 集群确认运行后执行taosgen -h 127.0.0.1 -c config.yamlconfig.yaml替换为你实际保存配置文件的路径。作业按步骤顺序执行建超级表 → 批量建子表 → 并发写入。执行期间可关注的日志位置日志默认写入log/taosgen.log可通过命令行--log-dir/--log-file或配置文件的log_dir/log_file调整优先级为--log-file命令行--log-dir命令行log_fileYAMLlog_dirYAML 默认值log/taosgen.log。taosgen 对未知或错误配置项会自动检测并提示如果配置里有拼写错误或无效参数启动阶段就会收到提示不必等写入跑完才发现。写入步骤默认on_failure: exit即写入失败时程序直接退出若希望失败后跳过继续可将tdengine/insert的failure_handling.on_failure设为skipmax_retries与retry_interval_ms可控制重试次数和间隔。作业完成后到目标集群核对结果。以文档示例配置为准应能查到tsbench库、meters超级表以及 d0~d9999 共 1 万张子表、每张表 1 万条数据。可以用 taos shell 非交互模式快速确认-s参数执行完 SQL 后退出适合自动化脚本taos -h 127.0.0.1 -s use tsbench; show tables;taos shell 的连接参数默认值为127.0.0.1:6030、账号root、密码taosdata按你集群的实际连接信息调整-h/-P/-u/-p。可选分支与已知限制CSV 数据源写入如果要测从现有数据文件导入这条链路可以改用schema.from_csv指定标签文件和时序数据文件支持单文件、目录或 glob 通配符配合timestamp_index、timestamp_offset等参数控制时间列。文档同时给出了ctb-tags.csv与ctb-data.csv的列格式示例完整示例见 docs/examples/taosgen/taosgen_config.yaml。写入格式tdengine/insert除默认的stmt外还支持sql和schemaless行协议无需预建超级表和子表。对比不同写入路径的性能时只改这一项即可。中断/恢复tdengine/insert的checkpointenabled、interval_sec支持写入中断/恢复但文档注明目前仅支持 stmt 格式、生成器方式数据源。动作名称tdengine/insert-data是 v0.7.x 及更早版本的旧名称v0.8.0 起使用会收到弃用提示v0.8.3 起不再支持请统一使用tdengine/insert。数据类型schema 列定义目前不支持 json、geometry、varbinary、decimal、blob 类型。默认行为提醒不带任何参数运行 taosgen 时会默认创建tsbench库、meters超级表、1 万张子表并各写入 1 万条数据做基准测试前请确认这不是你想要的库名或规模。完整的参数参考schema 各列属性、随机/顺序/表达式三种数据生成方式、time_interval时间间隔策略等见 taosgen 参考手册。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

如何用 taosgen 编排并运行 TDengine 写入基准测试作业

相关推荐

LeGo-LOAM核心解析：mapOptimization.cpp四层架构与GTSAM因子图实战

MOT Challenge评估指标与TrackEval实战全解析

Description

更多资讯

Flotherm XT学习路径与实操指南：从CAD建模到网格求解的工程实践

Rerun 源码编译与调试指南：从环境配置到跑通 Viewer 的完整流程

A2UI v0.8 JSON Schema 全解析：消息协议、组件目录与 LLM 友好的解析式 Schema

MMD模型导入Unity材质丢失解决方案：从PMX到Toon Shader全流程

ArduPilot VTOL QuickTune 自动调参完全指南：基于脚本与源码的多旋翼/垂起固定翼速率增益自动整定

华为OD面试全流程经验：机试、技术面、薪资与转正避坑指南

今日更新

基于高阶循环谱的MPSK载波频率估计与MATLAB实现

MiniPdf方：.NET开源Office转PDF的高效解决方案

Solon AI v3.10：Java全栈智能体开发框架解析

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？