Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
AzCopy est un utilitaire de ligne de commande que vous pouvez utiliser pour copier des blobs ou des fichiers vers ou depuis un compte de stockage. Cet article vous aide à utiliser les journaux pour diagnostiquer les erreurs, puis à utiliser des fichiers de plan pour reprendre des travaux. Cet article montre également comment configurer les fichiers journaux et plans en modifiant leur niveau de détail et l’emplacement par défaut où ils sont stockés.
Remarque
Pour obtenir du contenu pour vous aider à bien démarrer avec AzCopy, consultez Prise en main d’AzCopy. Cet article s’applique à AzCopy V10, qui est la version actuellement prise en charge d’AzCopy. Si vous avez besoin d’utiliser une version antérieure d’AzCopy, consultez la section Utiliser la version précédente d’AzCopy.
Fichiers journaux et de plan
AzCopy crée des fichiers journaux et de plan pour chaque travail. Vous pouvez utiliser ces journaux pour investiguer et résoudre les problèmes potentiels.
Les journaux d’activité contiennent l’état de la défaillance (UPLOADFAILED, COPYFAILED et DOWNLOADFAILED), le chemin d’accès complet et la raison de la défaillance.
Par défaut, les fichiers journaux et de plan se trouvent dans le répertoire %USERPROFILE%\.azcopy sur Windows ou dans le répertoire $HOME$\.azcopy sur Mac et Linux, mais vous pouvez changer cet emplacement.
L’erreur correspondante n’est pas nécessairement la première erreur qui apparaît dans le fichier. Pour les erreurs telles que les erreurs réseau, les délais d’attente et les erreurs de disponibilité du serveur, AzCopy retente jusqu’à 20 fois et le processus de nouvelle tentative réussit généralement. La première erreur que vous voyez peut être un problème anodin qui a fait l’objet d’une nouvelle tentative réussie. Ainsi, au lieu de vous concentrer sur la première erreur du fichier, recherchez les erreurs à proximité de UPLOADFAILED, COPYFAILED ou DOWNLOADFAILED.
Important
Lorsque vous soumettez requête au support Microsoft (ou que vous résolvez le problème impliquant un tiers), partagez la version rédigée de la commande que vous souhaitez exécuter. Cette version veille à ce que la SAP ne soit pas accidentellement partagée avec tout le monde. Vous trouverez la version expurgée au début du fichier journal.
Passer en revue les journaux d’activité pour détecter la présence d’erreurs
La commande suivante obtient toutes les erreurs avec l’état UPLOADFAILED à partir du journal 04dc9ca9-158f-7945-5933-564021086c79 :
Afficher et reprendre des travaux
Chaque opération de transfert crée un travail AzCopy. Utilisez la commande suivante pour afficher l’historique des travaux :
azcopy jobs list
Pour afficher les statistiques du travail, utilisez la commande suivante :
azcopy jobs show <job-id>
Pour filtrer les transferts par état, utilisez la commande suivante :
azcopy jobs show <job-id> --with-status=Failed
Conseil / Astuce
La valeur de l’indicateur --with-status est sensible à la casse.
Utilisez la commande suivante pour reprendre un travail ayant échoué ou annulé. Cette commande utilise l’identificateur de travail avec le jeton SAP, car elle n’est pas persistante pour des raisons de sécurité :
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Conseil / Astuce
Placez les arguments de chemin d’accès tels que le jeton SAS avec des guillemets simples (' '). Utilisez des guillemets simples dans tous les interpréteurs de commandes, à l’exception de l’interface de commande Windows (cmd. exe). Si vous utilisez une interface de commande Windows (cmd. exe), placez les arguments de chemin d’accès entre guillemets doubles (" ") au lieu de guillemets simples (' ').
Lorsque vous reprenez un travail, AzCopy examine le fichier de plan de travail. Le fichier de plan répertorie tous les fichiers identifiés pour le traitement lors de la création du travail. Lorsque vous reprenez un travail, AzCopy tente de transférer tous les fichiers répertoriés dans le fichier de plan et n’ont pas déjà été transférés.
Changer l’emplacement des fichiers de plan
Utilisez la commande suivante :
Changer l’emplacement des fichiers journaux
Utilisez la commande suivante :
Modifier le niveau de consignation par défaut
Par défaut, AzCopy définit le niveau de log sur INFO. Pour réduire la verbosité du journal et économiser l’espace disque, utilisez l’option --log-level pour remplacer ce paramètre.
Les niveaux de journalisation disponibles sont : DEBUG, INFO, WARNING, ERROR et NONE.
Supprimer les fichiers de plan et les fichiers journaux
Pour supprimer tous les fichiers de plan et de journal de votre ordinateur local et économiser de l’espace disque, utilisez la azcopy jobs clean commande.
Pour supprimer le plan et les fichiers journaux pour un seul travail, utilisez azcopy jobs rm <job-id>. Remplacez l’espace réservé <job-id> dans cet exemple par l’ID du travail.