azcopy bench
Esegue un benchmark delle prestazioni caricando o scaricando i dati di test da o verso una destinazione specificata. Per i caricamenti, i dati di test vengono generati automaticamente.
Il comando benchmark esegue lo stesso processo di "copia", ad eccezione del fatto che:
Anziché richiedere parametri di origine e di destinazione, il benchmark accetta solo uno. Si tratta del contenitore BLOB, della condivisione File di Azure o del file system di Azure Data Lake Archiviazione Gen2 da cui si vuole eseguire il caricamento o il download.
Il parametro 'mode' descrive se AzCopy deve testare i caricamenti o i download da una destinazione specificata. Valori validi ar'e 'Upload' e 'Download'. Il valore predefinito è 'Upload'.
Per i benchmark di caricamento, il payload viene descritto dai parametri della riga di comando, che controllano il numero di file generati automaticamente e la loro grandezza. Il processo di generazione avviene interamente in memoria. Il disco non viene usato.
Per i download, il payload è costituito da qualsiasi file già esistente nell'origine. Vedere l'esempio seguente su come generare file di test, se necessario.
Sono supportati solo alcuni dei parametri facoltativi disponibili per il comando di copia.
La diagnostica aggiuntiva viene misurata e segnalata.
Per i caricamenti, il comportamento predefinito consiste nell'eliminare i dati trasferiti alla fine dell'esecuzione del test. Per i download, i dati non vengono mai salvati in locale.
La modalità benchmark si ottimizza automaticamente al numero di connessioni TCP parallele che offrono la velocità effettiva massima. Verrà visualizzato tale numero alla fine. Per impedire l'ottimizzazione automatica, impostare la variabile di ambiente COPY_CONCURRENCY_VALUE su un numero specifico di connessioni.
Sono supportati tutti i tipi di autenticazione consueti. Tuttavia, l'approccio più pratico per il caricamento del benchmarking consiste in genere nel creare un contenitore vuoto con un token di firma di accesso condiviso e usare l'autenticazione sas. Per la modalità di download è necessario che un set di dati di test sia presente nel contenitore di destinazione.
azcopy bench [destination] [flags]
Esempi
Eseguire un benchmark di caricamento con parametri predefiniti (adatti per il benchmarking di reti fino a 1 Gbps).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Eseguire un benchmark di caricamento con una dimensione di blocco specificata di 2 MiB e controllare la lunghezza dei file dopo il trasferimento.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length
Eseguire un test di benchmark che carica 500 file. Ogni file ha dimensioni pari a 500 MiB e il livello di log è impostato per visualizzare solo gli errori.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR
Eseguire un test di benchmark che carica 100 file. Ogni file ha dimensioni pari a 2 GiB. Questo è adatto per il benchmarking in una rete veloce (ad esempio: 10 Gbps).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
L'esempio seguente è uguale a quello precedente, ma con 50.000 file. Ogni file di dimensioni pari a 8 MiB. Questo esempio calcola anche gli hash MD5 di ogni file in modo simile al modo in cui il flag --put-md5 calcola MD5 nel comando azcopy copy. Lo scopo di --put-md5 quando si esegue il benchmarking consiste nel verificare se il calcolo MD5 influisce sulla velocità effettiva per il numero e le dimensioni dei file selezionati.
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Eseguire un test di benchmark che carica 1000 file e crea cartelle per suddividere i dati. Ogni file ha dimensioni pari a 100 KiB.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 1000 --size-per-file 100K --number-of-folders 5
Eseguire un test di benchmark che scarica i file esistenti da una destinazione.
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Eseguire un benchmark di download con i parametri predefiniti e limitare la velocità di trasferimento a 500 Mbps.
azcopy bench --mode=Download "https://[account].blob.core.windows.net/[container]?<SAS>" --cap-mbps 500
Eseguire un caricamento che non elimina i file trasferiti. Questi file possono quindi fungere da payload per un test di download.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Opzioni
--blob-type string definisce il tipo di BLOB nella destinazione. Usato per consentire il benchmarking di diversi tipi di BLOB. Identico al parametro con lo stesso nome nel comando copy (impostazione predefinita "Detect")
--block-size-mb float Usare questa dimensione del blocco (specificata in MiB). Il valore predefinito viene calcolato automaticamente in base alle dimensioni del file. Le frazioni decimali sono consentite, ad esempio 0,25. Identico al parametro con lo stesso nome nel comando copy
--check-length Controllare la lunghezza di un file nella destinazione dopo il trasferimento. Se si verifica una mancata corrispondenza tra l'origine e la destinazione, il trasferimento viene contrassegnato come non riuscito. (valore predefinito true)
--delete-test-data Se true, i dati del benchmark verranno eliminati alla fine dell'esecuzione del benchmark. Impostarlo su false se si desidera mantenere i dati nella destinazione, ad esempio per usarli per i test manuali all'esterno della modalità benchmark (valore predefinito true)
--file-count (uint) numero di file di dati generati automaticamente da usare (impostazione predefinita 100)
-h, --help aiuto per panca
--log-level (stringa) definire il livello di dettaglio del log per il file di log, i livelli disponibili: INFO(tutte le richieste/risposte), WARNING(risposte lente), ERROR(solo richieste non riuscite) e NONE(nessun log di output). (impostazione predefinita "INFO")
--mode (string) Definisce se Azcopy deve testare i caricamenti o i download da questa destinazione. I valori validi sono 'upload' e 'download'. L'opzione predefinita è 'upload'. (impostazione predefinita "upload")
--number-of-folders (uint) Se è maggiore di 0, creare cartelle per suddividere i dati.
--put-blob-size-mbUsare questa dimensione (specificata in MiB) come soglia per determinare se caricare un BLOB come singola richiesta PUT durante il caricamento in Archiviazione di Azure. Il valore predefinito viene calcolato automaticamente in base alle dimensioni del file. Le frazioni decimali sono consentite (ad esempio: 0,25).
--put-md5 Creare un hash MD5 di ogni file e salvare l'hash come proprietà Content-MD5 del BLOB/file di destinazione. Per impostazione predefinita, l'hash NON viene creato. Identico al parametro con lo stesso nome nel comando copy
--size-per-file (string) Dimensioni di ogni file di dati generato automaticamente. Deve essere un numero immediatamente seguito da K, M o G, ad esempio 12k o 200G (valore predefinito "250M")
Opzioni ereditate dai comandi padre
--cap-mbps (float) Riduce la velocità di trasferimento, in megabit al secondo. La velocità effettiva momentanea può variare leggermente rispetto al limite. Se questa opzione è impostata su zero o viene omessa, la velocità effettiva non viene limitata.
--output-type (string) Formato dell'output del comando. Le scelte includono: testo, json. Il valore predefinito è 'text'. (valore predefinito "text")
--trusted-microsoft-suffixes (string) Specifica suffissi di dominio aggiuntivi in cui possono essere inviati i token di accesso di Microsoft Entra. Il valore predefinito è '.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Tutti gli elementi elencati di seguito vengono aggiunti all'impostazione predefinita. Per motivi di sicurezza, è consigliabile inserire qui solo i domini di Microsoft Azure. Separare più voci con punti e virgola.