azcopy bench
Spustí srovnávací test výkonu tak, že nahraje nebo stáhne testovací data do zadaného cíle nebo z daného cíle. Pro nahrání se testovací data automaticky vygenerují.
Příkaz srovnávacího testu spustí stejný proces jako copy, s tím rozdílem, že:
Místo vyžadování zdrojových i cílových parametrů používá srovnávací test jenom jeden. Toto je kontejner objektů blob, sdílená složka Azure nebo systém souborů Azure Data Lake Storage Gen2, ze kterého chcete nahrát nebo stáhnout.
Parametr mode popisuje, jestli by nástroj AzCopy měl testovat nahrávání do daného cíle nebo stahování z daného cíle. Platné hodnoty ar'e 'Upload' and 'Download'. Výchozí hodnota je Upload.
U srovnávacích testů nahrávání je datová část popsaná parametry příkazového řádku, které řídí, kolik souborů se automaticky generuje a jak velké jsou. Proces generování probíhá zcela v paměti. Disk se nepoužívá.
U stahování se datová část skládá z toho, které soubory již existují ve zdroji. (V následujícím příkladu se dozvíte, jak v případě potřeby vygenerovat testovací soubory).
Podporuje se jenom několik volitelných parametrů, které jsou k dispozici pro příkaz kopírování.
Další diagnostika se měří a hlásí.
U nahrávání je výchozím chováním odstranit přenášená data na konci testovacího spuštění. U stahování se data nikdy neukládají místně.
Režim srovnávacího testu se automaticky vyladí na počet paralelních připojení TCP, která poskytují maximální propustnost. Zobrazí se toto číslo na konci. Pokud chcete zabránit automatickému ladění, nastavte proměnnou prostředí COPY_CONCURRENCY_VALUE na určitý počet připojení.
Podporují se všechny obvyklé typy ověřování. Nejvhodnějším přístupem pro nahrání srovnávacích testů je ale obvykle vytvoření prázdného kontejneru s tokenem SAS a použitím ověřování SAS. (Režim stahování vyžaduje, aby v cílovém kontejneru byla přítomna sada testovacích dat.)
azcopy bench [destination] [flags]
Příklady
Spusťte srovnávací test nahrávání s výchozími parametry (vhodné pro srovnávací testy sítí až do 1 Gb/s):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Spusťte srovnávací test, který nahraje 100 souborů, velikost každého 2 GiB: (vhodné pro srovnávací testy v rychlé síti, např. 10 Gb/s):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Stejné jako výše, ale použijte 50 000 souborů, každý 8 MiB ve velikosti a vypočítá jejich hodnoty hash MD5 (stejným způsobem jako příznak --put-md5 to dělá v příkazu kopírování). Účelem parametru --put-md5 při srovnávacím testu je otestovat, jestli výpočet MD5 ovlivňuje propustnost pro počet a velikost vybraného souboru:
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Spuštění srovnávacího testu, který stáhne existující soubory z cíle
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Spusťte nahrávání, které neodstraní přenášené soubory. (Tyto soubory pak můžou sloužit jako datová část pro test stahování)
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Možnosti
--blob-type string definuje typ objektu blob v cíli. Používá se k testování různých typů objektů blob. Identický s parametrem se stejným názvem v příkazu copy (výchozí "Detect")
--block-size-mb float Použijte tuto velikost bloku (zadanou v MiB). Výchozí hodnota se automaticky vypočítá na základě velikosti souboru. Desetinné zlomky jsou povolené – například 0,25. Identický s parametrem se stejným názvem v příkazu copy
--check-length Zkontrolujte délku souboru v cíli po přenosu. Pokud došlo k neshodě mezi zdrojem a cílem, přenos se označí jako neúspěšný. (výchozí true)
--delete-test-data Pokud je pravda, data srovnávacího testu budou na konci spuštění srovnávacího testu odstraněna. Pokud chcete zachovat data v cíli, nastavte ho na false – například je použít pro ruční testy mimo režim srovnávacího testu (výchozí hodnota true).
--file-count (uint) počet automaticky generovaných datových souborů, které se mají použít (výchozí 100)
-h, --help nápověda k lavičce
--log-level (řetězec) definujte úroveň podrobností protokolu pro soubor protokolu, dostupné úrovně: INFO(všechny požadavky/odpovědi), WARNING(pomalé odpovědi), ERROR(pouze neúspěšné požadavky) a NONE (žádné výstupní protokoly). (výchozí "INFORMACE")
--mode (řetězec) Definuje, jestli by nástroj Azcopy měl testovat nahrávání nebo stahování z tohoto cíle. Platné hodnoty jsou "upload" a "download". Výchozí možností je nahrát. (výchozí "upload")
--number-of-folders (uint) Pokud je větší než 0, vytvořte složky, které rozdělí data.
--put-blob-size-mb Tuto velikost (zadanou v MiB) použijte jako prahovou hodnotu, abyste zjistili, jestli se má při nahrávání do Azure Storage nahrát objekt blob jako jeden požadavek PUT. Výchozí hodnota se automaticky vypočítá na základě velikosti souboru. Desetinné zlomky jsou povolené (například: 0,25).
--put-md5 Vytvořte hodnotu hash MD5 každého souboru a uložte hodnotu hash jako vlastnost Content-MD5 cílového objektu blob nebo souboru. (Ve výchozím nastavení se hodnota hash nevytvořila.) Identický s parametrem se stejným názvem v příkazu copy
--size-per-file (řetězec) Velikost každého automaticky generovaného datového souboru Musí být číslo bezprostředně následované K, M nebo G. např. 12k nebo 200G (výchozí hodnota 250 M).
Možnosti zděděné z nadřazených příkazů
--cap-mbps (float) Limituje přenosovou rychlost v megabitech za sekundu. Propustnost za okamžik se může mírně lišit od limitu. Pokud je tato možnost nastavená na nulu nebo je vynechána, propustnost není omezena.
--output-type (řetězec) Formát výstupu příkazu Mezi tyto volby patří: text, json. Výchozí hodnota je text. (výchozí text)
--trusted-microsoft-suffixes (řetězec) Určuje další přípony domény, ve kterých se můžou odesílat přihlašovací tokeny Microsoft Entra. Výchozí hodnota je .core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Všechny zde uvedené jsou přidány do výchozího nastavení. Kvůli zabezpečení byste sem měli umístit jenom domény Microsoft Azure. Oddělte více položek středníky.