与永洪 BI 集成
永洪 BI 是一个专为各种规模企业打造的全业务链大数据分析解决方案，旨在帮助用户轻松发掘大数据价值，获取深入的洞察力。该平台以其灵活性和易用性而广受好评，无论企业规模大小，都能从中受益。
为了实现与 TDengine 的高效集成，永洪 BI 提供了 JDBC 连接器。用户只须按照简单的步骤配置数据源，即可将 TDengine 作为数据源添加到永洪 BI 中。这一过程不仅快速便捷，还能确保数据的准确性和稳定性。
一旦数据源配置完成，永洪 BI 便能直接从 TDengine 中读取数据，并利用其强大的数据处理和分析功能，为用户提供丰富的数据展示、分析和预测能力。这意味着用户无须编写复杂的代码或进行烦琐的数据转换工作，即可轻松获取所需的业务洞察。
前置条件
准备以下环境：
- TDengine 3.3.2.0 以上版本集群已部署并正常运行（企业及社区版均可）。
- taosAdapter 能够正常运行，详细参考 taosAdapter 参考手册。
- 确保永洪 BI 已经安装并运行（如果未安装，请到永洪科技官方下载页面下载）。
- 安装 JDBC 驱动。从 maven.org 下载 TDengine JDBC 连接器文件
taos-jdbcdriver-3.4.0-dist.jar及以上版本。
配置数据源
配置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 数据源。
第 7 步，在永洪 BI 中点击【添加数据源】按钮，展开刚刚创建的数据源，并浏览 TDengine 中的超级表。
第 8 步，可以将超级表的数据全部加载到永洪 BI 中，也可以通过自定义 SQL 导入部分数据。
第 9 步，当勾选【数据库内计算】复选框时，永洪 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 工具的【编辑参数】对话框中修改 “参数” 的数据类型、数据范围、默认取值，并在 “可视化报告” 中动态设置这些参数的值。
制作可视化报告的步骤如下:
- 在永洪 BI 工具中点击【制作报告】，创建画布。
- 拖动可视化组件到画布中，例如 “表格组件 ”。
- 在【数据集】侧边栏中选择待绑定的数据集，将数据列中的 “维度” 和 “度量” 按需绑定到 “表格组件”。
- 点击【保存】后，即可查看报告。
- 更多有关永洪 BI 工具的信息，请查询永洪科技官方帮助文档。
