[]
        
在线Demo 免费试用
(Showing Draft Content)

创建流式数据集

1. 概述

1.1 功能概述

流式数据集是一种新型数据集,与传统的缓存数据集和直连数据集不同,它没有数据源、关联关系、字段、数据过滤器或参数等设置项。流式数据集将数据存储在临时缓存中,缓存会在短时间内过期,适用于展示但是数据(如一段时间内的曲线变化)。流式数据集的定义类似于数据库中的表,包含字段名和字段类型。此外,它还有两个特殊设置项:推送数据令牌驻留时间

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

image2021-11-19_17-0-34.png

通过设置驻留时间,流式数据集可以实现数据的流式处理,结合仪表板的实时刷新功能,能够实现大屏数据的实时更新。流式数据集也支持在报表中使用,随时显示最新数据。

实际应用场景中,流式数据可以来自工厂传感器、社交媒体源、服务使用情况指标或其他时间敏感型数据收集器或发送器。本节将详细介绍如何创建流式数据集。

2. 操作步骤

2.1 创建流式数据集

步骤一:创建文档,选择仪表板或报表的准备数据

  1. 文档门户单击创建文档image,选择仪表板或报表的准备数据,然后选择流式数据集创建按钮,进入流式数据集的数据准备界面。

    PixPin_2025-03-20_09-03-36

步骤二:进入流式数据集设计器

  1. 流式数据集设计界面,支持自定义字段名称和字段类型,单击添加字段按钮添加字段,单击字段右侧的删除图标可以删除字段。定义字段后,推送数据时需按此格式来推送。

    PixPin_2025-03-21_09-49-17

    type=info

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

    image

  2. 设置推送数据令牌驻留时间

    image2021-11-19_11-59-31.png

  • 推送数据令牌:可单击随机生成按钮随机生成令牌,或自定义令牌内容(支持大小写字母和数字)。

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

步骤三:保存数据集

  1. 设置完成后,单击保存按钮,保存数据集。

    image

  2. 保存界面,为数据集命名,可选择类别并添加描述,然后单击保存。

    image2021-11-19_12-6-50.png

步骤四:查看数据集

  1. 保存后,数据集仅定义了表结构,尚未推送数据,因此预览时为空。接下来需要推送数据。

    PixPin_2025-03-20_16-12-29

2.2 推送数据

步骤一:进入推送数据API信息界面

  1. 将鼠标悬停至需要推送数据的文档处,单击更多按钮,在展开的上下文菜单中选择“ 推送数据,进入推送数据API信息界面。

    PixPin_2025-03-20_16-22-05

  2. 推送数据API信息界面,可获取到API信息,包括端点和请求体信息,以及示例报文。

    image2021-11-19_12-15-23.png

步骤二:推送数据

  1. 以 Apifox 为例,介绍如何推送数据。

    PixPin_2025-03-20_16-26-21

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

    1)选择请求类型: 选择类型为POST

    2)填写端点URL: 将 API 信息中的端点复制到URL框中。

    PixPin_2025-03-20_16-31-00

    3)选择请求体: 选择Body作为请求体。

    4)设置格式: 选择格式为JSON

    5)填写请求头内容: 粘贴请求体内容,以下为默认值示例:

    PixPin_2025-03-20_16-31-47

  • columns: 字段名称。

  • rows: 字段内容,支持多行数据(按数组格式添加)。

  • overwrite: 是否覆盖之前的数据(true 表示覆盖,false 表示追加)。

    6)发送请求: 填写完成后,单击发送按钮发送报文。无返回体,发送成功的状态码为204。

    PixPin_2025-03-20_16-33-26

2.3 成果展示

  1. Wyn 创建流式数据集并成功推送数据后,可以在「文档门户>我的分析>数据集」列表中找到创建成功的流式数据集。更多介绍,请见数据集/数据模型协作与管理

    PixPin_2025-03-20_16-34-24

2.4 多行报文示例

  1. 发送多行内容的报文,示例如下:

    image2021-11-19_14-31-9.png

  2. 推送后查看数据集内容,由于报文中overwritetrue,新数据将覆盖原有内容。

    PixPin_2025-03-20_16-41-28