azcopy bench
Kör ett prestandamått genom att ladda upp eller ladda ned testdata till eller från ett angivet mål. För uppladdningar genereras testdata automatiskt.
Benchmark-kommandot kör samma process som "copy", förutom att:
I stället för att kräva både käll- och målparametrar tar benchmark bara en. Det här är blobcontainern, Azure Files Share eller Azure Data Lake Storage-filsystemet som du vill ladda upp till eller ladda ned från.
Parametern "läge" beskriver om AzCopy ska testa uppladdningar till eller nedladdningar från det angivna målet. Giltiga värden ar'e 'Upload' och 'Download'. Standardvärdet är "Upload".
För prestandamått för uppladdning beskrivs nyttolasten av kommandoradsparametrar, som styr hur många filer som genereras automatiskt och hur stora de är. Genereringsprocessen sker helt i minnet. Disken används inte.
För nedladdningar består nyttolasten av de filer som redan finns vid källan. (Se exemplet nedan om hur du genererar testfiler om det behövs).
Endast några av de valfria parametrar som är tillgängliga för kopieringskommandot stöds.
Ytterligare diagnostik mäts och rapporteras.
För uppladdningar är standardbeteendet att ta bort överförda data i slutet av testkörningen. För nedladdningar sparas data aldrig lokalt.
Benchmark-läget justerar sig automatiskt efter antalet parallella TCP-anslutningar som ger maximalt dataflöde. Talet visas i slutet. Om du vill förhindra automatisk justering anger du miljövariabeln COPY_CONCURRENCY_VALUE till ett visst antal anslutningar.
Alla vanliga autentiseringstyper stöds. Den mest praktiska metoden för benchmarking-uppladdning är dock vanligtvis att skapa en tom container med en SAS-token och använda SAS-autentisering. (Nedladdningsläget kräver att en uppsättning testdata finns i målcontainern.)
azcopy bench [destination] [flags]
Exempel
Kör ett prestandamått för uppladdning med standardparametrar (lämpar sig för benchmarking av nätverk upp till 1 Gbit/s).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Kör ett referensvärde för uppladdning med en angiven blockstorlek på 2 MiB och kontrollera längden på filerna efter överföringen.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length
Kör ett benchmark-test som laddar upp 500 filer. Varje fil är 500 MiB i storlek och loggnivån är inställd på att endast visa fel.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR
Kör ett benchmark-test som laddar upp 100 filer. Varje fil är 2 GiB i storlek. Detta är lämpligt för benchmarking i ett snabbt nätverk (till exempel: 10 Gbit/s).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Nästa exempel är detsamma som ovan, men med 50 000 filer. Varje fil 8 MiB i storlek. Det här exemplet beräknar också MD5-hashvärden för varje fil på samma sätt som flaggan --put-md5 beräknar MD5 i kommandot azcopy copy. Syftet med --put-md5 vid benchmarking är att testa om MD5-beräkningen påverkar dataflödet för det valda filantalet och storleken.
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Kör ett benchmark-test som laddar upp 1 000 filer och skapar mappar för att dela upp data. Varje fil är 100 KiB i storlek.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 1000 --size-per-file 100K --number-of-folders 5
Kör ett benchmark-test som laddar ned befintliga filer från ett mål.
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Kör ett prestandamått för nedladdning med standardparametrarna och begränsa överföringshastigheten till 500 Mbit/s.
azcopy bench --mode=Download "https://[account].blob.core.windows.net/[container]?<SAS>" --cap-mbps 500
Kör en uppladdning som inte tar bort de överförda filerna. Dessa filer kan sedan fungera som nyttolast för ett nedladdningstest.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Alternativ
--blob-type string definierar typen av blob på målet. Används för att tillåta benchmarking av olika blobtyper. Identisk med samma namngivna parameter i kopieringskommandot (standard "Detect")
--block-size-mb float Använd den här blockstorleken (anges i MiB). Standardvärdet beräknas automatiskt baserat på filstorleken. Decimaltal tillåts – till exempel 0,25. Identisk med samma namngivna parameter i kopieringskommandot
--check-length Kontrollera längden på en fil på målet efter överföringen. Om det finns ett matchningsfel mellan källa och mål markeras överföringen som misslyckad. (standard sant)
--delete-test-data Om det är sant tas referensdata bort i slutet av benchmark-körningen. Ställ in den på false om du vill behålla data på målet , till exempel för att använda dem för manuella tester utanför benchmark-läge (standard sant)
--file-count (uint) antal automatiskt genererade datafiler som ska användas (standard 100)
-h, --help hjälp för bänk
--log-level (sträng) definierar loggverositeten för loggfilen, tillgängliga nivåer: INFO(alla begäranden/svar), WARNING(långsamma svar), ERROR(endast misslyckade begäranden) och NONE(inga utdataloggar). (standard "INFO")
--mode (sträng) Definierar om Azcopy ska testa uppladdningar eller nedladdningar från det här målet. Giltiga värden är "upload" och "download". Standardalternativet är "upload". (standard "upload")
--number-of-folders (uint) Om du är större än 0 skapar du mappar för att dela upp data.
--put-blob-size-mb Använd den här storleken (anges i MiB) som ett tröskelvärde för att avgöra om en blob ska laddas upp som en enda PUT-begäran vid uppladdning till Azure Storage. Standardvärdet beräknas automatiskt baserat på filstorleken. Decimaltal tillåts (till exempel 0,25).
--put-md5 Skapa en MD5-hash för varje fil och spara hashen som egenskapen Content-MD5 för målbloben/-filen. (Som standard skapas inte hash-filen.) Identisk med samma namngivna parameter i kopieringskommandot
--size-per-file (sträng) Storleken på varje automatiskt genererad datafil. Måste vara ett tal omedelbart följt av K, M eller G. T.ex. 12k eller 200G (standard "250M")
Alternativ som ärvs från överordnade kommandon
--cap-mbps (flyttal) Begränsar överföringshastigheten, i megabitar per sekund. Dataflödet ögonblick för ögonblick kan variera något från taket. Om det här alternativet är inställt på noll, eller om det utelämnas, begränsas inte dataflödet.
--output-type (sträng) Format för kommandots utdata. Alternativen är: text, json. Standardvärdet är "text". (standardtext)
--trusted-microsoft-suffixes (sträng) Anger ytterligare domänsuffix där Microsoft Entra-inloggningstoken kan skickas. Standardvärdet är '.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Alla som anges här läggs till i standardinställningen. För säkerhet bör du bara placera Microsoft Azure-domäner här. Avgränsa flera poster med semikolon.