使用仿真数据数据表

更新时间：2022-07-05

简介

在用户未开通 TSDB 等付费服务，也无合适静态数据资源的情况下，“仿真数据”为用户提供了快速构建二维数据表、模拟数据、搭建仪表盘 Demo 的能力。

本文以创建名为“本地气温记录”的数据表，并将该表绑定至“表格”组件为例，说明了如何使用“仿真数据”功能。

开始创建“仿真数据”数据表

进入“设计器”，切换至“数据”标签，点击左侧“+ 新建”按钮启动创建数据表的流程。输入合适的数据表名称，并选择“仿真数据”类型：

如上图所示，“仿真数据”数据表有着如下几个可配置属性：

单次更新行数

用户可生成周期性的、动态的数据，该属性控制每次生成的行数，有效值为 [1, 1000]，即一次最少生成 1 行，最多生成 1000 行。
更新时间间隔

该属性控制每批次数据的生成频率，有效值为 [0, 1000]，单位为秒，0 表示仅生成 1 次，无后续更新，n 表示每 n 秒生成一批数据，显然，n 越大，生成速度越慢。

指的注意的是，过小的时间间隔（过快的频率）可能会导致浏览器卡顿。
数据更新方式

该属性控制各批次数据的组合方式：
- “追加”表示后一批数据被“添加”在现有数据之后，如每次生成 10 行数据，第一次更新后数据表有 10 行数据，第二次更新后有 20 行数据，以此类推，数据表最大行数为 1000 行，如超过最大行数，最早的数据被移出数据表（“先进先出”）；
- “覆盖”表示后一批数据永远将表中现有数据完全替换，如每次生成 10 行数据，则最终数据表无论更新多少次也只会有 10 行数据。
数据表格式

该属性控制最终数据表中每一列的格式，包含每一列的名称、类型和生成规则。

点击每一条规则前的“删除”符号可删除该列配置（减少一列），点击表格下方“+ 新建列”可增加一列配置。用户可添加的列数范围为 [1, 20]，即最少保留 1 列，最多创建 20 列。每一列可选的类型有：boolean、date、number、string。同样，过多的列数可能会导致浏览器卡顿。

不同的类型和不同的生成规则对应着不同的配置参数，点击生成规则的“编辑”按钮可在弹窗中编辑这些参数。

全部生成规则及其对应的配置参数如下：

4.1 boolean 类型列

列的类型	生成值	可选生成规则
boolean 布尔型	true/false	随机/指定

生成规则	释义
随机	在 true 和 false 两个值中随机生成一个（无需额外的配置参数，所以本规则没有“编辑”按钮）
指定	用户输入以英文逗号分割的 true false 字符串，用于指定数据值，如输入 true,false,false ，最终数据表即按照 true false false 生成 3 行数据，若每次生成的行数（如 10 行）比指定的数量（本例为 3 行）多，则循环生成（下同，不赘述）

4.2 date 类型列

列的类型	生成值	可选生成规则
date 时间型	时间戳	随机/指定/自增减

生成规则	释义
随机	用户输入起止时间，在该时间段内随机生成时间值
指定	用户输入以英文逗号分割的（符合规范的）时间字符串，用于指定时间值，如输入 2019-01-02 10:05:00, 2019-02-03 10:30:50 ，最终数据表即按照 2019-01-02 10:05:00, 2019-02-03 10:30:50 生成 2 行数据
自增减	用户输入起始时间、步长、增/减方向，如输入起始时间“2019-10-01 10:20:30”、步长“1分钟”和方向“增加”，最终数据表即从这个时间点开始自增生成时间值

4.3 number 类型列

列的类型	生成值	可选生成规则
number 数字型	实数	随机/指定/自增减

生成规则	释义
随机	用户输入最小值、最大值、精度 n，在该区间范围内生成小数点后最多 n 位的实数
指定	用户输入以英文逗号分割的数字字符串，用于指定数值，如输入 1,3,5,7,9 ，最终数据表即按照 1 3 5 7 9 生成 5 行数据
自增减	用户输入起始值、步长、增/减方向，如输入起始值 2 、步长 2和方向“增加”，最终数据表生成值为 2 4 6 8 10 12……

4.4 string 类型列

列的类型	生成值	可选生成规则
string 字符串型	字符串（文本）	随机/指定

生成规则	释义
随机	用户选择一个字符串类别，可选值为 “姓名”、“email”和“城市”，在选定的类别内随机生成相应的字符串
指定	用户输入以英文逗号分割的字符串，如输入北京,上海,广州，最终数据表即按照北京上海广州的顺序生成 3 行数据

我们继续“本地气温记录”的例子。

我们期望最终生成的数据表包含两列：

一列名为“时间”的“date”类型列，从“2019-10-01 10:00:00”开始按“1 分钟”自增，用于模拟记录气温的时刻；
一列名为“温度”的“number”类型列，在 [18, 30] 区间内随机生成包含一位小数的数字，用于模拟气温。

通过编辑“数据表格式”，可得到如下的配置规则：

两列生成规则的详细配置如下：

小结，目前的配置表达了如下含义：

（名称&类型）生成一个名为“本地气温记录”的“仿真数据”数据表；
（更新时间间隔）该表每 2 秒钟更新一次；
（单次更新行数）每次更新 1 行数；
（数据更新方式）每 2 秒钟新生成的数据追加到现有数据之后；
（数据表格式）一个“date”类型列，名称为“时间”，从“2019-10-01 10:00:00”开始按“1 分钟”自增；一个“number”类型列，名称为“温度”，随机在 [18, 30] 内生成数字。