与永洪 BI 的集成
永洪 BI 是一个专为各种规模企业打造的全业务链大数据分析解决方案，旨在帮助用户轻松发掘大数据价值，获取深入的洞察力。该平台以其灵活性和易用性而广受好评，无论企业规模大小，都能从中受益。
为了实现与 TDengine 的高效集成，永洪 BI 提供了 JDBC 连接器。用户只须按照简单的步骤配置数据源，即可将 TDengine 作为数据源添加到永洪BI中。这一过程不仅快速便捷，还能确保数据的准确性和稳定性。
一旦数据源配置完成，永洪BI便能直接从TDengine中读取数据，并利用其强大的数据处理和分析功能，为用户提供丰富的数据展示、分析和预测能力。这意味着用户无须编写复杂的代码或进行烦琐的数据转换工作，即可轻松获取所需的业务洞察。
安装永洪 BI
确保永洪 BI 已经安装并运行（如果未安装，请到永洪科技官方下载页面下载）。
安装JDBC驱动
从 maven.org 下载 TDengine JDBC 连接器文件 “taos-jdbcdriver-3.2.7-dist.jar”，并安装在永洪 BI 的机器上。
配置JDBC数据源
配置JDBC数据源的步骤如下。
第1步，在打开的永洪BI中点击“添加数据源”按钮，选择SQL数据源中的“GENERIC”类型。 第2步，点击“选择自定义驱动”按钮，在“驱动管理”对话框中点击“驱动列表”旁边的“+”，输入名称“MyTDengine”。然后点击“上传文件”按钮，上传刚刚下载的TDengine JDBC连接器文件“taos-jdbcdriver-3.2.7-dist.jar”，并选择“com.taosdata.jdbc. rs.RestfulDriver”驱动，最后点击“确定”按钮，完成驱动添加步骤。 第3步，复制下面的内容到“URL”字段。
jdbc:TAOS-RS://127.0.0.1:6041?user=root&password=taosdata
第4步，在“认证方式”中点击“无身份认证”单选按钮。 第5步，在数据源的高级设置中修改“Quote 符号”的值为反引号（`）。 第6步，点击“测试连接”按钮，弹出“测试成功”对话框。点击“保存”按钮，输入“MyTDengine”来保存TDengine数据源。
创建TDengine数据集
创建TDengine数据集的步骤如下。
第1步，在永洪BI中点击“添加数据源”按钮，展开刚刚创建的数据源，并浏览TDengine中的超级表。 第2步，可以将超级表的数据全部加载到永洪BI中，也可以通过自定义SQL导入部分数据。 第3步，当勾选“数据库内计算”复选框时，永洪BI将不再缓存TDengine的时序数据，并在处理查询时将SQL请求发送给TDengine直接处理。
当导入数据后，永洪BI会自动将数值类型设置为“度量”列，将文本类型设置为“维度”列。而在TDengine的超级表中，由于将普通列作为数据的度量，将标签列作为数据的维度，因此用户可能需要在创建数据集时更改部分列的属性。TDengine在支持标准SQL的基础之上还提供了一系列满足时序业务场景需求的特色查询语法，例如数据切分查询、窗口切分查询等，具体操作步骤请参阅TDengine的官方文档。通过使用这些特色查询，当永洪BI将SQL查询发送到TDengine时，可以大大提高数据访问速度，减少网络传输带宽。
在永洪BI中，你可以创建“参数”并在SQL中使用，通过手动、定时的方式动态执行这些SQL，即可实现可视化报告的刷新效果。如下SQL可以从TDengine实时读取数据。
select _wstart ws, count(*) cnt from supertable where tbname=?{metric} and ts = ?{from} and ts < ?{to} interval(?{interval})
其中：
_wstart：表示时间窗口起始时间。count（*）：表示时间窗口内的聚合值。?{interval}：表示在 SQL 语句中引入名称为interval的参数，当 BI 工具查询数据时，会给interval参数赋值，如果取值为 1m，则表示按照 1 分钟的时间窗口降采 样数据。?{metric}：该参数用来指定查询的数据表名称，当在 BI 工具中把某个“下拉参数组件”的 ID 也设置为 metric 时，该“下拉参数组件”的被选择项将会和该参数绑定在一起，实现动态选择的效果。?{from}和？{to}：这两个参数用来表示查询数据集的时间范围，可以与“文本参数组件”绑定。 您可以在 BI 工具的“编辑参数”对话框中修改“参数”的数据类型、数据范围、默认取值，并在“可视化报告”中动态设置这些参数的值。
21.4.5 制作可视化报告
制作可视化报告的步骤如下。
- 在永洪 BI 工具中点击“制作报告”，创建画布。
- 拖动可视化组件到画布中，例如“表格组件”。
- 在“数据集”侧边栏中选择待绑定的数据集，将数据列中的“维度”和“度量”按需绑定到“表格组件”。
- 点击“保存”后，即可查看报告。
- 更多有关永洪 BI 工具的信息，请查询永洪科技官方帮助文档。
