azcopy bench
Запускает тест производительности, отправляя тестовые данные в указанное место назначения или загружая их оттуда. Для отправки тестовые данные создаются автоматически.
Команда тестирования производительности выполняет тот же процесс, что и команда "copy", за исключением следующего.
Вместо того, чтобы требовать и исходный, и целевой параметры, для тестирования производительности требуется только один. Это контейнер BLOB-объектов, общий ресурс службы файлов Azure или файловая система Azure Data Lake Storage 2-го поколения, к которую требуется отправить данные или загрузить их из нее.
Параметр "mode" описывает, должна ли команда AzCopy проверять отправку или загрузку из данного целевого объекта. Допустимые значения: «Upload» и «Download». Значение по умолчанию — "Upload".
Для отправки тестов производительности полезные данные описываются параметрами командной строки, которые управляют количеством файлов, создаваемых автоматически, и их величиной. Процесс создания полностью выполняется в памяти. Диск не используется.
Для загрузки полезные данные состоят из любых файлов, которые уже существующего в источнике. (См. пример ниже, чтобы создать тестовые файлы, если это необходимо.)
Поддерживаются только некоторые из необязательных параметров, доступных для команды копирования.
Выполняется дополнительная диагностика, по результатом которой создается отчет.
Для отправки по умолчанию переданные данные удаляются в конце тестового запуска. Для загрузки данные никогда не сохраняются локально.
Режим тестирования производительности автоматически настраивается на количество параллельных TCP-соединений, обеспечивающих максимальную пропускную способность. Это число будет отображаться в конце. Чтобы предотвратить автоматическую настройку, задайте для переменной среды AZCOPY_CONCURRENCY_VALUE определенное число соединений.
Поддерживаются все обычные типы проверки подлинности. Однако наиболее удобный подход к отправке тестов производительности заключается, как правило, в создании пустого контейнера с маркером SAS и использовании проверки подлинности SAS. (Для режима загрузки в целевом контейнере должен присутствовать набор тестовых данных.)
azcopy bench [destination] [flags]
Примеры
Запустите тест производительности с параметрами по умолчанию (подходящими для тестирования производительности сетей до 1 Гбит/с):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Запустите тест производительности, при котором выполняется отправка 100 файлов, размер каждого из которых составляет 2 ГиБ: (подходит для тестирования производительности быстрых сетей, например 10 Гбит/с):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Аналогично описанному выше, но используйте 50 000 файлов, размер каждого из которых составляет 8 МиБ, и вычислите их хэши MD5 (аналогично тому, как флаг put-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
Запустите тест производительности, при котором выполняется скачивание существующих файлов из целевого объекта.
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Запустите отправку, при которой не удаляются переданные файлы. (Далее эти файлы могут использоваться в качестве полезных данных для тестирования загрузки.)
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Параметры
--blob-type string определяет тип большого двоичного объекта в месте назначения. Используется для разрешения тестирования производительности различных типов BLOB-объектов. Идентична параметру с таким же именем в команде копирования (по умолчанию "Detect")
--block-size-mb float используйте этот размер блока (указанный в МиБ). Значение по умолчанию рассчитывается автоматически в зависимости от размера файла. Допускаются десятичные дроби, например 0,25. Идентично параметру с таким же именем в команде копирования
--check-length Проверьте длину файла в назначении после передачи. В случае несоответствия между источником и назначением перенос помечается как failed. (Значение по умолчанию — true.)
--delete-test-data Если значение true, данные теста будут удалены в конце выполнения теста. Задайте значение false, если требуется сохранить данные в месте назначения, например, чтобы использовать их для ручного тестирования вне режима тестирования производительности (по умолчанию true)
--file-count (uint) число используемых автоматически создаваемых файлов данных (по умолчанию 100)
-h, --help справка по средству
Строка --log-level определяет уровень детализации журнала для файла журнала. Доступные уровни: INFO (все запросы и ответы), WARNING (медленные ответы), ERROR (только невыполненные запросы) и NONE (без выходных журналов). Значение по умолчанию — "INFO".
Строка --mode определяет, должно ли при выполнении команды Azcopy выполняться тестирование отправки или загрузки с этого целевого объекта. Допустимые значения: 'upload' и 'download'. Параметр по умолчанию — 'upload'. (По умолчанию используется 'upload'.)
--number-of-folders (uint) Если значение больше 0, создаются папки для разделения данных.
--put-blob-size-mbИспользуйте этот размер (указанный в MiB) в качестве порогового значения, чтобы определить, следует ли отправлять большой двоичный объект в виде одного запроса PUT при отправке в служба хранилища Azure. Значение по умолчанию рассчитывается автоматически в зависимости от размера файла. Допускаются десятичные дроби (например, 0,25).
--put-md5 Создайте хэш MD5 каждого файла и сохраните хэш в качестве свойства Content-MD5 целевого BLOB-объекта или файла. (По умолчанию хэш НЕ создается.) Идентична параметру с таким же именем в команде копирования
--size-per-file (строка) Размер каждого автоматически созданного файла данных. Должен быть числом, за которым следует K, M или G. Например, 12k или 200G (по умолчанию 250M)
Параметры, наследуемые от родительских команд
--cap-mbps(плавающая точка) Ограничивает скорость передачи данных в Мбит/с. Наблюдаемая пропускная способность может слегка отличаться от предельной. Если установить для этого параметра значение 0 или вообще не указывать значение, пропускная способность не ограничивается.
--output-type (строка) Формат выходных данных команды. Возможные варианты: text, json. Значение по умолчанию — text.
--trusted-microsoft-suffixes (строка) Указывает дополнительные суффиксы домена, в которых могут отправляться маркеры входа Microsoft Entra. Значение по умолчанию: .core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net. Все перечисленные здесь домены добавлены по умолчанию. Для безопасности здесь следует указывать только домены Microsoft Azure. При указании нескольких значений введите их через точку с запятой.