你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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.windows.net/[container]?<SAS>"

运行具有指定块大小为 2 MiB 的上传基准,并在传输后检查文件的长度。

azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length

运行上传 500 个文件的基准测试。 每个文件的大小为 500 MiB,日志级别设置为仅显示错误。

azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR

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

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

下一个示例与上面的示例相同,但包含 50,000 个文件。 每个文件的大小为 8 MiB。 此示例还计算每个文件的 MD5 哈希,类似于 --put-md5 标志在 azcopy copy 命令中计算 MD5 的方式。 基准测试时 --put-md5 的目的是测试 MD5 计算是否影响所选文件计数和大小的吞吐量。

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

运行基准测试,该测试上传 1000 个文件并创建文件夹来划分数据。 每个文件的大小为 100 KiB。

azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 1000 --size-per-file 100K --number-of-folders 5

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

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

使用默认参数运行下载基准,并将传输速率上限为 500 Mbps。

azcopy bench --mode=Download "https://[account].blob.core.windows.net/[container]?<SAS>" --cap-mbps 500

运行不删除已传输文件的上传。 然后,这些文件可用作下载测试的有效负载。

azcopy bench "https://[account].blob.core.windows.net/[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-blob-size-mb 将此大小(以 MiB 指定)用作阈值,以确定在上传到 Azure 存储时是否将 blob 作为单个 PUT 请求上传。 默认值是根据文件大小自动计算的。 允许使用小数(例如:0.25)。

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

另请参阅