diff --git a/docs/en/10-third-party/05-bi/11-superset.md b/docs/en/10-third-party/05-bi/11-superset.md index 96014a4e2a..2d51e9b715 100644 --- a/docs/en/10-third-party/05-bi/11-superset.md +++ b/docs/en/10-third-party/05-bi/11-superset.md @@ -10,12 +10,15 @@ Apache Superset provides an intuitive user interface that makes creating, sharin Through the Python connector of TDengine, Superset can support TDengine data sources and provide functions such as data presentation and analysis ## Install Apache Superset + Ensure that Apache Superset v2.1.0 or above is installed. If not, please visit [official website](https://superset.apache.org/)to install ## Install TDengine + Both TDengine Enterprise Edition and Community Edition are supported, with version requirements of 3.0 or higher ## Install TDengine Python Connector + The Python connector of TDengine comes with a connection driver that supports Superset in versions 2.1.17 and later, which will be automatically installed in the Superset directory and provide data source services The connection uses the WebSocket protocol, so it is necessary to install the taos ws py component of TDengine separately. The complete installation script is as follows: ```bash @@ -24,6 +27,7 @@ pip3 install taos-ws-py ``` ## Configure TDengine Connection In Superset + Step 1, enter the new database connection page Superset -> Setting-> Database Connections -> +DATABASE Step 2, select TDengine database connection @@ -49,6 +53,7 @@ Step 5, configure the connection string, click "TEST CONNECTION" to test if the ## Start + There is no difference in the use of TDengine data source compared to other data sources. Here is a brief introduction to basic data queries: 1. Click the "+" button in the upper right corner of the Superset interface, select SQL query, and enter the query interface 2. Select the TDengine data source that has been created earlier from the dropdown list in the upper left corner @@ -58,6 +63,7 @@ There is no difference in the use of TDengine data source compared to other data 6. In the SQL editor area, any SQL statement that conforms to TDengine syntax can be entered for execution ## Example + We chose two popular templates from the Superset Chart template to showcase their effects, using smart meter data as an example: The first type is Aggregate, which displays the maximum voltage value collected per minute during the specified time period in Group 4 diff --git a/docs/zh/10-third-party/05-bi/05-yhbi.md b/docs/zh/10-third-party/05-bi/05-yhbi.md index bf3f3db7f7..b60b0495f0 100644 --- a/docs/zh/10-third-party/05-bi/05-yhbi.md +++ b/docs/zh/10-third-party/05-bi/05-yhbi.md @@ -22,24 +22,24 @@ toc_max_heading_level: 4 配置JDBC数据源的步骤如下。 -第1步,在打开的永洪BI中点击“添加数据源”按钮,选择SQL数据源中的“GENERIC”类型。 -第2步,点击“选择自定义驱动”按钮,在“驱动管理”对话框中点击“驱动列表”旁边的“+”,输入名称“MyTDengine”。然后点击“上传文件”按钮,上传刚刚下载的TDengine JDBC连接器文件“taos-jdbcdriver-3.2.7-dist.jar”,并选择“com.taosdata.jdbc. -rs.RestfulDriver”驱动,最后点击“确定”按钮,完成驱动添加步骤。 -第3步,复制下面的内容到“URL”字段。 +第1步,在打开的永洪BI中点击“添加数据源”按钮,选择SQL数据源中的“GENERIC”类型。 +第2步,点击“选择自定义驱动”按钮,在“驱动管理”对话框中点击“驱动列表”旁边的“+”,输入名称“MyTDengine”。然后点击“上传文件”按钮,上传刚刚下载的TDengine JDBC连接器文件“taos-jdbcdriver-3.2.7-dist.jar”,并选择“com.taosdata.jdbc. +rs.RestfulDriver”驱动,最后点击“确定”按钮,完成驱动添加步骤。 +第3步,复制下面的内容到“URL”字段。 ```text jdbc:TAOS-RS://127.0.0.1:6041?user=root&password=taosdata ``` -第4步,在“认证方式”中点击“无身份认证”单选按钮。 -第5步,在数据源的高级设置中修改“Quote 符号”的值为反引号(`)。 -第6步,点击“测试连接”按钮,弹出“测试成功”对话框。点击“保存”按钮,输入“MyTDengine”来保存TDengine数据源。 +第4步,在“认证方式”中点击“无身份认证”单选按钮。 +第5步,在数据源的高级设置中修改“Quote 符号”的值为反引号(`)。 +第6步,点击“测试连接”按钮,弹出“测试成功”对话框。点击“保存”按钮,输入“MyTDengine”来保存TDengine数据源。 ## 创建TDengine数据集 创建TDengine数据集的步骤如下。 -第1步,在永洪BI中点击“添加数据源”按钮,展开刚刚创建的数据源,并浏览TDengine中的超级表。 -第2步,可以将超级表的数据全部加载到永洪BI中,也可以通过自定义SQL导入部分数据。 -第3步,当勾选“数据库内计算”复选框时,永洪BI将不再缓存TDengine的时序数据,并在处理查询时将SQL请求发送给TDengine直接处理。 +第1步,在永洪BI中点击“添加数据源”按钮,展开刚刚创建的数据源,并浏览TDengine中的超级表。 +第2步,可以将超级表的数据全部加载到永洪BI中,也可以通过自定义SQL导入部分数据。 +第3步,当勾选“数据库内计算”复选框时,永洪BI将不再缓存TDengine的时序数据,并在处理查询时将SQL请求发送给TDengine直接处理。 当导入数据后,永洪BI会自动将数值类型设置为“度量”列,将文本类型设置为“维度”列。而在TDengine的超级表中,由于将普通列作为数据的度量,将标签列作为数据的维度,因此用户可能需要在创建数据集时更改部分列的属性。TDengine在支持标准SQL的基础之上还提供了一系列满足时序业务场景需求的特色查询语法,例如数据切分查询、窗口切分查询等,具体操作步骤请参阅TDengine的官方文档。通过使用这些特色查询,当永洪BI将SQL查询发送到TDengine时,可以大大提高数据访问速度,减少网络传输带宽。