DataEase

2024年9月18日大约 7 分钟

DataEase

产品概述

DataEase 简介
DataEase 是一个开源的数据可视化与分析工具，提供拖拽式的界面，使得用户能够轻松创建图表和仪表板，已支持 MySQL、SQL Server、Hive、ClickHouse、达梦等多种数据源，并且可以集成到其他应用程序中。能帮助用户快速洞察数据，做出决策。更多介绍详情请参考DataEase 官网
DataEase-IoTDB 连接器介绍
IoTDB 可以通过API数据源的形式与DataEase实现高效集成，利用API数据源插件通过Session接口访问IoTDB数据。该插件支持定制化的数据处理功能，为用户提供了更大的灵活性和更多样化的数据操作选项。

安装要求

准备内容	版本要求
IoTDB	版本无要求，安装请参考 IoTDB 部署指导
JDK	建议 JDK11 及以上版本（推荐部署 JDK17 及以上版本）
DataEase	要求 v1 系列 v1.18 版本，安装请参考 DataEase 官网安装指导（暂不支持 v2.x，其他版本适配请联系天谋商务）
DataEase-IoTDB 连接器	请联系天谋商务获取

安装步骤

步骤一：请联系商务获取压缩包，解压缩安装包（ iotdb-api-source-1.0.0.zip ）

步骤二：解压后，修改config文件夹中的配置文件application.properties

端口server.port可以按需进行修改
iotdb.nodeUrls需配置为待连接的 IoTDB 的实例的地址和端口
iotdb.user需配置为 IoTDB 的用户名
iotdb.password需配置为 IoTDB 的密码

# 启动 IoTDB API Source 监听的端口
server.port=8097
# IoTDB 的实例地址，多个 nodeUrls 用 ; 分割
iotdb.nodeUrls=127.0.0.1:6667
# IoTDB 用户名
iotdb.user=root
# IoTDB 密码
iotdb.password=root

步骤三：启动 DataEase-IoTDB 连接器

前台启动

./sbin/start.sh

后台启动（增加 -d 参数）

./sbin/start.sh -d

步骤四：启动后可以通过日志来查看是否启动成功。

 lsof -i:8097  // config 里启动 IoTDB API Source 监听的端口

使用说明

登录 DataEase

配置数据源

在导航条中跳转【数据源】界面

点击左上角【 + 】，滑动到底部，选择【API】数据源

新建 API 数据源，自行设置基本信息中的【显示名称】，在数据表位置点击【添加】

在数据表名称字段中输入自定义的【名称】，请求类型选择 Post，地址填写 http://[IoTDB API Source]:[port]/getData，如果在本机操作且使用的是默认端口，地址应填写http://127.0.0.1:8097/getData

在【请求参数】部分，选择【请求体】标签页，并确保格式设置为 JSON。请按照以下示例填写参数，其中： timeseries：要查询的序列的完整路径（目前只支持查询一条序列） limit：需要查询的条数（有效范围为大于 0 且小于 100000）
```
{ 
    "timeseries": "root.ln.wf03.wt03.speed",
    "limit": 1000
}
```

点击【认证配置】标签页，选择【Basic Auth】作为认证方式，并准确输入 IoTDB 的用户名和密码

点击【下一步】，将在data部分看到接口返回结果。如下图展示接口中，返回了time、 rownumber和value信息，同时需要指定各字段数据类型。完成设置后，点击界面右下角的【保存】按钮。

保存后进入新建 API 数据源页面，点击右上角【保存】按钮。

保存数据源：保存后，可在 API 分类菜单下查看该数据源及其详细信息，或编辑该数据源。

配置数据集

创建 API 数据集：在导航条中跳转至数据集页面，点击页面左上角的【 + 】符号，选择【API 数据集】类型，选择此数据集所在的目录，即可进入新建 API 数据集页面。

在新建 API 数据集页面，选择刚才新建的 API 数据源和包含在数据集中的对应数据表（下图左），并设置数据集名称（下图右）。设置完毕后，点击页面右上角的【保存】按钮以完成数据集的创建。

选择刚刚创建的数据集，进入【字段管理】标签页，然后将所需的字段（如 rowNum）标记为维度。

配置更新频率：在【更新信息】页面上点击【添加任务】，设置以下信息：
任务名称：根据实际情况填写
更新方式：选择【全量更新】
执行频率：根据实际情况设置（考虑DataEase获取速度，建议设置为大于 5 秒更新一次），例如需要设置为每 5 秒更新，则可以选择【表达式设定】并在【cron 表达式】中设置为0/5 * * * * ? * 配置完成后，点击页面右下角的【确认】按钮保存设置。