文件参数功能一般与数据配置节点功能搭配使用,用于需要自定义压测请求的场景,例如使用指定用户模拟登录场景等。本文介绍如何使用文件参数。

背景信息

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

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

步骤一:创建文件参数

  1. 登录 PTS 控制台,在左侧导航栏选择创建压测 > 创建 PTS 场景

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

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

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

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

更多信息

PTS 的其它参数使用请参见以下文档: