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

创建推送数据集

1. 概述

1.1 功能概述

推送数据集是另一种支持数据推送的数据集类型,其数据推送方式与流式数据集一致。两者的主要区别在于:

  • 推送数据集: 不设置驻留时间,持续存储推送的数据,并将数据写入磁盘数据库中。

  • 流式数据集: 数据存储在临时缓存中,设置驻留时间后,超时数据会被自动清理。

以下是推送数据集的设计界面,与流式数据集基本一致,仅缺少右上角的驻留时间设置项:

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

推送数据集的定义类似于数据库中的表,包含字段名和字段类型,并通过推送数据令牌进行数据推送验证。推送数据集同样支持创建仪表板或报表,每当有新数据推送过来时,仪表板/报表会实时更新。由于推送数据集会持续累积历史数据,因此更适合分析长时间的的数据走势,尤其适用于需要历史数据支持的场景。本节将详细介绍如何创建推送数据集。

2. 操作步骤

2.1 创建推送数据集

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

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

    PixPin_2025-03-27_15-14-27

步骤二:进入推送数据集设计器

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

    PixPin_2025-03-21_09-42-21

    type=info

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

    PixPin_2025-03-21_09-44-26

  2. 设置推送数据令牌

    image

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

步骤三:使用安全过滤器过滤数据

  1. 字段创建完成后,单击安全过滤器按钮,即可进入安全过滤器配置界面。具体操作可参考数据模型章节的添加安全过滤器

步骤四:保存数据集

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

    image

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

    image2021-11-20_14-25-8.png

步骤五:查看数据集

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

    PixPin_2025-03-20_16-16-03

2.2 推送数据

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

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

    PixPin_2025-03-18_18-01-35

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

    image2021-11-20_14-58-54.png

步骤二:推送数据

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

    PixPin_2025-03-21_09-46-46

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

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

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

    PixPin_2025-03-19_09-40-19

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

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

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

    PixPin_2025-03-19_09-42-16

  • columns: 字段名称。

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

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

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

    PixPin_2025-03-19_09-44-06

2.3 成果展示

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

    PixPin_2025-03-20_17-40-41

2.4 多行报文示例

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

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

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

    PixPin_2025-03-20_17-42-01