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

背景信息

使用文件参数功能需将参数文件上传至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

步骤一:创建文件参数

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

  2. 创建场景页面,单击下方的数据源管理
  3. 选择任意一种方式上传参数文件。
    • 通过上传文件创建。
      1. 数据源管理面板中单击+上传文件,并选择本地参数文件,然后单击打开

        也可以选择已上传的参数文件。

      2. 判断是否选中首行作为参数名
        说明 选中首行作为参数名后,PTS读取参数文件时将跳过第一行的数据。选中后无需手动定义参数名。若未选中此项,则需根据业务场景定义每列数据的参数名。
        sc_file_parameter
    • 通过配置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读取参数文件时将跳过第一行的数据。选中后无需手动定义参数名。若未选中此项,则需根据业务场景定义每列数据的参数名。
        配置OSS文件
  4. 单击确定

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

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

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

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

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

更多信息

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