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>"
Запустите тест отправки с указанным размером блока 2 МиБ и проверка длину файлов после передачи.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length
Запустите тест тестового теста, который отправляет 500 файлов. Каждый файл имеет размер 500 МиБ, а уровень журнала — только ошибки.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR
Запустите тест теста теста, который отправляет 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 вычисляет MD5 в команде azcopy copy. Цель --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 КиБ.
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 Мбит/с.
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-объектов. Идентична параметру с таким же именем в команде копирования (по умолчанию "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. При указании нескольких значений введите их через точку с запятой.