使用文件参数

背景信息

使用文件参数功能需将参数文件上传至 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 读取参数文件时将跳过第一行的数据。勾选后无需手动定义参数名。若未勾选此项，则需根据业务场景定义每列数据的参数名。
        
   • 通过配置 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 的其它参数使用请参见以下文档：

• 创建系统函数
• 出参与检查点
• 添加数据配置节点