azcopy bench
Führt einen Leistungsvergleichstest aus, indem Testdaten zu oder von einem bestimmten Ziel hoch- oder heruntergeladen werden. Für Uploads werden die Testdaten automatisch generiert.
Mit dem Befehl „bench“ wird derselbe Vorgang wie mit „copy“ ausgeführt. Allerdings bestehen folgende Unterschiede:
Anstatt sowohl Quell- als auch Zielparameter zu erfordern, benötigt der Vergleichstest nur einen Parameter. Dies ist der Blobcontainer, die Azure Files-Freigabe oder das Azure Data Lake Storage Gen2-Dateisystem, in das Sie hoch- oder herunterladen möchten.
Der Parameter „mode“ beschreibt, ob AzCopy Uploads oder Downloads für ein bestimmtes Ziel testen soll. Gültige Werte sind „Upload“ und „Download“. Standardwert ist „Upload“.
Für Upload-Benchmarks wird die Nutzlast durch Befehlszeilenparameter definiert, die steuern, wie viele Dateien automatisch und in welcher Größe generiert werden. Die Dateien werden vollständig im Arbeitsspeicher generiert. Datenträger wird nicht verwendet.
Bei Downloads besteht die Nutzlast aus den Dateien, die bereits an der Quelle vorhanden sind. (Informationen zum Generieren von Testdateien finden Sie bei Bedarf im nachfolgenden Beispiel).
Es werden nur einige der optionalen Parameter unterstützt, die für den Befehl „copy“ verfügbar sind.
Es werden zusätzliche Diagnosen ausgeführt und ausgegeben.
Für Uploads ist das Standardverhalten, die übertragenen Daten am Ende der Testausführung zu löschen. Für Downloads werden die Daten nie tatsächlich lokal gespeichert.
Der Vergleichstestmodus wird automatisch auf die Anzahl der parallelen TCP-Verbindungen abgestimmt, die maximalen Durchsatz gewährleisten. Die Anzahl wird am Ende angezeigt. Um die automatische Abstimmung zu verhindern, legen Sie die Umgebungsvariable COPY_CONCURRENCY_VALUE auf eine bestimmte Anzahl von Verbindungen fest.
Alle üblichen Authentifizierungstypen werden unterstützt. Der einfachste Ansatz für den Vergleichstest von Uploads besteht normalerweise jedoch darin, einen leeren Container mit einem SAS-Token zu erstellen und die SAS-Authentifizierung zu verwenden. (Der Modus „Download“ erfordert, dass ein Satz von Testdaten im Zielcontainer vorhanden ist.)
azcopy bench [destination] [flags]
Beispiele
Ausführen eines Upload-Benchmarks mit Standardparametern (geeignet für das Testen von Netzwerken mit bis zu 1 GBit/s):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Ausführen eines Vergleichstests, bei dem 100 Dateien von jeweils 2 GiB hochgeladen werden (geeignet für das Testen von schnellen Netzwerken, z. B. mit 10 GBit/s):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Wie oben, allerdings werden 50.000 Dateien von jeweils 8 MiB verwendet und deren MD5-Hashes berechnet. (Funktioniert auf dieselbe Weise wie mit dem „--put-md5“-Flag im Befehl „copy“.) Mit „--put-md5“ soll bei Vergleichstests ermittelt werden, ob die MD5-Berechnung den Durchsatz der ausgewählten Dateianzahl und -größe beeinflusst:
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Ausführen eines Vergleichstests, der vorhandene Dateien von einem Ziel herunterlädt
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Ausführen eines Uploads, der die übertragenen Dateien nicht löscht (Diese Dateien können dann als Nutzlast für einen Downloadtest dienen.)
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Tastatur
--blob-type string definiert den Typ des Blobs auf dem Ziel. Wird verwendet, um Vergleichstests für unterschiedliche Blobtypen zu ermöglichen. Identisch mit dem gleichnamigen Parameter im Befehl „copy“ (Standardwert: „Detect“).
--block-size-mb float legt die Blockgröße (in MiB) fest. Der Standardwert wird anhand der Dateigröße automatisch berechnet. Dezimalzahlen sind zulässig – Beispiel: 0,25 Identisch mit dem gleichnamigen Parameter im Befehl „copy“
--check-length überprüft nach der Übertragung die Länge einer Datei am Ziel. Wenn die Quelle und das Ziel nicht übereinstimmen, wird die Übertragung als fehlerhaft gekennzeichnet. (Standardwert: „true“)
--delete-test-data: wenn TRUE, werden die Vergleichsdaten am Ende des Vergleichstests gelöscht. Legen Sie den Wert auf „false“ fest, wenn die Daten am Ziel erhalten bleiben sollen, beispielsweise für manuelle Tests außerhalb des Vergleichstestmodus (Standardwert: „true“)
--file-count (uint) Anzahl der zu verwendenden automatisch generierten Datendateien (standardmäßig 100)
-h, --help Hilfe zu Bench
--log-level (Zeichenfolge) definiert, wie ausführlich die Protokolldatei sein soll. Verfügbare Stufen: INFO (alle Anforderungen/Antworten), WARNING (langsame Antworten), ERROR (nur fehlgeschlagene Anforderungen) und NONE (keine Ausgabeprotokolle). (Standardwert: „Info“)
--mode (Zeichenfolge): definiert, ob AzCopy Uploads oder Downloads von diesem Ziel testen soll. Gültige Werte sind „Upload“ und „Download“. Die Standardoption ist „Upload“. (Standard „Upload“)
--number-of-folders (uint): falls größer als 0, wird ein Ordner erstellt, um die Daten aufzuteilen.
--put-blob-size-mb Verwenden Sie diese Größe (in MiB angegeben) als Schwellenwert, um zu bestimmen, ob ein BLOB beim Hochladen in Azure Storage als einzelne PUT-Anforderung hochgeladen werden soll. Der Standardwert wird anhand der Dateigröße automatisch berechnet. Dezimalzahlen sind zulässig (Beispiel: 0,25).
--put-md5 Dient zum Erstellen eines MD5-Hashs jeder Datei und zum Speichern des Hashs als „Content-MD5“-Eigenschaft des Zielblobs bzw. der Zieldatei. (Standardmäßig wird der Hash NICHT erstellt.) Identisch mit dem gleichnamigen Parameter im Befehl „copy“
--size-per-file (Zeichenfolge) Die Größe jeder automatisch generierten Datendatei. Muss eine Zahl unmittelbar gefolgt von K, M oder G sein, z. B. 12k oder 200G (Standard „250M“)
Von übergeordneten Befehlen geerbte Optionen
--cap-mbps (Gleitkomma) Begrenzt die Übertragungsrate (in Megabit pro Sekunde). Der Schritt-für-Schritt-Durchsatz kann von der Obergrenze geringfügig abweichen. Wenn diese Option auf „Null“ festgelegt oder weggelassen wird, ist der Durchsatz nicht begrenzt.
--output-type (Zeichenfolge) – Format der Befehlsausgabe. Folgende Optionen sind verfügbar: „text“ und „json“. Der Standardwert lautet „text“. (Standardwert: „text“)
--trusted-microsoft-suffixes (Zeichenfolge) Gibt zusätzliche Domänensuffixe an, bei denen möglicherweise Microsoft Entra-Anmeldetoken gesendet werden. Der Standardwert ist '.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net'. Alle hier aufgelisteten Werte werden zum Standardwert hinzugefügt. Aus Sicherheitsgründen sollten Sie hier nur Microsoft Azure-Domänen platzieren. Trennen Sie mehrere E-Mail-Adressen durch Semikolons voneinander.