Skip to main content

可视化管理工具

为方便用户更高效地使用和管理 TDengine,TDengine 3.0 版本推出了一个全新的可视化组件—taosExplorer。这个组件旨在帮助用户在不熟悉 SQL 的情况下,也能轻松管理 TDengine 集群。通过 taosExplorer,用户可以轻松查看 TDengine 的运行状态、浏览数据、配置数据源、实现流计算和数据订阅等功能。此外,用户还可以利用taosExplorer 进行数据的备份、复制和同步操作,以及配置用户的各种访问权限。这些功能极大地简化了数据库的使用过程,提高了用户体验。

本节介绍可视化管理的基本功能。

登录

在完成 TDengine 的安装与启动流程之后,用户便可立即开始使用 taosExplorer。该组件默认监听 TCP 端口 6060,用户只须在浏览器中输入 http://<IP>:6060/login(其中的IP 是用户自己的地址),便可顺利登录。成功登录集群后,用户会发现在左侧的导航栏中各项功能被清晰地划分为不同的模块。接下来将简单介绍主要模块。

运行监控面板

在 Grafana 上安装 TDengine 数据源插件后,即可添加 TDengine 数据源,并导入TDengine 的 Grafana Dashboard: TDengine for 3.x。通过这一操作,用户将能够在不编写任何代码的情况下实现对 TDengine 运行状态的实时监控和告警功能。详情请参考运行监控

编程

通过“编程”页面,可以看到不同编程语言如何与 TDengine 进行交互,实现写入和查询等基本操作。用户通过复制粘贴,即可完成一个示例工程的创建。目前支持的编程语言包括 Java、Go、Python、Node.js(Javascript)、C#、Rust、R 等。

数据写入

通过创建不同的任务,用户能够以零代码的方式,将来自不同外部数据源的数据导入 TDengine。目前,TDengine 支持的数据源包括 AVEVA PI System、OPC-UA/DA、MQTT、Kafka、InfluxDB、OpenTSDB、TDengine 2、TDengine 3、CSV、AVEVA Historian 等。在任务的配置中,用户还可以添加与 ETL 相关的配置。

在任务列表页中,可以实现任务的启动、停止、编辑、删除、查看任务的活动日志等操作。

关于数据写入的详细内容,请参考[数据接入]

数据浏览器

点击功能列表的“数据浏览器”入口,在“数据浏览器”中可以创建和删除数据库、创建和删除超级表和子表,执行SQL语句,查看SQL语句的执行结果。此外,超级管理员还有对数据库的管理权限,其他用户不提供该功能。如下图所示:

explorer-01-explorer-entry.jpeg

创建数据库

下面通过创建数据库,来熟悉数据浏览器页面的功能和操作,接下来看创建数据库的两种方式:

  1. 通过点击图中的 + 号,跳转到创建数据数库页面,点击 创建 按钮,如下图:

第一步 点击 + 号; explorer-02-createDbentry.jpeg

第二步 填写数据库名称、需要的数据库配置参数,配置参数进行了分类和折叠,点击可展开; explorer-03-createDbPage.jpeg explorer-04-createDbPage2.jpeg

弟三步 点击“创建”按钮之后,如下图左边出现数据库名称则创建数据库成功。 explorer-05-createDbtest01.jpeg

  1. 通过在 Sql 编辑器中数据 sql 语句,点击 执行 按钮,如下图:

第一步 输入 sql 语句; explorer-06-sqlCreateDb.jpeg

第二步 点击“执行”按钮,左边出现 test02, 则数据库创建成功。 explorer-07-createDbtest02.jpeg

由于创建、修改和删除超级表、创建表、创建子表在行为上是一致的,就以创建超级表为示例做演示:

创建超级表

第一步 鼠标移动到 STables 上,点击出现的 + 号,出现创建超级表 tab; explorer-08-createStbEntry.jpeg

第二步 填写超级表信息, 点击“创建”按钮; explorer-09-createStbPage.jpeg

第三步 点击 Stables 出现刚才填写的超级表名,则证明创建成功。 explorer-10-createStbSucc.jpeg

查看超级表

鼠标放在需要查看的超级表上,出现如下图所示图标,点击“眼睛图标”查看超级表信息 explorer-11-viewStableEntry.jpeg explorer-12-viewStableInfo.jpeg

修改超级表

鼠标放在需要编辑的超级表上,出现如下图所示图标,点击“编辑图标”修改超级表信息 explorer-13-editStableEntry.jpeg

删除超级表

鼠标放在需要删除的超级表上,出现如下图所示图标,点击“删除图标”删除超级表 explorer-15-delStb.jpeg

Sql 编辑器使用

当输入多条语句,可以鼠标选中需要指执行的语句,也可以对语句进行注释(快捷键 Control-/ Command-/),然后再点击执行即可 explorer-16-sqlEditor.jpeg

Sql 收藏功能使用

鼠标选中窗口中的 SQL,点击收藏按钮,即可对 SQL 进行收藏,并可以填写对该 SQL 语句的描述 explorer-17-favoritesAdd.png

个人收藏中,点击 SQL 的共享按钮,当前 SQL 会被添加到共享收藏中 explorer-18-favoritesAddPublic.png

共享收藏中的 SQL 对所有用户可见 explorer-19-favoritesPublic.png

点击取消共享按钮,可以撤回对此 SQL 的共享 explorer-20-favoritesCancelPublic.png

在搜索栏中可以对 SQL 或描述进行模糊搜索 explorer-21-favoritesSearch.png

点击删除按钮,SQL 将会从个人收藏中删除,如果 SQL 已经共享到共享收藏,那么共享收藏中对应 SQL 也会同步删除

explorer-22-favoritesDelete.png

注意:

  1. 如果欲收藏的 SQL 已经在个人收藏中,则无法重复收藏,该操作会报错但不产生任何后果
  2. 如果欲共享的 SQL 已经被自己或他人共享过,则无法重复共享,该操作会报错但不产生任何后果

explorer-23-favoritesNotes.png

流计算

通过 Explorer, 您可以轻松地完成对流的管理,从而更好地利用 TDengine 提供的流计算能力。 点击左侧导航栏中的“流计算”,即可跳转至流计算配置管理页面。 您可以通过以下两种方式创建流:流计算向导和自定义 SQL 语句。当前,通过流计算向导创建流时,暂不支持分组功能。通过自定义 SQL 创建流时,您需要了解 TDengine 提供的流计算 SQL 语句的语法,并保证其正确性。

stream-01-streamEntry.jpeg

创建流计算 Wizard

stream-02-createStreamEntry.jpeg

第一步 填写创建流计算需要的信息,点击 创建 按钮;

stream-03-createStreamWizard.jpeg stream-04-createStreamWizard.jpeg

第二步 页面出现以下记录,则证明创建成功。 stream-05-createStreamSucc1.jpeg

使用 SQL

第一步 切换到 SQL 页,直接输入创建流计算 sql, 点击 创建 按钮; stream-06-createStreamSql.jpeg

第二步 页面出现以下记录,则证明创建成功。 stream-07-createStreamSucc2.jpeg

数据订阅

通过 Explorer, 您可以轻松地完成对数据订阅的管理,从而更好地利用 TDengine 提供的数据订阅能力。 点击左侧导航栏中的“数据订阅”,即可跳转至数据订阅配置管理页面。 您可以通过以下两种方式创建主题:使用向导和自定义 SQL 语句。通过自定义 SQL 创建主题时,您需要了解 TDengine 提供的数据订阅 SQL 语句的语法,并保证其正确性。

topic-01-dataSubscription.jpeg

添加数据订阅

topic-02-addTopic.jpeg

  1. Wizard 方式

第一步 填写添加新主题需要的信息,点击“创建”按钮; topic-03-addTopicWizard.jpeg

如上图,您可以选择是否 “同步 meta”。如果同步 meta 信息,则可以订阅到 meta 信息,比如增加或者删除超级表。

您需要根据使用场景来选择是否开启,如果您引用 taos 连接器编写业务代码订阅 topic,则不能开启“同步 meta”,只能订阅数据;如果您创建 topic 在 explorer 配置同步任务使用,则可以开启“同步 meta”。

第二步 页面出现以下记录,则证明创建成功。 topic-05-addTopicSucc1.jpeg

  1. Sql 方式

第一步 切换到 SQL 页,直接输入添加新主题 sql, 点击“创建”按钮; topic-06-addTopicSql.jpeg

第二步 页面出现以下记录,则证明创建成功。 topic-07-addTopicsSucc2.jpeg

共享主题

在“共享主题”标签页,在“主题“下拉列表中,选择将要分享的主题; 点击“添加可消费该主题的用户”按钮,然后在“用户名”下拉列表中选择相应的用户,然后点击“新增”,即可将该主题分享给此用户

topic-08-shareTopic.jpeg

查看消费者信息

通过执行下一节“示例代码”所述的“完整实例”,即可消费共享主题 在“消费者”标签页,可查看到消费者的有关信息 topic-10-consumer.jpeg

示例代码

在“示例代码”标签页,在“主题“下拉列表中,选择相应的主题; 选择您熟悉的语言,然后您可以阅读以及使用这部分示例代码用来”创建消费“,”订阅主题“,通过执行 “完整实例”中的程序即可消费共享主题 topic-09-sample.jpeg

工具

通过 “工具” 页面,用户可以了解如下 TDengine 周边工具的使用方法。

  • TDengine CLI。
  • taosBenchmark。
  • taosDump。
  • TDengine 与 BI 工具的集成,例如 Google Data Studio、Power BI、永洪 BI 等。
  • TDengine 与 Grafana、Seeq 的集成。

系统管理

点击功能列表中的“系统管理”入口,可以创建用户、对用户进行访问授权、以及删除用户,还能够对当前所管理的集群中的数据进行备份和恢复,也可以配置一个远程 TDengine 的地址进行数据同步,同时也提供了集群信息和许可证的信息以及代理信息以供查看。系统管理菜单只有 root 用户才有权限看到。

用户管理

点击“系统管理”后,默认会进入“用户”标签页。 在用户列表,可以查看系统中已存在的用户及其创建时间,并可以对用户进行启用、禁用,编辑(包括修改密码,数据库的读写权限等),删除等操作。 management-01-systemEntry.jpeg

第一步 点击用户列表右上方的“+新增”按钮,即可打开“新增用户”对话框,填写新增用户的信息,点击“确定”按钮: management-02-addUser.jpeg

第二步 查看新增的用户 management-03-addUserSucc.jpeg

导入用户/权限

点击 导入按钮,弹出导入用户/权限表单填写信息,点击确定提交表单

  • 服务地址:从指定集群导入(taosAdapter 访问地址,如 http://127.0.0.1:6041)
  • 密码:源集群 root 密码
  • 导入内容:
    • 用户名和密码:(实际包含 sysinfo/super 等用户基本信息)
    • 权限
    • 白名单

management-01-importInfo.jpeg

慢 SQL

点击“系统管理”后,点击“慢 SQL”标签页,可以查看慢 SQL 执行语句日志统计与明细。

  • 慢 SQL 明细:默认展示的是开始执行时间是一天内和执行耗时大于等于10秒的数据 management-01-slowsql.jpeg
  • 慢 SQL 统计:默认展示所有的数据,可根据开始执行时间进行过滤 management-02-slowsql.jpeg