功能概述

流式数据集是一种新型的数据集，它与之前支持的缓存数据集以及直连数据集有很大的不同，流式数据集中没有数据源、关联关系、字段、数据过滤器、参数等设置项。

流式数据集将数据存储到临时缓存中，该缓存会在一小段时间后过期。 临时缓存适用于显示具有一些短时数据，例如一小段时间内的曲线变化。

流式数据集的定义与数据库中的表非常相似，也是有字段名和字段类型的定义。

除此之外，流式数据集还有两个特别的设置项，即推送数据令牌和驻留时间。

下面是流式数据集的设计界面：

通过驻留时间的设置实现对数据的流式处理，配合仪表板的实时刷新功能可达到实时刷新仪表板大屏的效果。

流式数据集同样支持在报表中使用，可随时显示新数据。

实际场景中流式处理的数据来源可以是工厂传感器、社交媒体源、服务使用情况指标或许多其他时间敏感型数据收集器或发送器。

接下来我们来看如何创建流式数据集并推送数据。

创建流式数据集

在门户中单击加号，为仪表板或报表准备数据，然后选择流式数据集。

定义数据集中的字段和字段类型，通过单击添加字段添加字段，单击字段右侧的删除图标可以删除字段。类似于在定义数据库中的一张表。

定义字段之后，将来向数据集推送数据时则需按此字段格式来推送。

type=info

数据类别用来指定字段的地理位置或图片信息，用于仪表板中识别图片和地图定位。如有需要可进行指定。

接下来设置推送的数据令牌和数据在数据集缓存中驻留的时间。

• 推送数据令牌：可单击随机生成按钮随机生成一个数据令牌，您也可以自定义令牌内容，支持使用大小写字母和数字。

• 驻留时间：表示数据在数据集缓存中停留的时间，超出设置时间后的数据将被清理。支持以秒或分钟为单位设置驻留时间，最大为60分钟。设置的驻留时间越长，对系统资源的消耗越多。

设置完成后单击保存按钮，保存数据集。

为数据集命名，也可以指定类别，添加描述，然后保存。

此时的数据集仅定义了表结构并未有数据推送进来，所以预览时为空。接下来为数据集中推送数据。

推送数据

首先获取推送数据 API 信息。

从弹出的窗口中可获取到API信息，包括端点和请求体信息，以及示例报文。

文中我们以 Postman 为例为您介绍如何推送数据。

以下为图中六个编号对应的介绍。

1. 选择类型为POST。

2. 将 API 信息中的端点复制到URL框中。

3. 选择请求体Body。

4. 选择类型为raw。

5. 选择格式为JSON。

6. 粘贴请求体内容，如下图所示。这里我们以默认值为例，先不进行更改。

报文中的 columns 表示各字段名称；rows 表示字段内容，如需多行则按数组添加即可；overwrite 表示是否覆盖之前的内容，true 表示覆盖，false 表示添加。

7. 填写完成后，点击发送按钮发送报文。发送成功后会有成功提示。

完成报文推送后，我们来预览流数据集。可见数据已推送成功。

多行报文示例

比如我们发送这样一个多行内容的报文：

推送后来看数据集内容，由于报文中“overwrite”为“true”，所以新的数据将原来的一行内容进行了覆盖。