azcopy bench
Voert een prestatiebenchmark uit door testgegevens naar of van een opgegeven bestemming te uploaden of te downloaden. Voor uploads worden de testgegevens automatisch gegenereerd.
Met de benchmark-opdracht wordt hetzelfde proces uitgevoerd als 'kopiëren', met uitzondering van:
In plaats van zowel bron- als doelparameters te vereisen, gebruikt benchmark er slechts één. Dit is de blobcontainer, Azure Files Share of het Azure Data Lake Storage Gen2-bestandssysteem waaruit u wilt uploaden of downloaden.
Met de parameter Modus wordt beschreven of AzCopy uploads naar of downloads van het opgegeven doel moet testen. Geldige waarden ar'e 'Uploaden' en 'Downloaden'. De standaardwaarde is 'Uploaden'.
Voor uploadbenchmarks wordt de nettolading beschreven door opdrachtregelparameters, waarmee wordt bepaald hoeveel bestanden automatisch worden gegenereerd en hoe groot ze zijn. Het generatieproces vindt volledig plaats in het geheugen. Schijf wordt niet gebruikt.
Voor downloads bestaat de nettolading uit de bestanden die al bestaan in de bron. (Zie het onderstaande voorbeeld over het genereren van testbestanden indien nodig).
Slechts een paar van de optionele parameters die beschikbaar zijn voor de kopieeropdracht, worden ondersteund.
Aanvullende diagnostische gegevens worden gemeten en gerapporteerd.
Voor uploads is het standaardgedrag het verwijderen van de overgedragen gegevens aan het einde van de testuitvoering. Voor downloads worden de gegevens nooit lokaal opgeslagen.
De benchmarkmodus wordt automatisch afgestemd op het aantal parallelle TCP-verbindingen dat de maximale doorvoer geeft. Dit nummer wordt aan het einde weergegeven. Als u automatisch afstemmen wilt voorkomen, stelt u de omgevingsvariabele COPY_CONCURRENCY_VALUE in op een specifiek aantal verbindingen.
Alle gebruikelijke verificatietypen worden ondersteund. De handigste methode voor het benchmarken van uploaden is meestal het maken van een lege container met een SAS-token en het gebruik van SAS-verificatie. (Voor de downloadmodus moet een set testgegevens aanwezig zijn in de doelcontainer.)
azcopy bench [destination] [flags]
Voorbeelden
Voer een uploadbenchmark uit met standaardparameters (geschikt voor benchmarkingnetwerken tot 1 Gbps).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Voer een uploadbenchmark uit met een opgegeven blokgrootte van 2 MiB en controleer de lengte van bestanden na de overdracht.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length
Voer een benchmarktest uit waarmee 500 bestanden worden geüpload. Elk bestand is 500 MiB groot en het logboekniveau is zo ingesteld dat alleen fouten worden weergegeven.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR
Voer een benchmarktest uit waarmee 100 bestanden worden geüpload. Elk bestand heeft een grootte van 2 GiB. Dit is geschikt voor benchmarking op een snel netwerk (bijvoorbeeld: 10 Gbps).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Het volgende voorbeeld is hetzelfde als hierboven, maar met 50.000 bestanden. Elk bestand 8 MiB groot. In dit voorbeeld worden ook de MD5-hashes van elk bestand berekend zoals de vlag --put-md5 de MD5 berekent in de opdracht azcopy copy. Het doel van --put-md5 bij benchmarking is om te testen of MD5-berekening van invloed is op de doorvoer voor het geselecteerde aantal bestanden en de geselecteerde grootte.
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Voer een benchmarktest uit waarmee 1000 bestanden worden geüpload en mappen worden gemaakt om de gegevens te verdelen. Elk bestand heeft een grootte van 100 KiB.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 1000 --size-per-file 100K --number-of-folders 5
Voer een benchmarktest uit waarmee bestaande bestanden van een doel worden gedownload.
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Voer een downloadbenchmark uit met de standaardparameters en begrens de overdrachtssnelheid met 500 Mbps.
azcopy bench --mode=Download "https://[account].blob.core.windows.net/[container]?<SAS>" --cap-mbps 500
Voer een upload uit waarmee de overgedragen bestanden niet worden verwijderd. Deze bestanden kunnen vervolgens fungeren als de nettolading voor een downloadtest.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Opties
--blob-type string definieert het type blob op de bestemming. Wordt gebruikt om benchmarking van verschillende blobtypen toe te staan. Identiek aan de parameter met dezelfde naam in de kopieeropdracht (standaard 'Detecteren')
--block-size-mb float Gebruik deze blokgrootte (opgegeven in MiB). De standaardwaarde wordt automatisch berekend op basis van de bestandsgrootte. Decimale breuken zijn toegestaan, bijvoorbeeld 0,25. Identiek aan de parameter met dezelfde naam in de kopieeropdracht
--check-length Controleer de lengte van een bestand op de bestemming na de overdracht. Als er sprake is van een niet-overeenkomende bron en bestemming, wordt de overdracht gemarkeerd als mislukt. (standaard true)
--delete-test-data Indien waar, worden de benchmarkgegevens aan het einde van de benchmarkuitvoering verwijderd. Stel deze in op onwaar als u de gegevens op de bestemming wilt bewaren, bijvoorbeeld om deze te gebruiken voor handmatige tests buiten de benchmarkmodus (standaard waar)
--file-count (uint) aantal automatisch gegenereerde gegevensbestanden dat moet worden gebruikt (standaard 100)
-h, --help help voor bank
--log-level (tekenreeks) definieert de uitgebreidheid van het logboekbestand, beschikbare niveaus: INFO(alle aanvragen/antwoorden), WAARSCHUWING(trage antwoorden), ERROR(alleen mislukte aanvragen) en NONE (geen uitvoerlogboeken). (standaard "INFO")
--mode (tekenreeks) Hiermee wordt gedefinieerd of Azcopy uploads of downloads van dit doel moet testen. Geldige waarden zijn 'uploaden' en 'downloaden'. De standaardoptie is 'uploaden'. (standaard 'uploaden')
--number-of-folders (uint) Als deze groter is dan 0, maakt u mappen om de gegevens op te delen.
--put-blob-size-mb Gebruik deze grootte (opgegeven in MiB) als drempelwaarde om te bepalen of een blob moet worden geüpload als één PUT-aanvraag bij het uploaden naar Azure Storage. De standaardwaarde wordt automatisch berekend op basis van de bestandsgrootte. Decimale breuken zijn toegestaan (bijvoorbeeld: 0,25).
--put-md5 Maak een MD5-hash van elk bestand en sla de hash op als de eigenschap Content-MD5 van de doel-blob/bestand. (Standaard wordt de hash NIET gemaakt.) Identiek aan de parameter met dezelfde naam in de kopieeropdracht
--size-per-file (tekenreeks) Grootte van elk automatisch gegenereerd gegevensbestand. Moet een getal onmiddellijk gevolgd worden door K, M of G. Bijvoorbeeld 12k of 200G (standaard "250M")
Opties overgenomen van bovenliggende opdrachten
--cap-mbps (float) Caps the transfer rate, in megabits per seconde. De doorvoer per moment kan enigszins afwijken van de limiet. Als deze optie is ingesteld op nul of wordt weggelaten, wordt de doorvoer niet beperkt.
--output-type (tekenreeks) Indeling van de uitvoer van de opdracht. De opties zijn onder andere: tekst, json. De standaardwaarde is 'tekst'. (standaardtekst)
--trusted-microsoft-suffixes (tekenreeks) Hiermee geeft u extra domeinachtervoegsels op waarbij Microsoft Entra-aanmeldingstokens kunnen worden verzonden. De standaardwaarde is .core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Alle hier vermelde vermeldingen worden toegevoegd aan de standaardwaarde. Voor beveiliging moet u alleen Microsoft Azure-domeinen hier plaatsen. Scheid meerdere vermeldingen met puntkomma's.