数据集管理

AngusTester数据集管理模块实现测试数据的统一管理和动态调用，支持多种数据源构建数据集，提升测试数据的复用性。

一、数据集创建操作

1. 添加静态数据集

操作说明：通过Mock函数生成动态参数值
操作步骤：

1. 数据 → 数据集管理 点击「添加静态数据集」
   
2. 配置关键参数：
   • 名称格式：[用途]_数据集（如登录用户数据）
   • 参数定义（名称/类型/值）：
     • 值类型：常量/Mock函数（如@Username()）
     • 密码类型：加密敏感字段
       
3. **预览**标签验证数据生成效果
   
   ⚠️ 单数据集支持200个参数

2. 添加文件提取数据集

操作说明：从外部文件批量导入数据
操作步骤：

1. 添加静态数据集▼ 选择「文件提取数据集」
2. 配置提取规则：
   • 文件路径（支持CSV/XLSX）
   • 起始位置（行号+列号索引）
   • 列映射（文件列→参数名）
     
3. **预览**检查数据映射准确性
   
   ❗ 文件变更需重新加载数据集

3. 添加JDBC提取数据集

操作说明：通过SQL查询构建数据集
操作步骤：

1. 添加静态数据集▼ 选择「JDBC提取数据集」
2. 配置数据库连接：
   • 数据源（需先配置）
   • SQL查询（SELECT语句）
   • 列映射（结果集字段→参数名）
     
3. **预览**验证查询结果
   
   ⚠️ 敏感字段需启用加密

二、数据集维护操作

1. 导入数据集

操作说明：通过YAML文件批量导入
操作步骤：

1. 数据集管理 点击「导入」
2. 上传符合规范的YAML文件
3. 系统自动：
   • 校验格式有效性
   • 执行覆盖/跳过策略

2. 克隆数据集

操作说明：快速创建相似数据集
操作步骤：

1. 数据集列表 点击「克隆」
2. 系统自动：
   • 生成副本（名称追加"-Copy.xxx"）
   • 保留所有参数配置
     需手动调整关键参数

3. 编辑数据集

操作说明：更新数据集配置
操作步骤：

1. 数据集列表 点击「编辑」
2. 可修改字段：
   • 名称/描述
   • 参数增删
   • 提取规则

4. 批量删除

操作说明：清理废弃数据集
操作步骤：

1. 勾选目标数据集
2. 点击「批量删除」
3. 二次确认操作
   ❗ 关联引用需先解除

三、数据集应用集成

1. 接口参数化引用

操作说明：在接口请求中动态调用数据
操作步骤：

1. 接口 → 服务管理 打开目标接口
2. **参数化**标签点击「引入数据集」
   
3. 参数值填写{参数名}
   
   ⚠️ 未生效参数标红提示

2. 场景参数化引用

操作说明：在测试场景中批量应用数据
操作步骤：

1. 场景管理 打开目标场景
2. **执行配置 → 数据集**添加引用
3. 步骤参数填写{参数名}
   ❗ 跨接口变量需保持命名一致

四、数据导出管理

1. 导出单个数据集

操作说明：备份或分享数据集配置
操作步骤：

1. 数据集详情页 点击「导出」
2. 选择格式：
   • YAML（完整配置）
   • CSV（原始数据）

2. 导出所有数据集

操作说明：全量备份数据集体系
操作步骤：

1. 数据集管理 点击「导出」
2. 下载ZIP压缩包（含YAML文件集）

数据集字段信息

参数	字段名	类型	必填	长度限制	说明
ID	id	bigint	条件	/	唯一标识符；修改时必须提供
项目ID	projectId	long	是	/	所属项目唯一标识
数据集名称	name	string	是	≤100	数据集唯一标识名称
描述	description	string	否	≤200	数据集功能描述
参数列表	parameters	list	是	/	数据集参数定义列表（至少一个参数）
提取规则	extraction	object	否	/	数据提取规则配置
是否已提取	extracted	boolean	只读	/	数据是否已完成提取
数据来源	dataSource	enum	只读	/	数据来源枚举：静态值/值提取/文件提取/Http提取/Jdbc提取
租户 ID	tenantId	long	只读	/	所属租户 ID
创建人ID	createdBy	long	只读	/	数据集创建人ID
创建人姓名	createdByName	string	只读	/	创建人姓名
创建时间	createdDate	datetime	只读	/	数据集创建时间
最后修改人ID	lastModifiedBy	long	只读	/	最后修改人ID
最后修改人姓名	lastModifiedByName	string	只读	/	最后修改人姓名

参数字段（parameters）

参数	字段名	类型	必填	长度限制	说明
参数名称	name	string	是	≤100	参数唯一标识名称
参数值	value	string	否	≤200	参数默认值
是否模拟值	hasMockValue	boolean	只读	/	是否使用模拟值

提取配置（extraction）

请查看测试规范：参数化 -> 提取配置

数据来源（dataSource）

枚举值	说明
STATIC_VALUE	静态值
EXTRACT_VALUE	值提取
EXTRACT_FILE	文件提取
EXTRACT_HTTP	Http提取
EXTRACT_HTTP_SAMPLING	Http采样提取
EXTRACT_JDBC	Jdbc提取