使用文件参数

背景信息

使用文件参数功能需将参数文件上传至PTS控制台或OSS上，参数文件规范如下：

文件格式支持CSV及ZIP格式，ZIP压缩包内的文件需是以CSV结尾的单个文件。

说明请勿直接修改XLSX文件的后缀。推荐使用EXCEL、Numbers等软件导出，或使用Apache Commons-csv程序生成。
在参数文件第一行不写列名，直接写参数数据。若参数文件第一行是列名（不是参数数据），上传文件时需选中首行作为参数名功能，则导入的文件参数将忽略第一行。
可上传多个文件。
- 资源包并发5000及以上，单个文件大小限制在600 MB，超过600 MB则需压缩为ZIP文件。
- 资源包并发5000以下，单个文件大小限制在100 MB，超过100 MB则需压缩为ZIP文件。
- 若压缩为ZIP文件后，单个文件大小依然超过600 MB或100 MB的，可使用OSS地址上传。
  
  说明 OSS地址上传文件大小限制为2 GB。
文件中单行不能超过2万个字符。
若需要多个数据关联组合为一组参数，无需将关联组合强制放到一个文件中，可通过数据配置节点的文件参数设置功能，来进行跨文件数据的组合。
如果引用多个文件中的参数，可以通过指定基准文件来设置组合基准。若不设置基准列或数据轮询一次的参数，则默认将全部参数重复至1000行后再组合重复，具体操作，请参见并发模式和RPS模式下，是如何读取多文件参数的。
若参数有强制的一一对应关系，请务必将其放在一个文件中并做好对应关系。需保持每一行中多个列的数据是完整的，否则会出现空字段，可能影响压测数据。例如参数文件中两列分别表示Username和Password两个参数。
```
john,123456  
mike,234567  
lilei,345678
```

步骤一：创建文件参数

登录PTS控制台，在左侧导航栏选择PTS压测 > 创建场景。
在创建场景页面，单击下方的数据源管理。
选择任意一种方式上传参数文件。
- 通过上传文件创建。
  1. 在数据源管理面板中单击+上传文件，并选择本地参数文件，然后单击打开。
    也可以选择已上传的参数文件。
  2. 判断是否选中首行作为参数名。
    
    说明选中首行作为参数名后，PTS读取参数文件时将跳过第一行的数据。选中后无需手动定义参数名。若未选中此项，则需根据业务场景定义每列数据的参数名。
- 通过配置OSS文件创建。
  1. 获取参数文件的OSS地址。
    1. 登录OSS控制台。
    2. 在控制台左侧导航栏中单击Bucket列表，单击目标文件的Bucket名称。
    3. 在文件管理页面，单击目标文件或目标文件操作列的详情。
    4. 在详情面板，单击设置读写权限，然后选择公共读。单击确定。
    5. 重新进入目标文件的详情面板，单击复制文件URL。
  2. 登录PTS控制台，在左侧导航栏选择PTS压测 > 创建场景。
  3. 在创建场景页面，单击下方的数据源管理。
  4. 在数据源管理面板，单击配置OSS文件
  5. 单击OSS地址列表对话框右下角的新增，然后在请输入OSS文件地址对话框中粘贴所复制的OSS文件地址，然后单击确认。
  6. 在已导入OSS文件地址栏的操作列，单击导入，并在弹出的确认框中单击确认。
  7. 判断是否选中首行作为参数名。
    
    说明选中首行作为参数名后，PTS读取参数文件时将跳过第一行的数据。选中后无需手动定义参数名。若未选中此项，则需根据业务场景定义每列数据的参数名。
单击确定。

步骤二：添加数据配置节点

使用数据配置节点功能，可以根据实际需求指定全局文件参数中的某个参数为基准列，充分利用参数文件中的所有数据。还可以根据二次定义文件中的参数，适用范围为本串联链路。

在场景配置页签中单击+添加压测API右侧的下拉箭头，然后在下拉列表中单击添加数据配置。
单击数据配置右侧区域，然后在展开区域单击文件参数设置页签。
在文件参数设置页签中添加所需参数，并按需进行配置。
- 读取方式：可选择为顺序、随机。
- 数据轮询一次：设为轮询一次之后，在整个压测过程中，数据只会被使用一次；被指定为轮询一次的数据，同时也是基准列。
- 基准列：设为基准列的数据，其他数据将以它为基准进行数据的组合。例如基准列为100行，其它列多余100行的数据会被截断、少于100行的数据会重复到100之后再进行组合。
可选：若需二次定义参数，可以在数据配置区域单击自定义参数页签，然后进行参数定义。

步骤三：使用已创建的参数

在创建场景页面，单击下方的参数列表。
在自定义参数/串联链路面板单击图标，系统将自动复制参数内容。
在API的Body定义页签的编辑框内，粘贴参数内容，同时对Body内容进行编辑，如组合字符串、参数或函数等。

背景信息

步骤一：创建文件参数

步骤二：添加数据配置节点

步骤三：使用已创建的参数

更多信息