azcopy bench

通过将测试数据上传到指定目标或从指定目标下载测试数据来运行性能基准检验。 对于上传,测试数据是自动生成的。

基准检验命令运行与“copy”命令相同的过程,区别在于:

  • 基准检验并非同时需要源参数和目标参数,而只需要其中一个。 这是你要向其上传数据或从中下载数据的 Blob 容器、Azure 文件存储共享或 Azure Data Lake Storage Gen2 文件系统。

  • “mode”参数说明 AzCopy 是应该测试向给定目标的上传还是从给定目标的下载。 有效值为“上传”和“下载”。 默认值为“上传”。

  • 对于上传基准,有效负载通过命令行参数来描述,这些参数控制自动生成的文件的数量和大小。 生成过程完全在内存中进行。 不使用磁盘。

  • 对于下载,有效负载包含源中已存在的任何文件。 (如果需要,请参阅下面关于如何生成测试文件的示例)。

  • 仅支持几个可用于 copy 命令的可选参数。

  • 将会度量和报告其他诊断信息。

  • 对于上传,默认行为是在测试运行结束时删除传输的数据。 对于下载,数据实际上永远不会保存在本地。

基准模式会自行调整为能够提供最大吞吐量的并行 TCP 连接数。 它会在结尾处显示该数字。 若要防止自动优化,请将 COPY_CONCURRENCY_VALUE 环境变量设置为特定的连接数。

支持所有常用的身份验证类型。 但通常情况下,进行上传基准检验最方便的方法是创建一个包含 SAS 令牌的空容器并使用 SAS 身份验证。 (下载模式要求目标容器中存在一组测试数据。)

azcopy bench [destination] [flags]

示例

使用默认参数运行上传基准(适用于对高达 1 Gbps 的网络进行基准测试):

azcopy bench "https://[account].blob.core.chinacloudapi.cn/[container]?<SAS>"

运行一个上传 100 个文件的基准测试,每个文件的大小为 2 GiB:(适用于在快速网络(例如 10 Gbps)上进行基准测试):

azcopy bench "https://[account].blob.core.chinacloudapi.cn/[container]?<SAS>" --file-count 100 --size-per-file 2G

与上面的相同,但是使用 50,000 个文件,每个文件的大小为 8 MiB,计算其 MD5 哈希(使用的方式与 --put-md5 标记在 copy 命令中使用的相同)。 进行基准测试时使用 --put-md5 的目的是测试 MD5 计算是否会影响所选文件计数和大小的吞吐量。

azcopy bench --mode='Upload' "https://[account].blob.core.chinacloudapi.cn/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5

运行从目标下载现有文件的基准检验测试

azcopy bench --mode='Download' "https://[account].blob.core.chinacloudapi.cn/[container]?<SAS>"

运行不会删除传输的文件的上传。 (这些文件之后可用作下载测试的有效负载)

azcopy bench "https://[account].blob.core.chinacloudapi.cn/[container]?<SAS>" --file-count 100 --delete-test-data=false

选项

--blob-type string 定义目标中的 Blob 类型。 用于允许对不同的 Blob 类型进行基准测试。 与 copy 命令中同名参数相同(默认为“Detect”)

--block-size-mb float 使用此块大小(以 MiB 为单位)。 默认值根据文件大小自动计算。 允许使用小数,例如 0.25。 与 copy 命令中的同名参数相同

--check-length - 传输后检查目标上的文件长度。 如果源与目标之间不匹配,则将传输标记为失败。 (默认值为 true)

--delete-test-data 如果为 true,则会在基准测试运行结束时删除基准数据。 将它设置为 false 的前提是需在目标中保留数据,例如,将它用于基准模式之外的手动测试(默认为 true)

--file-count(单位)要使用的自动生成的数据文件数(默认为 100)

-h--help bench 命令的帮助

--log-level(字符串)定义日志文件的日志详细程度,可用级别:INFO(所有请求/响应)、WARNING(响应缓慢)、ERROR(仅限失败的请求)和 NONE(无输出日志)。 (默认值为“INFO”)

--mode(字符串)定义 AzCopy 是应该测试向此目标的上传还是从给定目标的下载。 有效值为“上传”和“下载”。 默认选项为“上传”。 (默认为“上传”)

--number-of-folders(单位)如果大于 0,则创建文件夹来划分数据。

--put-md5 创建每个文件的 MD5 哈希,并将该哈希另存为目标 Blob/文件的 Content-MD5 属性。 (默认不会创建哈希。)与 copy 命令中的同名参数相同

--size-per-file(字符串)每个自动生成的数据文件的大小。 必须是数字,后跟 K、M 或 G。例如,12k 或 200G(默认值为“250M”)

从父命令继承的选项

--cap-mbps (浮点数)限制传输速率,以兆位/秒为单位。 瞬间吞吐量可能与上限略有不同。 如果此选项设置为零或被省略,则吞吐量不受限制。

--output-type(字符串)命令输出的格式。 选项包括:text、json。 默认值为“text”。 (默认值为“text”)

--trusted-microsoft-suffixes(字符串)指定可向其中发送 Azure Active Directory 登录令牌的其他域后缀。 默认值为“.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net”。 此处列出的任何内容都会添加到默认值。 为安全起见,应只在此处放置 Azure 域。 用分号分隔多个条目。

另请参阅