azcopy bench
Exécute un test d’évaluation des performances en chargeant ou téléchargeant les données de test vers ou depuis une destination spécifiée. Pour les chargements, les données de test sont générées automatiquement.
La commande benchmark exécute le même processus que « copy », à ceci près que :
Au lieu de demander des paramètres source et de destination, benchmark n’en prend qu’un. Il s’agit du conteneur d’objets blob, du partage Azure Files ou du système de fichiers Azure Data Lake Storage Gen2 à partir duquel vous souhaitez charger ou télécharger.
Le paramètre « mode » indique si AzCopy doit tester les chargements vers ou téléchargements à partir de la cible donnée. Les valeurs valides sont « Upload » et « Download ». La valeur par défaut est « Upload ».
Pour les tests d’évaluation de chargement, la charge utile est décrite par les paramètres de ligne de commande, qui contrôlent le nombre de fichiers générés automatiquement et leur taille. Le processus de génération s’effectue entièrement en mémoire. Le disque n’est pas utilisé.
Pour les téléchargements, la charge utile est constituée par des fichiers qui existent déjà à la source. (Voir l’exemple ci-dessous illustrant la façon de générer des fichiers de test, si nécessaire).
Seuls quelques-uns des paramètres facultatifs qui sont disponibles pour la commande copy sont pris en charge.
Des diagnostics supplémentaires sont mesurés et signalés.
Pour les chargements, le comportement par défaut consiste à supprimer les données transférées à la fin de la série de tests. Pour les téléchargements, les données ne sont jamais réellement enregistrées localement.
Le mode « test d’évaluation » se règle automatiquement en fonction du nombre de connexions TCP parallèles qui fournit le débit maximal. Il affiche ce nombre à la fin. Pour empêcher le réglage automatique, affectez un nombre spécifique de connexions à la variable d’environnement COPY_CONCURRENCY_VALUE.
Tous les types d’authentification habituels sont pris en charge. Toutefois, l’approche la plus pratique pour le test d’évaluation de chargement vise généralement à créer un conteneur vide avec un jeton SAS, et à utiliser l’authentification SAS. (Le mode de téléchargement demande la présence d’un ensemble de données de test dans le conteneur cible.)
azcopy bench [destination] [flags]
Exemples
Exécuter un test d’évaluation de chargement avec les paramètres par défaut (adapté pour tester les réseaux jusqu’à 1 Gbit/s) :
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Exécuter un test d’évaluation qui charge 100 fichiers, chacun d’une taille de 2 Gio : (adapté à l’évaluation sur un réseau rapide, par exemple 10 Gbits/s) :’
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Comme ci-dessus, mais utiliser 50 000 fichiers, chacun d’une taille de 8 MiB, et calculer leurs hachages MD5 (de la même façon qu’effectué par l’indicateur --put-md5 dans la commande copy). L’objectif de --put-md5 lors des tests d’évaluation est de tester si le calcul MD5 affecte le débit pour le nombre de fichiers et la taille sélectionnés :
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Exécuter un test d’évaluation qui télécharge des fichiers existants à partir d’une cible
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Exécuter un chargement qui ne supprime pas les fichiers transférés. (Ces fichiers peuvent ensuite servir de charge utile pour un test de téléchargement)
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Options
--blob-type string définit le type d’objet blob au niveau de la destination. Permet d’effectuer un test d’évaluation de différents types d’objets blob. Identique au paramètre du même nom dans la commande copy (par défaut : « Detect »)
--block-size-mb float Utiliser cette taille de bloc (spécifiée en Mio). La valeur par défaut est calculée automatiquement en fonction de la taille du fichier. Les fractions décimales sont autorisées, par exemple 0,25. Identique au paramètre du même nom dans la commande copy
--check-length Vérifier la longueur d’un fichier sur la destination après le transfert. En cas d’incompatibilité entre la source et la destination, le transfert est marqué comme ayant échoué. (par défaut : true)
--delete-test-data Si la valeur est true, les données du test d’évaluation sont supprimées à la fin de l’exécution du test. Affectez-lui la valeur false si vous souhaitez conserver les données dans la destination, par exemple afin de les utiliser pour des tests manuels en dehors du mode « test d’évaluation » (valeur par défaut : true)
--file-count (uint) Nombre de fichiers de données générés automatiquement (valeur par défaut : 100)
-h, --help Aide pour la commande bench
--log-level (string) Définir le niveau de détail pour le fichier journal. Niveaux disponibles : INFO (toutes les requêtes/réponses), WARNING (réponses lentes), ERROR (uniquement les requêtes ayant échoué) et NONE (aucun journal de sortie). (par défaut : « INFO »)
--mode (string) Détermine si Azcopy doit tester les chargements ou les téléchargements à partir de cette cible. Les valeurs valides sont « upload » et « download ». L’option par défaut est « upload ». (par défaut : « upload »)
--number-of-folders (uint) Si la valeur est supérieure à 0, créer des dossiers pour répartir les données.
--put-blob-size-mbUtilisez cette taille (spécifiée en MiB) comme seuil pour déterminer s’il faut charger un objet blob en tant que requête PUT unique lors du chargement sur Stockage Azure. La valeur par défaut est calculée automatiquement en fonction de la taille du fichier. Les fractions décimales sont autorisées (par exemple : 0,25).
--put-md5 Créer un hachage MD5 de chaque fichier, puis enregistrer le hachage en tant que propriété Content-MD5 de l’objet blob/du fichier de destination. (Par défaut, le hachage n’est PAS créé.) Identique au paramètre du même nom dans la commande copy
--size-per-file (string) Taille de chaque fichier de données généré automatiquement. Doit être un nombre immédiatement suivi de K, de M ou de G (par exemple, 12k ou 200G) (par défaut : « 250M »)
Options héritées des commandes parentes
--cap-mbps (flottant) Limite la vitesse de transfert, en mégabits par seconde. Par moment, le débit peut dépasser légèrement cette limite. Si cette option est définie sur zéro ou si elle est omise, le débit n’est pas limité.
--output-type (string) Met en forme la sortie de la commande. Les formats possibles sont « text » et « JSON ». La valeur par défaut est « text ». (par défaut : « text »).
--trusted-microsoft-suffixes (chaîne) Spécifie des suffixes de domaine supplémentaires où les jetons de connexion Microsoft Entra peuvent être envoyés. La valeur par défaut est « .core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net ». Tous les éléments répertoriés ici sont ajoutés à la valeur par défaut. Pour la sécurité, vous devez placer uniquement des domaines Microsoft Azure ici. Séparez plusieurs entrées par des points-virgules.