为了能够快速体验 TDengine TSDB 的完整功能推荐您使用 TDengine TSDB-Enterprise. 本节首先介绍如何通过安装包快速安装 TDengine TSDB-Enterprise, 然后介绍如何在 Linux 环境下体验 TDengine TSDB 的写入、查询、可视化管理、与 Grafana 集成和零代码数据写入等功能。如果您希望为 TDengine TSDB 贡献代码或对内部技术实现感兴趣请参考 TDengine TSDB GitHub 主页.安装Linux 系统从列表中下载获得 tar.gz 安装包tdengine-tsdb-enterprise-3.4.0.0-linux-arm64.tar.gz (458.11MB)tdengine-tsdb-enterprise-3.4.0.0-linux-x64.tar.gz (457.84MB)进入到安装包所在目录使用tar解压安装包以 x64 架构为例tar -zxvf tdengine-tsdb-enterprise-3.4.0.0-linux-x64.tar.gz进入到安装包所在目录先解压文件后进入子目录执行其中的 install.sh 安装脚本。sudo ./install.sh4. 如果查看到服务的状态为 Active: active (running) since ..., 则说明服务已经启动成功。Windows 系统1. 从列表中下载获得最新 Windows 安装程序tdengine-tsdb-enterprise-3.4.0.0-windows-x64.exe (311.95MB)2. 运行安装程序根据提示完成 TDengine 的安装。更多类型和版本的安装包请前往 TDengine 产品下载中心 下载。启动Linux 系统完成安装后请在终端执行以下脚本启动所有服务start-all.shTDengine TSDB 的所有组件均使用 systemd 来进行服务管理可以使用以下命令查看服务状态sudo systemctl status taosd sudo systemctl status taosadapter sudo systemctl status taoskeeper sudo systemctl status taos-explorer如果查看到服务的状态为 Active: active (running) since ..., 则说明服务已经启动成功。Windows 系统1. 安装完成后请以管理员身份打开一个 cmd 窗口执行以下脚本启动所有服务C:\TDengine\start-all.bat2. 可以使用以下命令查看服务的状态sc query taosdsc query taosadaptersc query taoskeepersc query taos-explorer3. 如果查看到服务的状态为 RUNNING, 则说明服务已经启动成功。快速体验体验 TDengine TSDB 命令行为便于检查 TDengine 的状态执行数据库Database的各种即席Ad Hoc查询TDengine TSDB 提供一命令行应用程序以下简称为 TDengine TSDB CLItaos。要进入 TDengine 命令行您只要在终端执行taos(Linux/Mac) 或taos.exe(Windows) 即可。TDengine CLI 的提示符号如下taos在 TDengine TSDB CLI 中用户可以通过 SQL 命令来创建/删除数据库、表等并进行数据库Database插入查询操作。在终端中运行的 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 语句外系统管理员还可以从 TDengine TSDB CLI 进行检查系统运行状态、添加删除用户账号等操作。TDengine TSDB CLI 连同应用驱动也可以独立安装在机器上运行更多细节请参考 TDengine TSDB 命令行。体验写入taosBenchmark 是一个专为测试 TDengine 性能而设计的工具它能够全面评估 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 到 10而 location 则设置为 California.Campbell、California.Cupertino 等城市信息。执行该命令后系统将迅速完成 1 亿条记录的写入过程。实际所需时间取决于硬件性能但即便在普通 PC 服务器上这个过程通常也只需要十几秒。taosBenchmark 提供了丰富的选项允许用户自定义测试参数如表的数目、记录条数等。要查看详细的参数列表请在终端中输入如下命令taosBenchmark --help有关 taosBenchmark 的详细使用方法请参考 taosBenchmark 参考手册体验查询使用上述 taosBenchmark 插入数据后可以在 TDengine CLItaos输入查询命令体验查询速度。查询超级表 meters 下的记录总条数SELECT COUNT(*) FROM test.meters;查询 1 亿条记录的平均值、最大值、最小值SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters;查询 location California.SanFrancisco 的记录总条数SELECT COUNT(*) FROM test.meters WHERE location California.SanFrancisco;查询 groupId 10 的所有记录的平均值、最大值、最小值SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters WHERE groupId 10;对表 d1001 按每 10 秒进行平均值、最大值和最小值聚合统计SELECT _wstart, AVG(current), MAX(voltage), MIN(phase) FROM test.d1001 INTERVAL(10s);在上面的查询中使用系统提供的伪列 _wstart 来给出每个窗口的开始时间。体验 taosExplorertaosExplorer 是一个可视化工具使用户可以通过浏览器以直观地方式使用和管理 TDeninge.打开浏览器访问 taosExplorer 的地址默认端口为6060如果您在本地运行 TDengine, 可以直接访问 http://localhost:6060.进入“TDengine 管理系统”页面输入用户名和密码默认为root/taosdata点击“登录”按钮即可登录。登录后您将进入“数据浏览器”页面。在这里您可以查看数据库、超级表、子表等信息并执行 SQL 查询。除此以外在“编程”页面可以查看 TDengine 所支持的各种编程语言包括Java, Go, Python, JavaScript/Node.js, C#, Rust, R 等创建连接的方式所有的示例代码都可以通过“复制/粘贴”一键执行在“工具”页面列举了能够与 TDengine 进行交互的各种工具包括Grafana, Seeq, Looker Studio, PowerBI, 永洪 BI, Superset, Excel, Tableau 等您可以按照页面上提示的步骤快速地创建出可视化报表和仪表盘。提示通过点击 taosExplorer 界面的右上角的 ? 图标无需联网即可方便地查看 TDengine 的官方文档。体验与 Grafana 集成Grafana 是一个流行的开源数据可视化和监控平台TDengine 能够与 Grafana 快速集成搭建数据可视化和监控告警系统整个过程无需任何代码开发。下面将以使用taosBenchmark生成的智能电表数据为例介绍如何使用 Grafana 创建一个展示电流 (current) 波动情况的面板。前置准备请先安装并启动 Grafana, 目前 TDengine 支持 Grafana 7.5 及以上的版本使用以下命令写入测试数据这个命令将在名为 test 的数据库下创建超级表 meters, 这个超级表包含 100 个子表每个子表 1000 条记录记录的开始时间为 1 小时前taosBenchmark --start-timestamp$(date --date1 hours ago %s%3N) \ --time-step1000 --records1000 \ --tables100 --answer-yes安装 Grafana 插件Grafana 与 TDengine 之间的交互需要通过 TDengine Datasource 插件来完成。在 Linux 平台该插件可以通过以下命令一键安装。bash -c $(curl -fsSL https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)其它平台的安装可参考插件 Github 仓库中的安装指南。在安装完成后请重启 Grafana 服务。sudo systemctl restart grafana-server.service创建连接安装插件后请进入 Connections - Add new connection 页面搜索 TDengine, 即可查询到 TDengine Datasource 插件。点击 Add new data source 按钮进入数据源配置页面并完成以下配置TDengine Host: 填写 taosAdapter 的地址和端口号如果是在本地运行可输入 http://localhost:6041TDengine Authentication: 配置 TDengine 数据库的认证方式默认使用用户名、密码的认证方式默认的用户名、密码为root/taosdata填写以上信息后请点击 Save test 按钮如果看到以下消息TDengine Data source is working, 即表示 TDengine 与 Grafana 的连接已创建成功。点击提示消息下方的 building a dashboard 链接就可以创建 Dashboard 了。创建 Dashboard具体步骤如下所示点击 building a dashboard - Add visualization, 并选择刚刚添加的 data source在 Input SQL 文本框输入以下 SQL 语句后点击 Apply 按钮即可查看到平均电流变化情况的曲线图。SELECT _wstart AS ts, avg(voltage) AS voltage, avg(phase) AS phase FROM test.meters WHERE groupid 1 and ts $from AND ts $to interval($interval) fill(null)更多细节请参考与 Grafana 集成。体验零代码数据写入通过 taosX 组件TDengine 支持从各种数据源导入数据到 TDengine 中。taosExplorer 组件提供了一个统一的界面用户通过简单的配置和操作就可以将数据从不同的数据源导入到 TDengine 中。已支持的数据源包括TDengine, PI, OPC, InfluxDB, MQTT, Kafka, CSV, MySQL, PostgreSQL, Oracle, MongoDB 等。如果您期望 TDengine 新增对某个数据源的支持欢迎与我们的支持团队联系。下面以 MQTT 为例介绍如何使用 taosExplorer 创建数据写入任务从 MQTT Broker 中订阅数据并写入到 TDengine 中。配置任务的基本信息打开 taosExplorer点击左侧导航栏中的“数据写入”页面在“数据写入任务”标签页点击“ 新增数据源”按钮即可进入任务配置页面配置 MQTT 任务的基本信息输入任务的名称例如test-mqtt选择任务的类型MQTT选择目标数据库test-mqtt, 如果不存在可以直接点击“ 创建数据库”进行创建配置任务的连接和认证信息MQTT Broker 地址broker.emqx.io, 这里使用的是 EMQ 提供的公共 MQTT 服务器MQTT 端口1883TLS 校验不开启用户名和密码不需要填写因为公共 MQTT 服务器不需要认证配置 MQTT 协议相关的信息MQTT 协议3.1客户端 ID: MQTT 客户端 ID, 以 taosx 为前缀可以随意填写例如tdengine-1234订阅主题及 QoS 配置主题和 QoS 之间必须以::分隔例如tdengine-topic1::0其它配置项使用默认配置即可完成以上配置后请点击“检查连通性”按钮如果按钮下方会展示“数据源可用”即表示连通性检查通过配置 Payload 转换为了简化配置请直接在文本框中输入以下 JSON 格式的示例消息它代表的是北京市 id 为 1 的智能电表的电压、电流、相位值{ id: 1, current: 10.42, phase: 1.38, voltage:200, groupid: 7, location: beijing }TDengine 支持对 MQTT 消息进行解析、提取、过滤后映射至 TDengine 数据库的超级表中在“解析”环节直接点击解析配置行最右侧的预览按钮即可在页面的右侧预览解析结果在“映射”环节可以在当前数据库中选择欲写入 MQTT 消息的超级表如果不存在可点击“创建超级表”按钮点击“创建超级表”按钮按照以下字段、标签信息创建超级表 meters, taosExplorer 会根据 JSON 解析的结果自动填充列名仅需根据示例数据选择匹配的数据类型和字段类型字段或标签即可详见下表数据类型名称说明TIMESTAMPts时间戳INTid字段电表 idDOUBLEcurrent字段电流值DOUBLEphase字段相位值INTvoltage字段电压值INTgroupid标签组 idVARCHAR(128)location标签位置创建并选择超级表后即可点击“提交”按钮查看任务状态任务提交后会自动跳转至数据写入任务的列表页观察任务的状态如果状态切换至“运行中”即可开始消费 MQTT 主题中的数据并写入 TDengine.发送测试数据推荐使用 EMQ 提供 MQTT 客户端工具 MQTTX, 发送测试数据详情可参考MQTTX 快速验证。MQTT Broker 及主题应与以上 MQTT 任务的配置保持一致详情如下所示MQTT Broker 地址broker.emqx.ioMQTT Broker 端口1883MQTT 主题tdengine-topic1示例数据与上方配置“Payload 转换”时填写的示例数据格式保持一致{ id: 1, current: 10.42, phase: 1.38, voltage:200, groupid: 7, location: beijing }查看数据发送测试数据后您可以通过 taosExplorer 查看数据是否成功写入 TDengine在 taosExplorer 中切换至“数据浏览器”页面选择相应的数据库和超级表执行 SQL 查询查看数据是否存在例如SELECT * FROM test-mqtt.meters;如果有数据返回说明数据已从 MQTT 主题成功写入到 TDengine 中。在“数据写入”任务列表中您还可以当前任务的运行状态、数据写入速率、错误信息等。下一步在完成上述快速体验后您可以进一步探索 TDengine 的更多功能和特性。